Get Order (Single) Detail

Get Order Detail (Partner Flow)

GET /v1/stable/order/query-detail — query one order by merchantOrderId or orderId (one is required; use the same values as submit-order).

orderStatus

orderStatus	final	meaning
`INIT`	no	Order created; processing has not started yet.
`PROCESSING`	no	Order is being processed; fiat payout is in progress.
`SUCCESS`	yes	Fiat paid out to targetAccountId.
`FAIL`	yes	Order failed. See failCode / failReason.
`REFUNDING`	no	Stablecoin refund to userRefundCryptoAddress is in progress.
`REFUNDED`	yes	Refund succeeded: stablecoin returned to userRefundCryptoAddress.

REFUNDED = refund succeeded (stablecoin sent back to userRefundCryptoAddress).

In rare cases the receiving bank / mobile money operator returns the payout after SUCCESS; the order then moves SUCCESS → REFUNDING → REFUNDED and the stablecoin is refunded to userRefundCryptoAddress.

Only update your ledger on a final status. INIT / PROCESSING / REFUNDING are intermediate — keep polling (or wait for the webhook).

When orderStatus=FAIL, read failCode / failReason.

Polling

Poll at most once every 5 seconds per order. If an order stays in an intermediate status longer than expected, contact support with orderId and traceId; do not submit a new order for the same merchantOrderId.

HKD (RD Wallet) partners

HKD orders may also return AWAITING_FUNDS and EXPIRED, and use redirectUrl / nextAction / externalOrderId / depositAddress. These fields are null for KES / UGX / TZS.

Webhook: STABLE_ORDER_UPDATED — see Order Status Notification (STABLE_ORDER_UPDATED) in this folder. The webhook status is lowercase (init / success / fail / refunded); this endpoint returns uppercase orderStatus.

application/json

Bodyapplication/json

{
    "status": 200,
    "code": null,
    "msg": "OK",
    "data": {
        "orderId": "ST2026102014120391827364519201",
        "merchantOrderId": "PARTNER_ORDER_20261020_0001",
        "externalOrderId": null,
        "orderStatus": "INIT",
        "businessType": "STABLE_SELL",
        "paymentMethod": "BANK_TRANSFER",
        "sourceCurrency": "USDT",
        "targetCurrency": "KES",
        "sourceAmount": 100.0,
        "targetAmount": 12721.5,
        "ourFee": 1.0,
        "ourFeeCurrency": "USDT",
        "payInFee": 0,
        "payInFeeCurrency": "USDT",
        "payOutFee": 0,
        "payOutFeeCurrency": "KES",
        "redirectUrl": null,
        "nextAction": null,
        "depositAddress": null,
        "failCode": null,
        "failReason": null,
        "createdTime": 1792483200000,
        "completedTime": null,
        "sourceAccountId": null,
        "targetAccountId": "12991",
        "qrCode": null,
        "qrCodeImg": null
    },
    "traceId": "Auto:0d1e2f3a4b5c46d7e8f9a0b1c2d3e401",
    "success": true
}

Get Order (Single) Detail

Get Order Detail (Partner Flow)

orderStatus

Polling

HKD (RD Wallet) partners

Request

Request Code Samples

Responses

Get Order (Single) Detail

Get Order Detail (Partner Flow)#

orderStatus#

Polling#

HKD (RD Wallet) partners#

Request

Request Code Samples

Responses

Get Order Detail (Partner Flow)

orderStatus

Polling

HKD (RD Wallet) partners