Создать крипто-инвойс

POST

/v1/crypto/invoices

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

Выдаёт адрес под один платёж. В ответе приходят amount_due, сумма, которую
должен перевести плательщик (сумма инвойса плюс комиссия сети), и
payment_url, наша платёжная страница, если вы не строите свою.

Инвойс живёт 60 минут (expires_at). Перевод после истечения не
зачисляется.

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

Минимальный запросВсе поля

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

Response Example

201 - Success Example

{
    "invoice_id": "inv_9RQ2K7M4TDXA",
    "order_id": "order_123",
    "status": "pending",
    "network": "TRC20",
    "asset": "USDT",
    "amount": "10.00",
    "network_fee": "3.00",
    "amount_due": "13.00",
    "amount_paid": "0.00",
    "address": "TQmQ7xF6yv3NqM2hVJ8cWzKdRp5tLbYs4A",
    "payment_url": "https://pay.banka.bot/c/9RQ2K7M4TDXA",
    "transfers": [],
    "created_at": "2026-08-18T12:00:00Z",
    "expires_at": "2026-08-18T13:00:00Z",
    "paid_at": null
}

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

Вебхук об изменении статуса платежа

Получить крипто-инвойс