GAgate

Create OTC Recharge Order

Changed on

Create an OTC fiat recharge order.

post/payment/open/otc/api/recharge

Request

  • Base URL
    https://openplatform.gateapi.io
  • URL
    https://openplatform.gateapi.io/payment/open/otc/api/recharge
  • 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

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.

Changes

  • 873496ac0fbfRevision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

  • c57d5cf03098Revision changes
    • info

      endpoint added