Merchant API
Topup Intents

Get a top-up intent

Fetch a top-up intent by id. Scoped to the authenticating merchant and the key's stamped environment.

GET
/topup_intents/{id}

Fetch a top-up intent by id. Scoped to the authenticating merchant and the key's stamped environment.

AuthorizationBasic <token>

Merchant API key pair. Send as Authorization: Basic base64(publicKey:secretKey) — username is the public key (pk_live_… / pk_test_…), password is the secret key (sk_live_… / sk_test_…). The public key prefix determines the environment of every order created by the request — there is no body, query, or header override.

In: header

Path Parameters

id*string

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/topup_intents/string"
{  "created_at": "2026-06-07T10:20:00.000Z",  "destination": {    "amount": "100000",    "credited_amount": "100000",    "currency": "MYR",    "merchant_id": "team_01HZYABCDXYZ"  },  "environment": "test",  "expires_at": "2026-06-07T10:35:00.000Z",  "failure_code": null,  "failure_message": null,  "fx": {    "destination_currency": "MYR",    "rate": "4.670000",    "source_currency": "USDT",    "spread_amount": "0"  },  "id": "tuin_01HZYABCDXYZ",  "next_action": {    "address": "TExampleAddress",    "amount": "214123456",    "currency": "USDT",    "expires_at": "2026-06-07T10:35:00.000Z",    "network": "TRC20",    "type": "display_crypto_payment_instructions"  },  "object": "topup_intent",  "source": {    "amount": "214123456",    "currency": "USDT",    "expires_at": "2026-06-07T10:35:00.000Z",    "fee_amount": "0",    "fee_mode": "absorbed",    "provider": null,    "type": "provider_gateway"  },  "status": "requires_payment",  "updated_at": "2026-06-07T10:20:01.000Z"}