Создаёт вывод по СБП через Payout API

Описание

Подключение, секретный ключ, ограничение по IP и формирование подписи одинаковы для всех выводов и описаны на отдельной странице — Подпись запросов Payout API. Ниже — только то, что относится к выводам по СБП.

Получатель
Получателя можно передать одним из двух способов, но не обоими сразу:

sbpRecipientId — идентификатор ранее сохранённого и подтверждённого получателя. Список получателей и их идентификаторы возвращает GET /api/v1/sbp-recipients

phone и bankId — номер телефона получателя и банк, в который зачисляется перевод. Оба поля передаются вместе

Телефон принимается в свободном формате: допустимы +, пробелы, скобки и дефисы. После очистки от разделителей номер должен состоять из 11 цифр и начинаться с 7 или 8.

bankId — идентификатор банка из справочника участников СБП, который возвращает GET /api/v1/sbp-banks. Передавать произвольное значение нельзя: банк, которого нет в справочнике, отклоняется.

Сумма и комиссия
Допустимая сумма одного вывода: от 1000 до 100000 RUB включительно, не более двух знаков после запятой. Комиссия и курс берутся из ваших настроек выводов по СБП и могут отличаться от карточных. С баланса списывается сумма вывода вместе с комиссией, пересчитанная в USDT.

Идемпотентность
Для каждого нового вывода используйте новый Idempotency-Key. Повторный запрос с тем же ключом и тем же телом вернёт ранее созданный вывод, а не создаст второй. Повторный запрос с тем же ключом, но изменённым телом отклоняется. Если предыдущий запрос с этим ключом ещё обрабатывается, вернётся 409 — повторите запрос с тем же ключом.

Запрос

POST /api/v1/payouts/sbp-rub

Заголовки

Заголовок	Обязательный	Пример
`Authorization`	да	`PG-HMAC kid=29ef0000-..., ts=1719403200, sig=abc123==`
`Idempotency-Key`	да	`00000000-0000-0000-0000-446655440000`
`Content-Type`	да	`application/json`

Тело

Поле	Тип	Обязательное	Описание
`sbpRecipientId`	string	нет	ID сохранённого получателя (альтернатива паре `phone` и `bankId`)
`phone`	string	нет	Номер телефона получателя. Передаётся вместе с `bankId`
`bankId`	string	нет	Идентификатор банка из справочника участников СБП. Передаётся вместе с `phone`
`amountRub`	number	да	Сумма вывода в рублях
`payoutMethod`	string	да	Всегда `SBP`
`currencyRequested`	string	да	Всегда `RUB`

{
  "phone": "+7 900 000-00-00",
  "bankId": "100000000111",
  "amountRub": 1500,
  "payoutMethod": "SBP",
  "currencyRequested": "RUB"
}

Тот же вывод по сохранённому получателю — телефон и банк в этом случае не передаются:

{
  "sbpRecipientId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "amountRub": 1500,
  "payoutMethod": "SBP",
  "currencyRequested": "RUB"
}

Ответ

{
  "withdrawalRecordId": "3c0d321d-40c4-46e3-97f0-7a8f50ce03a6",
  "status": "CREATED",
  "phoneMasked": "+7 ••• ••• 00 00",
  "bankName": "Банк",
  "amountUsdtDebited": 13.270341
}

Поле	Тип	Описание
`withdrawalRecordId`	string	Идентификатор созданного вывода
`status`	string	Статус вывода. Сразу после создания — `CREATED`
`phoneMasked`	string	Маскированный номер телефона получателя
`bankName`	string	Название банка получателя
`amountUsdtDebited`	number	Сумма, списанная с USDT-баланса мерчанта: сумма вывода и комиссия, пересчитанные по курсу

Ошибки

400 — запрос не прошёл проверку. Частые причины: сумма вне допустимого диапазона или с лишними знаками после запятой; не передан ни sbpRecipientId, ни пара phone и bankId, либо переданы оба способа сразу; телефон или идентификатор банка не распознаны; получатель недоступен; ключ идемпотентности уже использован с другим телом запроса. Конкретная причина возвращается в теле ответа.

401 — ошибка авторизации. Возвращается, если подпись не сходится, истекло окно времени, запрос пришёл с адреса вне списка разрешённых либо выводы по СБП недоступны для вашего аккаунта.

409 — вывод с этим ключом идемпотентности ещё создаётся. Повторите запрос с тем же ключом.

Создаёт вывод по СБП через Payout API

Описание#

Запрос#

Заголовки#

Тело#