v1

latestOpenAPI 3.1.02026-07-21152963.1 KB

Create OTC Recharge Order

Create an OTC fiat recharge order.

post/open/otc/api/recharge

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.

Request body

quoteTokenstring required

Quote token returned by the quote API.

bankIdstring required

Merchant bank ID used for remittance.

currencystring required

Cryptocurrency to receive. Currently supported: USDT, USDC.

amountstring required

Cryptocurrency amount to be credited.

fiatCurrencystring required

Fiat currency to remit. Currently supported: USD.

fiatAmountstring required

Fiat amount to be paid.

promoCodestring

Optional promotion code.

Example request

{
  "quoteToken": "qt_01JXYZABCDEF",
  "bankId": "ba_123456789",
  "currency": "USDT",
  "amount": "1088.42",
  "fiatCurrency": "USD",
  "fiatAmount": "1000"
}

Response

Success

codestring

Business response code.

statusstring

Top-level request status.

errorMessagestring

Error message when the request fails.