v2

latestOpenAPI 3.1.0MIT2026-08-0512106137.3 KB

Charge Record Query

Query historical charge records by merchant batch number for result backfill or reconciliation checks. In the current version, it is no longer used as an asynchronous polling endpoint.

get/transfer/open/institution/v1/pay/charges/detail

Query parameters

merchantBatchNostring required

Unique batch ID from the merchant.

Headers

X-GatePay-Certificate-ClientIdstring required

Example:4186d0c6-6a35-55a9-8dc6-5312769dbff8

The clientId assigned when the merchant registers an application in the Gate merchant console.

X-GatePay-Timestampstring required

Example:1672905655498

Millisecond timestamp; the difference from server time must not exceed 30 seconds.

X-GatePay-Noncestring required

Example:9578

Random string. Must comply with HTTP header rules; recommended length is within 32 characters, composed of digits and letters.

X-GatePay-Signaturestring required

Request signature. GatePay uses this signature to verify whether the request is valid.

X-GatePay-On-Behalf-Ofstring required

Required delegated subject header. Provide the initiating account ID for this transaction. It can be an institution account ID or a sub-account ID.

Response

Success

statusstring

codestring

errorMessagestring