Field Conventions & Glossary
Canonical definitions used across API documentation.
Amount & Currency
| Term | Definition |
|---|
| amount | Integer in minor units (e.g. cents, smallest token fraction) |
| amount_with_fee | Amount plus applied fee (minor units) |
| currency | ISO-like currency / token code (e.g. USDT) |
Identifiers
| Term | Definition |
|---|
| id | Internal system UUID of transaction |
| txid | Client-supplied idempotent external identifier |
Routing & Environment
| Term | Definition |
|---|
| route | Processing path alias configured for API key |
| env | Execution environment: prod (default) or test |
Status Lifecycle
| Status | Meaning |
|---|
| created | Accepted, awaiting processing |
| charging | In progress (authorization / funding) |
| charged | Successfully completed |
| rejected | Irrecoverably failed |
Time Fields
| Field | Definition |
|---|
| started | ISO timestamp when processing began |
| finished | ISO timestamp when terminal (charged/rejected) reached |
Money Storage Objects
| Field | Definition |
|---|
| network | Blockchain network (ETH, TRX, etc.) |
| type | Instrument type (bank_card, p2p_proxy, etc.) |
| wallet_id | Internal wallet identifier (payout/payment target) |
| cardnumber | Virtual card PAN (masked in some responses) |
| cvv | Virtual card security code (never log in plaintext) |
| exp_month / exp_year | Card expiry values (string, zero padded) |
| cardholder | Cardholder name (ASCII or UTF-8) |
Error Fields
| Field | Definition |
|---|
| error_description | Human-readable failure reason (non-stable text) |
Idempotency Guidance
Use a unique txid per business operation. Retry identical creation requests only with the same txid to avoid duplicate charges.
Polling Strategy
- Submit transaction.
- Poll: 1s, 2s, 4s, 8s ... cap at 30s.
- Stop on terminal status or timeout budget.
Webhooks indicate state change but are not authoritative. Always confirm via GET Transaction.