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

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

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

к сведению

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

При полном соответствии стандарту PCI DSS выплаты можно проводить по номеру карты, токену или с виджетом, а платежи — напрямую с карты или виджета.

Вы сами решаете, получать ли вебхуки. Если они отключены, вам потребуется каждый раз отправлять запрос 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 означает, что платеж прошел успешно.