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

string

required

The order identifier. Example: order_1042.

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

string

The order identifier.

string

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

string

The token symbol. Example: "USDT".

string

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

string

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

string

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

integer

Unix timestamp when this payment request expires.

string

Current order status. See Order Status for possible values.

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
  }
}

Overview

Orders

Symbols

Webhooks

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

Request

Query Parameters

cURL

Response

PayinOrderVo Object

Example Response

​Request

​Query Parameters

​cURL

​Response

​PayinOrderVo Object

​Example Response

Request

Query Parameters

cURL

Response

PayinOrderVo Object

Example Response