Money and idempotency
Settlement balance
Your funds live on a single USDT / TRON settlement account.
Create calls that need funds check available balance. Insufficient funds →
422 / insufficient_balance (document is not created). IMBA does not extend credit.
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
v1 asset:currency=USDTnetwork=TRON
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.
Amounts
JSON amounts are decimal strings (e.g."12.50"), not floats.
Timestamps are UTC RFC 3339.