Создать выплату

POST

/v1/crypto/payouts

Адрес: POST https://api.banka.bot/v1/crypto/payouts.

Отправка USDT на произвольный адрес. recipient_amount это сумма,
которую получит получатель; с вас списывается total_debit, он же
резервируется сразу при приёме заявки.

Идемпотентность по external_id: повтор с теми же параметрами
возвращает существующую выплату, с другими отвечает 409.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201Created

application/json

Выплата принята

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠409

🟠429

🔴503Service Unavailable

Request Example

Shell

JavaScript

Java

Swift

cURL

Выплата 500 USDT в TRC20Все поля

curl --location '/v1/crypto/payouts' \
--header 'Idempotency-Key: 4f1c9d2e-8a37-4b56-9f0e-1d2c3b4a5968' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "external_id": "payout_2026_0818_001",
    "network": "TRC20",
    "amount": "500.00",
    "address": "TJ8pW3vY6dK1nR4sB9mA2cQx5LzH7GfEu0"
}'

Response Example

201 - Success Example

{
    "payout_id": "po_7QW3ZK21",
    "external_id": "payout_2026_0818_001",
    "status": "pending",
    "network": "TRC20",
    "asset": "USDT",
    "recipient_address": "TJ8pW3vY6dK1nR4sB9mA2cQx5LzH7GfEu0",
    "recipient_amount": "500.00",
    "network_fee": "3.00",
    "service_fee": "0.00",
    "total_debit": "503.00",
    "tx_hash": null,
    "error": null,
    "created_at": "2026-08-18T15:00:00Z",
    "completed_at": null
}

Modified at 2026-09-07 18:26:34

Вебхук о завершении возврата

Список выплат