Общий сценарий выплат и платежей

Эта инструкция поможет вам понять, как проводить выплаты и платежи через API. Здесь описаны основные шаги, которые нужно выполнить. В зависимости от выбранного способа или условий проведения транзакции могут понадобиться дополнительные действия.

Подробные сценарии для каждого случая вы найдете в разделах Выплаты и Платежи.

к сведению

При работе с платежными картами обязательно нужно соблюдать стандарт PCI DSS, но объем требований зависит от способа выплат или платежей. Если использовать виджет Банка 131, требований будет меньше.

Вы сами решаете, получать ли вебхуки. Если они отключены, вам потребуется каждый раз отправлять запрос session/status, чтобы понять следующий шаг и результат операции.

Выплаты

Порядок действий зависит от способа выплаты: с виджетом или без него.

С виджетом

1. Отправьте запрос Банку 131 на создание публичного токена. Этот токен нужен, чтобы подключить виджет для безопасного ввода данных банковской карты.

2. Инициализируйте виджет с полученным токеном. После ввода данных виджет вернет вам хеш, который нужно использовать для выплат.

   Сохраните хеш для будущих выплат.

3. Отправьте выплату одним из способов:

   • создайте платежную сессию (session/create), а затем выплату с идентификатором этой сессии (session/start/payout) — рекомендуем как наиболее надежный способ;
   • создайте сессию и выплату одновременно (session/init/payout).

4. Дождитесь вебхука ready_to_confirm от Банка о готовности провести выплату и ожидании вашего подтверждения.

5. Подтвердите (session/confirm) или отмените (session/cancel) выплату.

   Чтобы настроить выплаты с автоматическим подтверждением, обратитесь к персональному менеджеру Банка 131.

6. Дождитесь вебхука payment_finished со статусом транзакции. Статус succeeded означает, что выплата прошла успешно.

Без виджета

1. Отправьте выплату одним из способов:

   • создайте платежную сессию (session/create), а затем выплату с идентификатором этой сессии (session/start/payout) — рекомендуем как наиболее надежный способ;
   • создайте сессию и выплату одновременно (session/init/payout).

2. Дождитесь вебхука ready_to_confirm от Банка о готовности провести выплату и ожидании вашего подтверждения.

3. Подтвердите (session/confirm) или отмените (session/cancel) выплату.

   Чтобы настроить выплаты с автоматическим подтверждением, обратитесь к персональному менеджеру Банка 131.

4. Дождитесь вебхука payment_finished со статусом транзакции. Статус succeeded означает, что выплата прошла успешно.

Платежи

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

С виджетом

1. Отправьте запрос на создание платежной сессии session/create. В ответе вы получите идентификатор этой сессии.

2. Отправьте запрос Банку 131 на создание публичного токена. Этот токен нужен, чтобы подключить виджет для безопасного ввода данных банковской карты.

3. Инициализируйте виджет с полученным токеном.

4. Дождитесь вебхука ready_to_confirm от Банка о готовности провести платеж и ожидании вашего подтверждения.

5. Подтвердите (session/confirm) или отмените (session/cancel) платеж.

   Чтобы настроить платежи с автоматическим подтверждением, обратитесь к персональному менеджеру Банка 131.

6. Дождитесь вебхука ready_to_capture. Это значит, что деньги для оплаты успешно заморожены на банковской карте плательщика. Спишите захолдированную сумму или ее часть (session/capture), либо отмените платеж (session/cancel).

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

7. Дождитесь вебхука payment_finished со статусом транзакции. Статус succeeded означает, что платеж прошел успешно.

Без виджета

1. Отправьте платеж одним из способов:

   • создайте платежную сессию (session/create), а затем платеж с идентификатором этой сессии (session/start/payment) — рекомендуем как наиболее надежный способ;
   • создайте сессию и платеж одновременно (session/init/payment).

2. Дождитесь вебхука ready_to_confirm от Банка о готовности провести платеж и ожидании вашего подтверждения.

3. Подтвердите (session/confirm) или отмените (session/cancel) платеж.

   Чтобы настроить платежи с автоматическим подтверждением, обратитесь к персональному менеджеру Банка 131.

4. Если вы получили вебхук action_required, значит, для проведения платежа нужны дополнительные действия. Например, плательщику нужно пройти 3D Secure. Отправьте в ответ код HTTP 200 OK и перенаправьте плательщика для прохождения 3D Secure.

5. Дождитесь вебхука ready_to_capture. Это значит, что деньги для оплаты успешно заморожены на банковской карте плательщика. Спишите захолдированную сумму или ее часть (session/capture), либо отмените платеж (session/cancel).

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

6. Дождитесь вебхука payment_finished со статусом транзакции. Статус succeeded означает, что платеж прошел успешно.