Возвраты

Раздел OpenAPI: Возвраты.

POST /api/v1/integration/refunds создаёт возврат по уже оплаченной транзакции.

Обязательный Idempotency-Key

В заголовке Idempotency-Key передайте уникальный ключ на одно бизнес-намерение, например:

refund:order-10482:1

Повтор с тем же ключом и тем же телом безопасен.
Тот же ключ с другим телом → конфликт.

Без Idempotency-Key запрос отклоняется.

Ответы

Код	Смысл
201	возврат создан уже в финальном состоянии
202	запрос создан, но ждёт approve или обработки

Статусы возврата

Статус	Смысл
`requested`	Возврат зарегистрирован и ожидает начала выполнения.
`pending_approval`	Нужна maker-checker проверка. `action_request_id` может присутствовать в ответе.
`processing`	Выполнение начато, но результат ещё не подтверждён.
`succeeded`	Возврат подтверждён. Только это значение означает успешное завершение.
`failed`	Возврат не выполнен.
`cancelled`	Запрос отменён без возврата денег.

Частичные возвраты зависят от метода и провайдера. Автоматическая отмена у провайдера выполняется только для первого возврата на полную исходную сумму. Частичный возврат остаётся в статусе обработки и требует ручного подтверждения/внешнего подтверждающего документа — система не имитирует успешный возврат у провайдера.

Integration API сейчас не предоставляет отдельный GET возврата. После 202 отслеживайте refund.status_updated; при пропуске события используйте журнал доставок или кабинет. Для полного возврата исходная транзакция станет refunded; частичный возврат сохраняет статус платежа paid.

Обязательный Idempotency-Key#

Ответы#

Статусы возврата#

Обязательный Idempotency-Key

Ответы

Статусы возврата