v1

latestOpenAPI 3.1.02026-07-21152963.1 KB

Query OTC Recharge Order List

List OTC recharge orders. startTime and endTime are required.

get/open/otc/api/recharge/list

Query parameters

status'PENDING' | 'PROCESSING' | 'DONE' | 'CANCEL' | 'ERROR'

Filter by order status.

startTimeinteger required

Start of the query time range (epoch millis). Required.

endTimeinteger required

End of the query time range (epoch millis). Required.

pageinteger

Page number. Use -1 to fetch all records without pagination.

countinteger

Number of records per page. Required when page >= 0. Max 1000.

Headers

X-GatePay-Certificate-ClientIdstring required

Merchant application client ID used to identify the calling app.

X-GatePay-Signaturestring required

HMAC signature generated from the request according to GatePay signing rules.

X-GatePay-Timestampstring required

Unix timestamp used for replay protection and signature verification.

X-GatePay-Noncestring required

Random nonce used together with the timestamp to prevent replay attacks.

X-GatePay-On-Behalf-Ofstring

Institutional sub-account UID. Only required when an institution submits a request on behalf of a sub-account; not required for direct merchant requests.

Response

Success

codestring

Business response code.

statusstring

Top-level request status.

errorMessagestring

Error message when the request fails.