Одностадийный и двухстадийный платеж

Яндекс Пэй поддерживает как одностадийные, так и двухстадийные платежи.

Одностадийный платеж

По умолчанию платеж через Яндекс Пэй считается успешным после того, как клиент завершил оплату заказа на форме (см. схему взаимодействия). Подтверждения списания средств со стороны продавца при этом не требуется. Такой платеж называется одностадийным. Он выполняется по следующему сценарию:

  1. Клиент оплачивает заказ через форму Яндекс Пэй.
  2. Деньги списываются со счета клиента.
  3. Платеж переходит в статус CAPTURED.
  4. Бэкенд продавца получает нотификацию о событии ORDER_STATUS_UPDATED.

Двухстадийный платеж

Двухстадийный платеж требует подтверждения списания средств со стороны продавца. Он состоит из двух стадий: первая — блокировка средств (пре-авторизация) и переход платежа в статус AUTHORIZED, вторая стадия — подтверждение списания продавцом и переход платежа в статус CAPTURED.

Включить двухстадийный платеж можно в настройках консоли Яндекс Пэй в разделе Заказы.

Важно

Чтобы не потерять деньги, продавец обязан подтверждать двухстадийные платежи. Если не подтвердить платеж, после истечения времени блокировки средства вернутся клиенту.

Двухстадийный платеж выполняется по такому сценарию:

  1. Клиент оплачивает заказ через форму Яндекс Пэй.
  2. Средства блокируются на счете клиента.
  3. Платеж переходит в статус AUTHORIZED.
  4. Бэкенд продавца получает нотификацию о событии ORDER_STATUS_UPDATED.
  5. Продавец подтверждает списание средств за заказ.
  6. Средства списываются со счета клиента.
  7. Платеж переходит в статус CAPTURED.
  8. Бэкенд продавца получает нотификацию о событии ORDER_STATUS_UPDATED.

Подтверждение двухстадийного платежа

Подтвердить списание средств за заказ в сценарии двухстадийного платежа можно двумя способами:

  • через API с помощью вызова capture;
  • в консоли Яндекс Пэй выбрать неподтвержденный заказ со статусом В ожидании и нажать кнопку Подтвердить заказ.

Отмена блокировки средств

В сценарии двухстадийного платежа поддерживается операция отмены блокировки средств. Если средства заблокированы, но не списаны (платеж находится в статусе AUTHORIZED), вы можете разблокировать средства клиента через API, вызвав cancel, или в консоли Яндекс Пэй с помощью кнопки Отменить заказ.

Проверка статуса платежа

На любом этапе как одностадийного, так и двухстадийного платежа, вы можете проверить актуальный статус заказа и платежа через API (детали заказа) или в консоли Яндекс Пэй, выбрав интересующий вас заказ.