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

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

Endpoint

POST /v1/payouts

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

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

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

curl -X POST https://api.settler.pw/api/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": "Иван Иванов"
  }'

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

curl -X POST https://api.settler.pw/api/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": "",
  "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	Код банка
status	string	Статус
provider_order_id	string	ID заказа у провайдера (после обработки)
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	Внутренняя ошибка