Онлайн-оплата заказ-нарядов

Клиент оплачивает заказ-наряд по ссылке со своего телефона: картой или через СБП, на странице банка. Деньги приходят на счёт вашего сервиса по вашему договору эквайринга — dxCAR их через себя не пропускает. Как только банк подтвердил оплату, в наряде появляется оплата «Онлайн-оплата», а клиенту уходит электронный чек из облачной кассы.

Онлайн-оплата входит в тарифы «Команда» и выше.

Что нужно до подключения

1. Облачная касса. Чек при оплате в интернете обязан уйти в момент оплаты, поэтому онлайн-оплата работает только с облачной кассой: «Настройки» → «ККТ» → «Облачная касса», затем «Проверить». Касса у стойки для онлайн-оплаты не подходит. Пока облачная касса не подключена, ссылки на оплату не выдаются, а экран называет причину.
2. Договор интернет-эквайринга с банком или платёжным сервисом. Его заключает сервис сам. Банк при подключении смотрит сайт: контакты, цены, правила оплаты и возврата, политику обработки данных.
3. В кабинете провайдера:
   • выключите собственные чеки провайдера, иначе клиент получит два чека на одну оплату;
   • выключите двухстадийную оплату (холдирование) и «Сплит при получении»: dxCAR работает только с одностадийной оплатой, когда деньги списываются сразу.

Подключение

Меню «Онлайн-оплаты» → блок «Подключение» (нужно право «Настройки»):

• Провайдер оплаты и его поля — логин, пароль или ключи из кабинета провайдера. Пароли и ключи после сохранения больше не показываются: поле пустое и подписано «задан». Пустое поле при сохранении ключ не меняет; необязательный ключ стирается флажком «очистить сохранённое значение».
• Тестовый контур — если провайдер его даёт. Оплата на тестовом контуре идёт тестовой картой, деньги не списываются.
• Адрес уведомлений. Экран показывает его под полями. Если провайдер просит вписать адрес в своём кабинете — впишите (или передайте банку). Без уведомлений оплата всё равно найдётся: dxCAR сам спрашивает банк о каждой ждущей оплате, только позже.
• Ссылка действует, часов — от 1 до 720, по умолчанию 72.
• Кнопка «Оплатить» на странице согласования и в кабинете клиента — включается отдельно.

«Проверить подключение» создаёт у провайдера пробный платёж на 1 ₽ сохранёнными ключами и ничего не оплачивает. Ответ «Подключение работает» значит, что ключи, магазин и контур верны. В кабинете провайдера останется неоплаченный пробный заказ — его можно не трогать.

Сменили ключи или магазин, а у прежнего подключения есть неоплаченные попытки — экран предупредит: их статус новыми ключами не узнать, оплату по ним проверьте в кабинете провайдера.

Тестовая оплата

На тестовом контуре проведите одну оплату тестовой картой провайдера. Она появится в «Онлайн-оплатах» с пометкой «тест». Тестовая оплата — не деньги: в наряд она не записывается, чек по ней не пробивается. После проверки выключите тестовый контур и впишите боевые ключи.

Провайдеры

Альфа-Банк. Поля: «Логин API» и «Пароль API» из кабинета интернет-эквайринга (логин обычно заканчивается на «-api»), «Ключ контрольной суммы уведомлений» — если банк включил уведомления с симметричной контрольной суммой (уведомления с подписью сертификатом dxCAR не проверяет — такие банку включать не нужно), «Тестовый контур банка». Адрес уведомлений сообщите банку или впишите в кабинете. «Проверить подключение» у Альфы проверяет ещё и то, что банк сообщает суммы возвратов в статусе оплаты: если нет, попросите банк включить для вашего логина API версию 03 метода статуса — без неё возврат после обрыва связи не сверить, и он уйдёт на ручную проверку.

ЮKassa. В кабинете ЮKassa откройте «Настройки → Магазин» и скопируйте идентификатор магазина (shopId), в разделе «Интеграция → Ключи API» выпустите секретный ключ (у тестового магазина он начинается с test_). Впишите оба значения в «Онлайн-оплаты» → «Подключение». В разделе ЮKassa «Интеграция → HTTP-уведомления» вставьте адрес уведомлений, который показывает экран подключения, и отметьте события payment.succeeded, payment.canceled и refund.succeeded. Чеки в ЮKassa выключите: чек по онлайн-оплате пробивает облачная касса, с включёнными чеками ЮKassa покупатель получил бы два чека, а ЮKassa не примет платёж без своего чека. Возврат возможен от 1 ₽.

