Россия (СБП)
Выплаты на номера телефонов через СБП в RUB
Перед тем как начать
Авторизация
Как подписывать запросы API-токеном.
Обзор выплат
Общий формат запроса, поля ответа и статусы.
Это направление выплат доступно не всем мерчантам. Уточните доступность у вашего менеджера и убедитесь, что на вашем балансе мерчанта достаточно средств, прежде чем создавать выплату.
Обзор
| Валюта | Направление | Тип платежа |
|---|---|---|
RUB | Номер телефона через СБП | SBP |
Выплата по СБП выполняется в два запроса: сначала вы получаете список банков, которые могут принять перевод на номер телефона, затем создаёте выплату с выбранным банком.
Формат номера телефона зависит от сервиса. Некоторые ожидают номер без префикса +7 или 7 (9117883630 вместо 79117883630). Уточните формат, который ожидает ваш сервис.
Порядок действий
Получите список банков
GET /v1/payouts/banks?account={phone}| Query-параметр | Тип | Обязательное | Описание |
|---|---|---|---|
account | string | ✅ Да | Номер телефона получателя |
curl -X GET "https://api.riopay.online/v1/payouts/banks?account=79117883630" \
-H "X-Api-Token: YOUR_API_TOKEN"[
{ "id": "100000000004", "name": "T-Bank - Т-Банк" },
{ "id": "100000000111", "name": "Sberbank - Сбербанк" }
]Дайте получателю выбрать банк и используйте его id в качестве account.bankName на следующем шаге.
Создайте выплату
POST /v1/payoutscurl -X POST "https://api.riopay.online/v1/payouts" \
-H "Content-Type: application/json" \
-H "X-Api-Token: YOUR_API_TOKEN" \
-d '{
"amount": 1000,
"currency": "RUB",
"paymentType": "SBP",
"externalId": "payout-123",
"account": {
"name": "John Doe",
"requisites": "79117883630",
"bankName": "100000000004",
"userId": "user_12345"
},
"note": "Выплата по заказу №1234"
}'Поля account
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
name | string | ✅ Да | Имя получателя |
requisites | string | ✅ Да | Реквизиты получателя: номер карты, номер телефона, PIX-ключ и т. д. в зависимости от paymentType |
userId | string | ✅ Да | ID пользователя в вашей системе |
| Поле | Тип | Обязательное | Описание |
|---|---|---|---|
bankName | string | ✅ Да | id банка из GET /v1/payouts/banks, например 100000000004 |
В requisites передаётся номер телефона получателя.
Ответ
В ответе возвращается стандартный объект выплаты со статусом CREATED. Сохраните id, чтобы отслеживать выплату.