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

POST

/v1/crypto/payout-batches

Адрес: POST https://api.banka.bot/v1/crypto/payout-batches.

До 1000 позиций в одном запросе. Каждая позиция это самостоятельная
выплата со своим резервом и своим статусом, частичный успех норма.

external_id обязателен и у батча, и у каждой позиции: по нему
позиция находится в отчёте и по нему же работает идемпотентность.
Повтор батча с тем же external_id вторых выплат не создаёт.

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

🟢202Accepted

application/json

Батч принят в работу

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠409

🟠429

🔴503Service Unavailable

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v1/crypto/payout-batches' \
--header 'Idempotency-Key: 4f1c9d2e-8a37-4b56-9f0e-1d2c3b4a5968' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "external_id": "batch_2026_0818_A",
    "network": "TRC20",
    "callback_url": "https://example.com/webhooks/banka-crypto",
    "items": [
        {
            "external_id": "payout_2026_0818_001",
            "amount": "500.00",
            "address": "TJ8pW3vY6dK1nR4sB9mA2cQx5LzH7GfEu0"
        },
        {
            "external_id": "payout_2026_0818_002",
            "amount": "120.50",
            "address": "TZr5nQ8kL2wVxB7yH4jM9cPd3sFa6TgUe1"
        }
    ]
}'

Response Example

202 - Success Example

{
    "batch_id": "pb_5TX8NM03",
    "external_id": "batch_2026_0818_A",
    "status": "accepted",
    "network": "TRC20",
    "asset": "USDT",
    "totals": {
        "total": 2,
        "pending": 2,
        "done": 0,
        "failed": 0
    },
    "created_at": "2026-08-18T16:00:00Z",
    "completed_at": null,
    "items": []
}

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

Получить выплату

Получить массовую выплату