Т-Касса. В личном кабинете Т-Бизнеса откройте «Интернет-эквайринг → Магазины → Терминалы» и скопируйте TerminalKey и пароль терминала в «Онлайн-оплаты» → «Подключение». Адрес для уведомлений вписывать не нужно — dxCAR передаёт его в каждом платеже. В настройках терминала выключите онлайн-кассу Т-Бизнеса: чек покупателю пробивает облачная касса dxCAR, иначе покупатель получит два чека, а банк не даст создать платёж. Для пробы используйте терминал с окончанием DEMO — деньги по нему не списываются.

Яндекс Пэй. В кабинете Яндекс Пэй (console.pay.yandex.ru → «Настройки») скопируйте Merchant ID и создайте API-ключ, затем впишите их в «Онлайн-оплаты» → «Подключение». В поле Callback URL кабинета Яндекс Пэй вставьте адрес уведомлений, который показывает экран dxCAR, без добавок в конце. У одного магазина Яндекс Пэй адрес уведомлений один: если магазин уже подключён к вашему сайту или другой системе, заведите для dxCAR отдельный магазин. Оплата должна быть одностадийной: холдирование (ручное подтверждение списания) и «Сплит при получении» выключите. «Сплит» (оплата частями) и СБП включаются в кабинете Яндекс Пэй: сервис получает всю сумму сразу. Для пробы включите «Песочницу» — в ней API-ключ совпадает с Merchant ID, деньги не списываются.

У всех провайдеров возвращайте деньги только кнопкой «Вернуть» в dxCAR: возврат из кабинета провайдера dxCAR не увидит, и чек возврата не будет пробит.

Как выставить ссылку на оплату

В заказ-наряде под оплатами — блок «Онлайн-оплата»:

1. Сумма. Пустое поле — весь остаток к оплате, меньше остатка — предоплата. Больше долга по наряду выставить нельзя.
2. «Отправить клиенту» — ссылка уйдёт обычным сообщением (мессенджер, СМС — как настроены сообщения клиентам) и попадёт в историю сообщений клиента с пометкой «ссылка на оплату». Галочка работает у сотрудника с правом «Отправлять сообщения клиентам»; без него ссылку выдают без отправки и передают клиенту сами.
3. «Ссылка на оплату». Ссылка показывается один раз, сразу после выдачи: скопируйте её, если передаёте сами. Позже её не показать — только выдать новую.

Ниже — выданные ссылки (действует, оплачена, истекла, отменена) и оплаты по ним. Ссылку можно «Отменить»: клиент больше не оплатит по ней. Оплату, которую клиент уже начал на странице банка, отмена не останавливает — если банк её проведёт, она будет зачислена.

Выдавать ссылки и отменять их может сотрудник с правом «Онлайн-оплата: выставлять и отменять ссылку на оплату».

Что видит клиент

Страница оплаты на адресе вашего сервиса: название сервиса, номер заказ-наряда, марка и модель машины, сумма к оплате. ФИО, телефон, госномер и состав работ на ней не показываются — ссылку пересылают.

• Если наряд уже частично оплачен у стойки, по ссылке берётся не больше остатка.
• Если в карточке клиента нет ни телефона, ни e-mail, страница спросит, куда прислать чек. До оплаты покупатель может исправить введённый контакт на той же странице, а сотрудник — кнопкой «Контакт для чека» у ссылки в наряде; когда оплата по ссылке начата, контакт уже не меняется.
• «Оплатить» ведёт на защищённую страницу банка: карта, СБП и другие способы, включённые в договоре. Данные карты сервис не видит.
• После оплаты банк возвращает клиента на страницу сервиса с результатом.

Если включено, кнопка «Оплатить онлайн» есть и на странице согласования, и в кабинете клиента у неоплаченного наряда. Она выдаёт новую ссылку на текущий остаток. На странице согласования кнопка появляется только после ответа клиента, и сумма к оплате не включает работы и материалы, от которых он отказался, если они ещё стоят в наряде.

После оплаты

• В наряде появляется оплата «Онлайн-оплата» на сумму, которую подтвердил банк, — с датой подтверждения. Удалить или изменить её в наряде нельзя, вид «Онлайн-оплата» вручную не выбрать: такую оплату ставит только банк.
• Клиенту уходит электронный чек облачной кассы: на открытый наряд — чек аванса, на закрытый — чек полного расчёта. При закрытии наряда чек расчёта зачитывает аванс сам, касса у стойки не нужна.
• Сотрудникам приходит уведомление «Оплачен онлайн заказ-наряд №…» — туда же, куда приходят другие уведомления сервиса.
• Банк подтверждает оплату и позже срока страницы оплаты — например, если клиент начал оплату до истечения срока. dxCAR спрашивает банк о такой оплате ещё 7 суток после срока и зачисляет её, когда банк подтвердит; сотрудники получают уведомление.
• Деньги банк перечисляет на счёт сервиса за вычетом комиссии. Такое зачисление в банковской выписке — не новая оплата: она уже записана в наряде. Выписка пропускает зачисления эквайринга сама; если она всё же предложит его как оплату по наряду, выберите «Пропустить».

