v1

latestOpenAPI 3.1.02026-07-21152963.1 KB

Confirm OTC Recharge Payment Completed

Notify the system that the merchant has completed the offline fiat transfer. This endpoint uses multipart/form-data. When generating the signature, use the plain text payload "timestamp\nnonce\n\n" and do not append the multipart body.

post/open/otc/api/recharge/confirm

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.