Documentation

Documentation

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

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

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

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

Работа с API

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

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

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

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

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

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

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

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

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

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

    • Как создать платежного бота
    • Как подключить платежного бота
    • Как настроить платежного бота

    Сплит-платежи

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

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

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

Виджеты

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

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

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

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

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

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

Справочник API

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

Платеж одним запросом

Вы можете отправить платеж одним запросом, без промежуточных шагов (если без них можно обойтись). Результат платежа сразу вернется вам в ответ.

Этот вариант подходит, если:

  • у вас есть сертификат PCI DSS;
  • вы не используете виджет платежной формы.

Здесь описан платеж без холдирования. Подробнее о платежах с холдированием

Как подключить

Для таких платежей есть специальный метод session/init/payment/sync. Сообщите менеджеру Банка 131, что хотите его использовать.

В этом случае вы не будете получать вебхуки от Банка 131. Узнавать о статусе операций можно будет с помощью запроса session/status.

Как провести платеж

Отправьте запрос session/init/payment/sync.

В поле payment_method.type передайте значение card. В объекте BankCard передайте данные банковской карты пользователя. В поле payment_options.return_url обязательно передайте адрес, на который нужно вернуть пользователя, когда платеж пройдет.

Результат платежа вернется в ответ на запрос в поле payment.status:

  • succeeded— оплата прошла успешно;
  • failed — оплата не прошла из-за ошибки;
  • pending — пользователю нужно пройти аутентификацию по 3-D Secure.

Подробнее о статусах платежа

Пример запроса на оплату

cURL
curl --location --request POST 'https://proxy.bank131.ru/api/v1/session/init/payment/sync' \
--header 'Content-Type: application/json' \
--header 'X-PARTNER-SIGN: sign' \
--header 'X-PARTNER-PROJECT: project' \
--data-raw '{
"payment_details": {
"type": "card",
"card": {
"type": "bank_card",
"bank_card": {
"number": "4242424242424242",
"expiration_month": "01",
"expiration_year": "22",
"security_code": "123"
}
}
},
"amount_details": {
"amount": 10000,
"currency": "rub"
},
"customer": {
"reference": "lucky"
},
"payment_options": {
"return_url": "https://131.ru"
}
}'

Когда не приходит результат

Иногда в ответ на запрос не приходит окончательный статус платежа. Например, если платеж проходит слишком долго или карта пользователя требует 3-D Secure.

Слишком долгий платеж

Если платеж проходит не сразу (дольше 40 секунд), в ответ вернется промежуточный статус платежа — in_progress.

Чтобы узнать окончательный статус платежа, отправьте запрос session/status.

Карта с 3-D Secure

Если карта пользователя требует 3-D Secure, в ответ на запрос придут данные для редиректа. Перенаправьте пользователя на адрес customer_interaction.redirect.url.

После этого отправьте запрос session/status, чтобы узнать окончательный статус платежа.

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