Оплата «требует решения»

Бывает, что банк списал не ту сумму, что была выставлена, наряд удалён, банк ответил так, что решить автоматически нельзя, или неделю после срока страницы оплаты не отвечает вовсе. Тогда оплата не зачисляется сама, а получает статус «требует решения»: сотрудникам приходит уведомление, в «Онлайн-оплатах» и в наряде видна причина.

Тот же статус получает уже зачисленная оплата, если банк сообщает, что она отменена или что часть денег вернули мимо dxCAR (в кабинете банка): деньги у покупателя, а оплата и чек в наряде остались. Сверьте её с кабинетом банка и нажмите «Возврат в кабинете банка» с суммой, которую банк вернул: в наряде появится строка со знаком минус и чек возврата, запрос в банк не уходит. Провести можно не больше, чем банк вернул сверх уже проведённого в dxCAR, и не больше суммы, зачисленной в наряд; по отменённой банком оплате — до всей зачисленной суммы. Т-Касса о частичном возврате сообщает без суммы: такую оплату dxCAR показывает, только если через dxCAR по ней ещё ничего не возвращали, а сумму для «Возврат в кабинете банка» возьмите из кабинета Т-Бизнеса (граница — сумма, зачисленная в наряд). Пока сотрудник не провёл возврат, оплата остаётся «требует решения». Если банк снова подтвердит оплату целиком, статус вернётся к «оплачен» сам. Пока чек аванса по этой оплате не пробит облачной кассой, провести возврат нельзя — сначала дождитесь чека.

Если сменить облачную кассу в настройках, чеки, которые ещё не ушли в прежнюю кассу, остаются за ней. Когда доступ к прежней кассе удалён, такие чеки сами не уйдут: они видны в оповещении о чеках, которые ждут дольше суток. Снимите такой чек и пробейте заново — он уйдёт в новую кассу.

• «Зачислить» — записать в наряд сумму, которую банк фактически подтвердит, за вычетом того, что уже вернули покупателю. Если наряда больше нет или банк вернул всё, зачислять некуда. Пока по оплате идёт возврат, «Зачислить» ждёт его результата.
• «Вернуть» — вернуть деньги клиенту через банк.

dxCAR продолжает раз в сутки спрашивать банк о такой оплате: если ответ прояснится, она будет зачислена или закрыта сама.

Возвраты

Деньги по онлайн-оплате возвращаются только кнопкой «Вернуть» — в блоке наряда или в «Онлайн-оплатах». Можно вернуть всю сумму или часть. Возврат идёт через банк на карту или счёт, с которого клиент платил; в наряде появляется строка оплаты со знаком минус, и пробивается чек возврата. Возвращает сотрудник с правом «Онлайн-оплата: возвращать деньги через банк и решать спорные оплаты».

• Вернуть можно не больше оплаченного за вычетом уже возвращённого.
• По одной оплате идёт один возврат за раз: следующий можно оформить, когда банк ответит по предыдущему.
• Пока чек самой оплаты не пробит, возврат не принимается — сначала чек.
• Возврат «требует проверки», если банк ответил так, что понять, ушли ли деньги, нельзя. Такой возврат dxCAR повторно в банк не отправляет и чек возврата не пробивает: сверьте его в кабинете банка и нажмите «Возврат проведён» (строка со знаком минус и чек возврата) или «Не проведён». dxCAR и сам раз в сутки спрашивает банк снова, но проводит такой возврат сам, только когда банк подтвердит именно запрошенную сумму. Если банк вернул другую сумму или не называет её, решает сотрудник.
• Некоторые банки проводят возврат не сразу: статус «банк обрабатывает». Если банк отменит такой возврат, сотрудники увидят это в «Онлайн-оплатах», а чек возврата пробит не будет.
• Возврат, сделанный в кабинете банка, dxCAR сам не проведёт: оплата получит статус «требует решения», а строка возврата и чек появятся только после «Возврат в кабинете банка». Возвращайте только из dxCAR.
• При возврате запчастей по закрытому наряду вернуть деньги на карту через банк нельзя: выберите способ, которым отдаёте деньги (наличные, перевод), или «на баланс клиента».

Экран «Онлайн-оплаты»

Меню «Онлайн-оплаты» (право «Онлайн-оплаты: журнал оплат по ссылкам, подключение банка»): журнал оплат за период — по умолчанию оплаченные, ждущие и требующие решения, с фильтром по статусу. В строке — наряд, провайдер и номер платежа у провайдера, сумма и сколько списал банк, возвраты и кнопки «Вернуть» и «Зачислить». Пометка «тест» — оплата на тестовом контуре.

Если онлайн-оплата не входит в тариф, ссылки не выдаются и пункта меню нет. В нарядах с прежними онлайн-оплатами блок остаётся: вернуть деньги по ним можно.