Settlement balance
Your funds live on a single USDT / TRON settlement account.
Create calls that need funds check available balance. Insufficient funds →
409 / insufficient_balance (document is not created). IMBA does not extend credit.
Commercial onboarding: 1,000 USDT minimum first deposit; no monthly volume minimum. You may call read endpoints at zero balance.
Refunds and cancellation
There is no Partner API to refund a completed gift, unused eSIM, or card balance, and no cancel-purchase call.
Withdrawals may terminate as
failed or cancelled (provider/ops), not via a partner cancel endpoint. See FAQ.
Fees
Some operations return a separatefee (USDT). For withdrawals, amount is what the recipient receives; the fee is charged on top from your available balance.
Catalog prices for eSIM/gift are the USDT debit amounts you will be charged (after any agreed discount).
Currency / network
Optional synonym on some endpoints:
asset=USDT_TRC20.
ext_id idempotency
Every create requires your ext_id (unique per partner).
Use
GET /partner/documents/{ext_id} to poll status. Design ext_id as a stable business key (order id), not a random value per retry.
After a terminal failure (including stuck card_issue → issue_timeout), start a new attempt with a new ext_id. Documents are not deleted on timeout.
Amounts
JSON amounts are decimal strings (e.g."12.50"), not floats.
Response timestamps are UTC RFC 3339 with Z. Request time fields also accept unix seconds — see Conventions.