Документация/Другие операции/Выплаты
Выплаты
Выплата — исходящий перевод: платформа кредитует карту получателя со счёта, согласованного с провайдером. Перевод проходит в один шаг, поэтому здесь нет режима удержания и нечего сохранять о карте.
Запрос
Запрос
POST /api/v1/payouts
Idempotency-Key: payout-20260817-004
{
"order_id": "payout-20260817-004",
"amount_minor": 50000,
"currency": "EUR",
"account": "<счёт списания, согласованный с провайдером>",
"payout_method": {
"type": "card",
"card": {
"number": "<PAN получателя>",
"expire_month": 12,
"expire_year": 2030
}
}
}account — это счёт списания, а не карта получателя
account обязателен и указывает, с какого счёта уходит перевод. Карта получателя передаётся в payout_method. Значение account безопасно показывать в кабинете, номер карты — нет.
Способ выплаты
В payout_method передаётся ровно один источник назначения, соответствующий полю type: карта, идентификатор сохранённой карты или кошелёк. Тип принимает значения card, apple_pay, google_pay, samsung_pay.
Одновременная передача карты и сохранённой карты — ошибка 400 card_and_saved_card_are_exclusive. CVV в выплате не требуется и не используется: код проверяет плательщика, а получателю платформа только зачисляет.
Схема кошельков согласуется отдельно
Payload и возможность кошельковых выплат не входят в базовый контракт и включаются по отдельному согласованию.
Подтверждение
Часть каналов требует второго шага. Если выплата остановилась в неоконченном состоянии, вызовите подтверждение с новым Idempotency-Key:
POST /api/v1/payouts/{payout_id}/confirmСтатусы
Модель состояний совпадает с платёжной: решение принимается по паре status + final. В интерфейсах выплаты помечаются исходящей стрелкой — система, которая рисует полученные и отправленные деньги одинаково, рано или поздно так же их и проведёт.
Текущее состояние читается запросом GET /payouts/{payout_id}.