GAgate

Confirm OTC Recharge Payment Completed

Changed on

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 string “timestamp\nnonce\n\n”, and do not append the multipart request body.

post/payment/open/otc/api/recharge/confirm

Request

  • Base URL
    https://openplatform.gateapi.io
  • URL
    https://openplatform.gateapi.io/payment/open/otc/api/recharge/confirm
  • Auth
    none declared. Required headers: X-GatePay-Certificate-ClientId, X-GatePay-Signature, X-GatePay-Timestamp, X-GatePay-Nonce

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

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

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.

Request body multipart/form-data

orderIdstring required

OTC deposit order ID to confirm.

filestring binary required

Payment receipt file. Max 4 MB. Supported formats: jpg, jpeg, png, pdf.

Example request

{
  "orderId": "71347515709194240",
  "file": "(binary)"
}

Response

Success

codestring

Business response code.

statusstring

Top-level request status.

errorMessagestring

Error message when the request fails.

Changes