Перейти к содержанию

Обработка Callback

Настройка callback выполняется на стороне админов. Для подтверждения подлинности каждого запроса вы передаёте в заголовке статичный токен вида:

Text Only
1
Authorization: Bearer {static_token}

Тело запроса представляет собой JSON-объект с обязательными полями:

  • id — уникальный идентификатор выплаты в нашей системе
  • status — текущий статус выплаты
  • amount — сумма выплаты в копейках или центах (целое число)
  • outter_id — внешний идентификатор выплаты из вашей системы
  • receipt — URL чека
  • X-Request-Id — уникальный идентификатор нашего запроса

Поддерживаемые статусы

В классической версии (KB) поддерживаются только два статуса:

  • completed
  • canceled

Если же вы интегрируетесь по API v3, дополнительно к этим двум статусам приходят ещё два:

  • wait_confirm
  • failed_to_send_payout

Таким образом, для v3 возможны все четыре значения status: wait_confirm, failed_to_send_payout, completed, canceled.

Обработка статусов

  • status = wait_confirm — выплата только создана и ждёт вашего подтверждения.
  • status = failed_to_send_payout — устанавливается, если после создания и отправки в КБ для проверки наличия на вашей стороне мы получили ошибку (например, HTTP 4xx). В этом статусе выплата не будет автоматически браться трейдерами, даже если вы повторно отправите запрос на её выполнение.
  • status = completed — выплата успешно отправлена.
  • status = canceled — выплата отменена.

🧩 Example Request — успех

Bash
1
curl --location -g '{{url}}'

Example Response

JSON
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
{
  "id": 2673,
  "status": "completed",
  "amount": 1500,
  "outter_id": null,
  "receipts": [
    "https://rf-static.ams3.digitaloceanspaces.com/payout-dev/ams3/2025-05-06/payouts/receipts/3a614e72-8e5d-4f1d-bf7c-e920f45013cd.pdf"
  ],
  "X-Request-Id": "af469817-5792-4dd4-9b13-c9f0ee01a105"
}

⚙️ Дополнительные возможности при создании заявки

  • Задать сумму для оплаты, без указания банка или метода.
  • Подача апелляции при возникновении спорных ситуаций.
  • Автоматический редирект на указанный мерчантом URL после формирования заявки.
  • Автоматическая обработка платежа и уведомление мерчанта о статусе платежа через колбеки.

🔄 Получение статуса выплаты (Polling API)

Помимо callback-механизма, вы также можете получать статус выплаты через API-запрос (polling).

Это особенно полезно, если: - callback не был получен - требуется дополнительная проверка статуса - необходимо реализовать fallback-логику

📡 Endpoint

GET /api/v3/payouts/?outter_id=merchant_outter_id

🛠 Аутентификация

HTTP
1
Authorization: Token YOUR_PAYOUT_TOKEN