Get Order Status | GET /v1/order/status/{orderId}

Fetch the current status and full details of any order (collection or payout) by its orderId. This endpoint is authenticated and intended for merchant server-to-server use.

Request

GET http://your-gateway:180/v1/order/status/{orderId}

Path Parameters

string

required

The order identifier you specified when creating the collection or payout. Example: order_1042.

cURL

curl http://your-gateway:180/v1/order/status/order_1042 \
  -H "Content-Type: application/json"

Response

A successful request returns HTTP 200 with the R<NotifyOrder> envelope.

NotifyOrder Object

string

The order identifier that was used when creating the collection or payout.

string

The user identifier associated with the order, if provided.

string

The type of order: COLLECTION or PAYOUT.

string

Current order status:

INIT — Order created, awaiting customer payment
PENDING — Transaction detected, awaiting confirmations
PENDING_CONFIRMATION — Waiting for block confirmations
SUCCESS — Payment confirmed successfully
EXPIRED — Order expired without payment
FAILED — Transaction failed

string | null

If the order failed or expired, this field contains the reason. null otherwise.

string

The requested amount as a decimal string (e.g., "250.00").

string

The actual amount received/paid. May differ from amount due to network fees or partial fills. null until confirmed.

string

The platform handling fee deducted. The platform operator configures the fee structure; when set to "0.00", no fee is charged.

object | null

Blockchain transaction details. null until a transaction is detected. See below.

Transaction Object

string

The blockchain network (e.g., "TRON", "ETH", "BSC").

string

The token symbol (e.g., "USDT").

string

The blockchain transaction hash.

string

The sender’s blockchain address.

string

The receiver’s blockchain address.

string

The transfer amount in decimal format.

integer

The block number where the transaction was included.

integer

The number of block confirmations received.

string

Blockchain transaction status: PENDING, SUCCESS, or FAILED.

integer

Unix timestamp of when the transaction was included in a block.

Example Response

{
  "code": 200,
  "msg": "success",
  "data": {
    "orderId": "order_1042",
    "uid": "user_42",
    "orderType": "COLLECTION",
    "status": "SUCCESS",
    "reason": null,
    "amount": "250.00",
    "actualAmount": "249.50",
    "fee": "0.00",
    "transaction": {
      "chain": "TRON",
      "symbol": "USDT",
      "txid": "a1b2c3d4e5f6...",
      "from": "TXyz...",
      "to": "TWkKZkmuB8DpVeiMoHiKf99ZoFHzk73CqR",
      "amount": "250.00",
      "blockNum": 12345678,
      "confirmedNum": 3,
      "status": "SUCCESS",
      "timestamp": 1717000123
    }
  }
}

Overview

Orders

Symbols

Webhooks

Get Order Status | GET /v1/order/status/{orderId}

Request

Path Parameters

cURL

Response

NotifyOrder Object

Transaction Object

Example Response

​Request

​Path Parameters

​cURL

​Response

​NotifyOrder Object

​Transaction Object

​Example Response

Request

Path Parameters

cURL

Response

NotifyOrder Object

Transaction Object

Example Response