Documentation

Documentation

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

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

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

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

Работа с API

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

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

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

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

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

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

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

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

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

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

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

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

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

Виджеты

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

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

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

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

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

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

Справочник API

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

Выплата на российскую банковскую карту

Отправлять выплаты на карты российских банков можно двумя способами:

  • с помощью виджета, в который получатель вводит данные карты, тогда вы получаете токенизированные данные карты и отправляете их в запросе на выплату;
  • в открытом виде, это можно сделать, если у вас есть сертификат PCI DSS.

Обязательные параметры для выплаты

Для выплат на российские карты обязательно нужно указывать ФИО получателя — как в паспорте, не выдуманное и не случайный набор символов. Кириллицей или латиницей (это не важно). Имя, напечатанное на карте (Cardholder Name) не подойдет.

Российская карта с токенизированными данными

Обязательные параметры для отправки выплаты на карту российского банка с токенизированными данными, полученными из виджета. Подходит для тех, у кого нет сертификата PCI DSS.

НазваниеТипОписание
payment_methodPaymentMethodПлатежные данные
typestringзначение: card
cardCardPaymentMethodПлатежные данные банковской карты
typestringзначение: encrypted_card
encrypted_cardEncryptedCardКарта с шифрованными полями
number_hashstringХэш номера карты
amount_detailsAmountDetailsСумма
amountintСумма в копейках. Значение должно быть больше нуля. Если отправляете 100 рублей, нужно передать 10000
currencystringКод валюты согласно ISO 4217. Регистр не важен. Всегда: rub
participant_detailsParticipantDetailsИнформация об участниках выплаты
recipientParticipantДанные получателя
full_namestringИмя получателя (как в паспорте)
beneficiary_idstringИНН бенефициара или выгодоприобретателя. Необходимо указать только при выплатах с номинального счета.
payment_detailsPaymentDetailsИнформация об операции (тип, описание). Необходимо указать только при выплатах с номинального счета.
typestringЗначение: internal_transfer
internal_transferInternalTransferInfoИнформация о внутреннем переводе
typestringЗначение: transfer_from_nominal_account
transfer_from_nominal_accountTransferFromNominalAccountИнформация о переводе с номинального счета
descriptionstringОписание

Российская карта с открытыми данными

Обязательные параметры для отправки выплаты на карту российского банка с открытыми параметрами, полученными на вашей стороне. Можно использовать, если у вас есть сертификат PCI DSS.

НазваниеТипОписание
payment_methodPaymentMethodПлатежные данные (карта, лицевой счет и др.)
typestringзначение: card
cardCardPaymentMethodПлатежные данные банковской карты
typestringзначение: bank_card
bank_cardBankCardКарта в открытом виде
numberstringНомер карты
amount_detailsAmountDetailsСумма
amountintСумма в копейках. Значение должно быть больше нуля. Если отправляете 100 рублей, нужно передать 10000
currencystringКод валюты согласно ISO 4217. Регистр не важен. Всегда: rub
participant_detailsParticipantDetailsИнформация об участниках выплаты
recipientParticipantДанные получателя
full_namestringИмя получателя (как в паспорте)
beneficiary_idstringИНН бенефициара или выгодоприобретателя. Необходимо указать только при выплатах с номинального счета.
payment_detailsPaymentDetailsИнформация об операции (тип, описание). Необходимо указать только при выплатах с номинального счета.
typestringЗначение: internal_transfer
internal_transferInternalTransferInfoИнформация о внутреннем переводе
typestringЗначение: transfer_from_nominal_account
transfer_from_nominal_accountTransferFromNominalAccountИнформация о переводе с номинального счета
descriptionstringОписание

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

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

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