Перейти к содержимому

API

На странице

Отмена

Отменяйте ожидающий вывод до начала MPC-подписи, учитывайте допустимые состояния операции и обрабатывайте обновлённый ответ API.

POST/v1/withdrawals/:withdrawal_id/cancel

API-ключ: Payout

Отменить выплату можно, пока не началось её исполнение. Окно закрывается в тот момент, когда Paymos берёт выплату в работу, — а это происходит ещё в статусе created, до всякого подписания. Поэтому сам по себе статус created не гарантирует, что отмена пройдёт: если исполнение уже началось, вызов вернёт 409. Повторная отмена уже отменённой выплаты ничего не меняет: возвращается 200 с той же выплатой, а не ошибка.

Тело запроса

{
  "reason": "Customer requested cancellation"
}

Ответ (200 OK)

{
  "withdrawal_id": "wdr_2M8K6Q4P9X1Z7A3B",
  "external_order_id": "payout-001",
  "status": "cancelled",
  "is_final": true,
  "is_test": true,
  "amount": "100.00",
  "currency": "USDT",
  "network": "TRC20",
  "destination_address": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
  "created_at": 1739289600,
  "cancelled_at": 1739289660
}

Ошибки

См. Коды ошибок — полный каталог. URI в поле type каждой ошибки ведёт сразу на нужную строку.

Получение выплаты Симуляция завершения вывода