Amounts & tokens

Amount fields

Field	Type	Description
amount	string	Decimal token amount, e.g. USDT "10.50" (6 decimals)
amountRaw	string	Smallest-unit integer string, e.g. "10500000"

警告

Always handle money as strings, BigInt, or high-precision decimals—never JavaScript Number for on-chain amounts.

Create-payment amount and webhook amount / amountRaw follow the same rules.

Token whitelist

tokenSymbol (e.g. USDT) must be enabled in your environment. Unsupported symbols return 400 BAD_REQUEST.

Responses include tokenContract for the mapped contract and paymentNetwork for the chain family (often TRC20 at launch; more networks planned).

Payment status

status	Meaning
PENDING	Awaiting payment
PARTIAL	Underpaid vs requested amount
PAID	Fully paid
EXPIRED	Expired
CANCELED	Canceled

payment.paid webhooks fire when the payment is PAID and confirmations are satisfied. For partial settlements, combine polling GET /v1/payments/:id with your business rules.