Вернуть полученный платёж

POST

/v1/crypto/refunds

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

Обратная выплата с вашего баланса на адрес отправителя исходного
платежа. Адрес получателя берётся из платежа: произвольный адрес эта
ручка не принимает (для этого есть выплаты).

Возврат частичный или полный, суммарно не больше полученного по
инвойсу. Срок 180 дней с момента оплаты. Комиссию сети платите вы,
суммы раскладываются тем же контрактом, что у выплаты.

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

🟠404Record Not Found

🟠409

🟠429

Request Example

Shell

JavaScript

Java

Swift

cURL

Полный возвратЧастичный возврат

curl --location '/v1/crypto/refunds' \
--header 'Idempotency-Key: 4f1c9d2e-8a37-4b56-9f0e-1d2c3b4a5968' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "invoice_id": "inv_9RQ2K7M4TDXA",
    "external_id": "refund_order_123"
}'

Response Example

201 - Success Example

{
    "refund_id": "rf_2MC7XQ90",
    "external_id": "refund_order_123",
    "invoice_id": "inv_9RQ2K7M4TDXA",
    "status": "pending",
    "network": "TRC20",
    "asset": "USDT",
    "recipient_address": "TJ8pW3vY6dK1nR4sB9mA2cQx5LzH7GfEu0",
    "recipient_amount": "10.00",
    "network_fee": "3.00",
    "service_fee": "0.00",
    "total_debit": "13.00",
    "tx_hash": null,
    "error": null,
    "created_at": "2026-08-18T14:00:00Z",
    "completed_at": null
}

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

Разблокировать статический кошелёк

Получить возврат