📤 Выплата
Создание PayOut
Создание новой заявки на выплату средств получателю.
POST/api/v1/pay-out
Параметры запроса
| Параметр | Тип | Обязательный | Описание | Пример |
|---|---|---|---|---|
| externalID | string | Да | Уникальный ID в вашей системе (1-64 символа, латиница, цифры, дефис, подчёркивание) | "test_payout_123" |
| bankId | number | Да | ID банка из /api/v1/banks | 1 |
| method | string | Да | Метод выплаты: CARD, SBP, ACCOUNT | "CARD" |
| currencyId | number | Да | ID валюты из /api/v1/currencies | 1 |
| callbackURL | string | Да | URL для получения webhook уведомлений | "https://example.com/callback" |
| amount | string | Да | Сумма выплаты (не более 2 знаков после запятой) | "5000" |
| receiver | string | Да | Реквизиты получателя (номер карты / телефон / счёт) | "4000000000000000" |
| holder | string | Да | Имя получателя (3-100 символов) | "Иванов Иван Иванович" |
Поддерживаемые методы:
CARD (банковские карты), SBP (Система Быстрых Платежей), ACCOUNT (банковский счёт).Пример запроса
json
{
"externalID": "test_payout_123",
"bankId": 1,
"method": "CARD",
"currencyId": 1,
"callbackURL": "https://example.com/callbacks/payout",
"amount": "5000",
"receiver": "4000000000000000",
"holder": "Иванов Иван Иванович"
}Пример ответа
json
{
"success": true,
"data": {
"id": "uuid-here",
"externalID": "test_payout_123",
"trackerID": "f5ef6b73-0952-4602-a306-82ef1f755f85",
"status": "PROCESSING",
"amount": "5000",
"commission": "355",
"currency": "RUB",
"bank": "OZON",
"method": "CARD",
"receiver": "4000000000000000",
"holder": "Иванов Иван Иванович",
"description": "Тестовая выплата",
"createdAt": "2025-01-01T12:00:00Z"
}
}