Documentation

Documentation

  • API Банка 131
  • Languages iconРусский
    • English

›Прием платежей

Документация

  • Возможности API
  • С чего начать

Работа с API

  • Формат работы
  • Библиотеки
  • Тестирование
  • История изменений

Массовые выплаты

  • Возможности
  • Как всё работает
  • Сценарии выплат
  • Возвраты выплат
  • Самозанятые

    • Выплаты самозанятым
    • Привязка самозанятого
    • Фискализация без выплаты

    Способы получения выплат

    • На российскую банковскую карту
    • На иностранную карту
    • На счет в российском банке
    • В кошелек QIWI
    • В кошелек ЮMoney (Яндекс.Деньги)
    • В налоговую
    • Через СБП по номеру телефона

    Выплаты по шагам

    • Выплата на карту с виджетом
    • Выплата одним запросом
    • Выплата на карту с PCI DSS
    • Выплата самозанятому с фискализацией

Прием платежей

  • Возможности
  • Процесс платежа
  • Платеж банковской картой
  • Платежи с холдированием
  • Возвраты
  • Рекуррентные платежи
  • Интеграция с Google Pay™
  • Сплит-платежи

    • Варианты и возможности
    • Сплит-платежи без доработок
    • Сплит-платежи по API

    Платежи по шагам

    • Оплата через платежную форму
    • Оплата с PCI DSS
    • Платеж одним запросом
    • Google Pay™

Виджеты

  • Виджет для токенизации карты
  • Виджет платежной формы
  • Виджет для привязки самозанятого

Проверка паспорта

  • Возможности
  • Взаимодействие
  • Методы

    • Проверка паспорта
    • Статус проверки
  • Ответы и ошибки

Акты и реестры

  • Реестр выплат
  • Реестр платежей
  • Акт

Справочник API

  • Объекты
  • Методы
  • Вебхуки
  • Коды ошибок

Платежи с холдированием

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

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

Как это работает

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

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

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

Как включить холдирование

Холдирование включается на стороне Банка 131. Все ваши платежи могут проходить или с холдированием, или без него (тогда сумма платежа будет списываться автоматически, сразу после авторизации).

Если хотите проводить платежи с холдированием, напишите вашему менеджеру в Банке 131.

Срок холдирования

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

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

Cценарий платежа c холдированием

  1. Вы создаете платежную сессию отдельно от платежа (session/create) или одновременно с ним (session/init/payment).

В этот момент можно подключить виджет платежной формы.

  1. Если не используете виджет и создавали сессию отдельно от старта платежа, отправляете запрос session/start/payment.
  2. Получаете от Банка 131 вебхук ready_to_confirm — это значит, что Банк готов провести платеж и ждет вашего подтверждения.
  3. Подтверждаете проведение платежа (confirm_request) или отменяете его (cancel_request).
  4. Если проводите оплату без платежной формы, получаете вебхук action_required от Банка 131. Это значит, что для проведения платежа нужны дополнительные действия. Например, пользователю нужно пройти 3-D Secure.
  5. Перенаправляете пользователя на адрес для 3-D Secure.
  6. Получаете вебхук ready_to_capture от Банка 131. Это значит, что деньги для оплаты успешно заморожены на банковской карте пользователя. Их можно списать — сразу или через некоторое время.
  7. Списываете захолдированную сумму (session/capture) или отменяете оплату (cancel_request).
  8. Получаете от Банка 131 вебхук payment_finished с результатом проведения платежа. Статус succeeded сообщает вам, что платеж успешно проведен.

Схема платежа с холдированием

На этой схеме показан платеж с холдированием, со стартом сессии отдельно от платежа, на сервисе с сертификатом PCI DSS (без виджетов).

Схема платежа с холдированием

← Платеж банковской картойВозвраты →
  • Как это работает
  • Как включить холдирование
  • Срок холдирования
  • Cценарий платежа c холдированием
  • Схема платежа с холдированием
Documentation
Документация
Массовые выплатыПрием платежейСправочник API
Сценарии по шагам
Выплата на карту с токеномВыплата на карту с PCI DSSВыплата самозанятомуОплата через платежную форму
Напишите нам
Предложения и идеи — partners@131.ruПресса — press@131.ru
© 2022 Банк 131