Через СБП по номеру телефона
Вы можете отправить выплату на счет физического лица по номеру телефона через Систему быстрых платежей (СБП).
Чтобы производить выплаты через СБП, необходимо открыть расчетный счет в Банке 131, после чего Банк зарегистрирует вас в Системе быстрых платежей.
При необходимости проверить регистрацию получателя в СБП до проведения выплаты, используйте метод
fps/customer_verification
. Этот метод не требуется вызывать перед каждой выплатой, достаточно использовать его при первом использовании реквизитов.
Актуальный список банков-участников СБП можно посмотреть на официальном сайте СБП.
Обязательные параметры для выплаты
Название | Тип | Описание |
---|---|---|
payment_method | PaymentMethod | Платежные данные |
type | string | значение: bank_account |
bank_account | BankAccountPaymentMethod | Банковский счет |
system_type | string | Система банковских платежей. Всегда: faster_payment_system |
faster_payment_system | FasterPaymentSystem | Данные СБП |
phone | string | Телефон получателя |
bank_id | string | Идентификатор банка получателя в СБП |
description | string | Назначение выплаты. Как сформировать |
amount_details | AmountDetails | Сумма |
amount | int | Сумма в копейках. Значение должно быть больше нуля. Если отправляете 100 рублей, нужно передать 10000 |
currency | string | Код валюты согласно ISO 4217. Регистр не важен. Всегда: rub |
participant_details | ParticipantDetails | Информация об участниках выплаты |
recipient | Participant | Данные получателя |
first_name | string | Имя получателя |
last_name | string | Фамилия получателя |
middle_name | string | Отчество получателя |
Идентификатор банка получателя в СБП
Вы можете скачать файл с идентификаторами банков получателей в формате JSON здесь.
Как провести выплату
Выплата проходит по общему сценарию, все параметры передаются в открытом виде, виджет использовать не нужно.
Пример запроса для выплаты через СБП
curl --location --request POST 'https://demo.bank131.ru/api/v1/session/init/payout' \
--header 'Content-Type: application/json' \
--header 'X-PARTNER-SIGN: sign' \
--header 'X-PARTNER-PROJECT: test-partner' \
--data-raw '{
"session_id": "ps_2704",
"payment_method": {
"type": "bank_account",
"bank_account": {
"system_type": "faster_payment_system",
"faster_payment_system": {
"phone": "79680000000",
"bank_id": "100000000069",
"description": "Перевод средств по договору № 5015553111 Иванов Иван Иванович НДС не облагается"
}
}
},
"amount_details": {
"amount": 30000,
"currency": "rub"
},
"metadata": "good",
"participant_details": {
"recipient": {
"first_name": "Иван",
"last_name": "Иванов",
"middle_name": "Иванович"
}
}
}'