Создание выплаты

Создание выплаты на карту или через СБП.

Endpoint

POST /v1/payouts

Подпись запроса

Запрос подписывается так же, как при приёме платежей: алгоритм HMAC-SHA1 от строки {METHOD}{URL}{BODY}, результат кодируется в Base64 и передаётся в заголовке X-Signature. Ключ подписи — Secret Key мерчанта (общий для всех терминалов).

{METHOD}{URL}{BODY}

• METHOD — HTTP метод (POST)
• URL — полный URL запроса (https://api.bopay.io/v1/payouts)
• BODY — тело запроса в формате JSON

Пример строки для подписи:

POSThttps://api.bopay.io/v1/payouts{"ext_id":"payout_001","amount":5000,"method":"card","requisites":"4276123456781234","holder_name":"Иван Иванов","bank":"sberbank"}

Примеры кода для расчёта подписи (JavaScript, Python, PHP) — на странице Авторизация.

Параметры запроса

Параметр	Тип	Обязательный	Описание
ext_id	string	Да	Уникальный ID выплаты в вашей системе
amount	number	Да	Сумма выплаты в RUB
method	string	Да	Метод: card или sbp
requisites	string	Да	Номер карты или телефона
holder_name	string	Да	ФИО получателя
bank	string	Да	Код банка получателя
notify_url	string	Нет	URL для webhook
client_id	string	Нет	ID клиента/плательщика в вашей системе

Пример выплаты на карту

curl -X POST https://api.bopay.io/v1/payouts \
  -H "Content-Type: application/json" \
  -H "X-Identity: your-api-key" \
  -H "X-Signature: your-signature" \
  -d '{
    "ext_id": "payout_001",
    "amount": 5000,
    "method": "card",
    "requisites": "4276123456781234",
    "holder_name": "Иван Иванов",
    "client_id": "client_123"
  }'

Пример выплаты через СБП

curl -X POST https://api.bopay.io/v1/payouts \
  -H "Content-Type: application/json" \
  -H "X-Identity: your-api-key" \
  -H "X-Signature: your-signature" \
  -d '{
    "ext_id": "payout_002",
    "amount": 3000,
    "method": "sbp",
    "requisites": "+79001234567",
    "holder_name": "Петр Петров",
    "bank": "tinkoff"
  }'

Ответ

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "ext_id": "payout_001",
  "amount": 5000,
  "currency": "RUB",
  "method": "card",
  "requisites": "4276123456781234",
  "holder_name": "Иван Иванов",
  "bank": "",
  "client_id": "client_123",
  "status": "pending",
  "created_at": "2026-01-30T12:45:00Z"
}

Поля ответа

Поле	Тип	Описание
id	string	ID выплаты (UUID)
ext_id	string	Ваш ID выплаты
amount	number	Сумма
currency	string	Валюта (RUB)
method	string	Метод: card или sbp
requisites	string	Реквизиты
holder_name	string	ФИО получателя
bank	string	Код банка
client_id	string	ID клиента/плательщика в вашей системе
status	string	Статус
created_at	string	Время создания (ISO 8601)
completed_at	string	Время завершения

Статусы выплат

Статус	Описание
pending	Ожидает обработки
processing	В обработке
completed	Успешно
failed	Ошибка
cancelled	Отменено

Ошибки

Код	HTTP	Описание
PAY_002	400	Неверные параметры
PAY_003	409	Выплата с таким ext_id уже существует
SYS_001	500	Внутренняя ошибка