Get Pay Link Details | GET /v1/order/pay

Returns the checkout details for a collection order. This is the endpoint used by the hosted checkout page to render payment instructions, but you can also call it directly to retrieve order information for a customer-facing interface.

Request

GET http://your-gateway:180/v1/order/pay?orderId={orderId}&sign={sign}

Query Parameters

orderId

string

required

The order identifier. Example: order_1042.

sign

string

required

HMAC-SHA256 signature computed over the orderId value. See Authentication.

cURL

curl "http://your-gateway:180/v1/order/pay?orderId=order_1042&sign=a1b2c3d4e5f6..."

Response

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

PayinOrderVo Object

orderId

string

The order identifier.

chain

string

The blockchain network for this payment. Example: "TRON".

symbol

string

The token symbol. Example: "USDT".

address

string

The deposit address where the customer should send funds. Example: "TWkKZkmuB8DpVeiMoHiKf99ZoFHzk73CqR".

amount

string

The requested amount as a decimal string. Example: "250.00".

actualAmount

string

The actual amount received once payment is confirmed. null before payment.

expiredTime

integer

Unix timestamp when this payment request expires.

status

string

Current order status. See Order Status for possible values.

reason

string | null

Failure or expiry reason. null if the order is still valid.

Example Response

{
  "code": 200,
  "msg": "success",
  "data": {
    "orderId": "order_1042",
    "chain": "TRON",
    "symbol": "USDT",
    "address": "TWkKZkmuB8DpVeiMoHiKf99ZoFHzk73CqR",
    "amount": "250.00",
    "actualAmount": null,
    "expiredTime": 1717086400,
    "status": "PENDING",
    "reason": null
  }
}

​Request

​Query Parameters

​cURL

​Response

​PayinOrderVo Object

​Example Response

Request

Query Parameters

cURL

Response

PayinOrderVo Object

Example Response