Протокол приема платежей для магазинов

Отложенная оплата

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

Ограничение. 

Отложенными могут быть только платежи с банковских карт (paymentType=AC).

Как подключить отложенные платежи

  1. Обратитесь к своему менеджеру в Кассе. Он расскажет о порядке действий и настроит ваш магазин.
  2. У вас появятся отдельные параметры shopId и scid специально для платежей с карт. Для всех остальных типов платежей shopId и scid будут другими.
  3. Реализуйте проведение оплаты в два этапа с помощью методов confirmPayment и cancelPayment.

Если вы включите отложенные платежи, то все платежи с карт будут проходить как отложенные, в два этапа.

Сценарий с точки зрения магазина

1. Оплата и блокировка

  1. Пользователь выбирает оплату с банковской карты (на сайте магазина или на стороне Кассы) и нажимает Оплатить.
  2. Данные, которые вводит пользователь в интерфейсе магазина, передаются в платежный сервис Кассы.
  3. Пользователь попадает на страницу подтверждения на сайте Кассы.
  4. Пользователь вводит реквизиты банковской карты и подтверждает платеж.
  5. Деньги на карте пользователя блокируются, он не может ими оперировать (если операция прошла успешно).
  6. Пользователь видит результат — страницу с сообщением об успешном платеже или страницу с ошибкой.
  7. На странице результата отображается ссылка Вернуться в магазин. По ней пользователь может перейти на страницу магазина, адрес которой вы указали в настройках или передали в платежной форме.

  8. В магазин приходит уведомление о блокировке (paymentAviso). У магазина есть 30 суток (этот период настраивается индивидуально), чтобы выполнить заказ и подтвердить оплату. Или аннулировать заказ и отменить оплату.

2. Списание или отмена

  • Магазин выполняет заказ полностью
    1. Магазин подтверждает списание с помощью метода confirmPayment.
    2. И получает ответ на запрос.
    3. Заблокированные деньги списываются как при обычной оплате с банковской карты пользователя. С магазина взимается комиссия.
  • Магазин не выполняет заказ
    1. Магазин отменяет заказ с помощью метода cancelPayment.
    2. Деньги на карте пользователя полностью разблокируются и становятся ему доступны. С магазина не взимается комиссия.
  • Магазин выполняет заказ частично (например, доставляет 3 из 4 товаров).
    1. Магазин подтверждает списание нужной суммы с помощью метода confirmPayment.
    2. Нужная сумма списывается с карты пользователя, остаток разблокируется и становится доступен. С магазина берется комиссия, только с суммы успешной оплаты.
    3. Магазин получает уведомление об успешном списании.
  • Истекает срок блокировки. Деньги разблокируются и либо становятся доступны пользователю, либо списываются целиком (это зависит от настроек магазина).
Ограничение. 

По умолчанию деньги при отложенном платеже блокируются на 7 суток (по стандарту платежных систем Visa и MasterCard). После этого банк-эмитент может разблокировать деньги в любой момент.

Срок блокировки на стороне Яндекс.Денег можно продлить до 30 дней — для всех отложенных платежей сразу. Но на действия банка-эмитента это не повлияет: через 7 дней он всё равно может деньги разблокировать. Если в момент подтверждения оплаты (confirmPayment) денег на карте не будет, провести платеж не получится.

Отправка данных для чека

Примечание. 

Это нужно только тем, кто настроил взаимодействие со своей онлайн-кассой через Яндекс.Кассу. См. Описание процесса оплаты с отправкой данных для чека

1. Оплата и блокировка

При проведении отложенных переводов данные для чека отправляются в онлайн-кассу на первом этапе: в случае успешной авторизации банковской карты.

2. Списание или отмена

На втором этапе могут быть варианты:

  • Сумма оплаты не меняется: магазин подтверждает списание с помощью метода confirmPayment, оплата проходит как обычно, данные для чека были отправлены на первом этапе.
  • Сумма оплаты меняется
    1. Магазин подтверждает списание с помощью метода confirmPayment, при этом в запросе передается параметр receipt с данными для нового чека.
    2. Яндекс.Касса отправляет вашей онлайн-кассе чек возврата (чтобы аннулировать чек, отправленный на первом этапе).
    3. И отправляет новый чек — с новой суммой.

Итого, по одной операции отправится три чека: чек исходной операции, чек отмены и чек с новой суммой.

  • Операция отменяется
    1. Магазин отменяет заказ с помощью метода cancelPayment.

Смотрите также

Метод confirmPayment

Метод cancelPayment

Финансовые операции