跳转到主要内容
POST
/
open
/
institution
/
otc
/
api
/
recharge
创建 OTC 入金订单
curl --request POST \
  --url https://openplatform.gateapi.io/open/institution/otc/api/recharge \
  --header 'Content-Type: application/json' \
  --header 'X-GatePay-Certificate-ClientId: <x-gatepay-certificate-clientid>' \
  --header 'X-GatePay-Nonce: <x-gatepay-nonce>' \
  --header 'X-GatePay-Signature: <x-gatepay-signature>' \
  --header 'X-GatePay-Timestamp: <x-gatepay-timestamp>' \
  --data '
{
  "quoteToken": "qt_01JXYZABCDEF",
  "bankAccountId": "ba_123456789",
  "cryptoCurrency": "USDT",
  "fiatCurrency": "USD",
  "cryptoAmount": "1088.42",
  "fiatAmount": "1000",
  "type": "BUY",
  "clientOrderId": "merchant-otc-deposit-20260415-001"
}
'
{
  "code": "0",
  "message": "success",
  "status": "success",
  "data": {
    "orderId": "71347515709194240",
    "status": "PENDING",
    "createTime": 1768973860523,
    "clientOrderId": "merchant-otc-deposit-20260415-001",
    "promoCode": "",
    "gate_bank_info": {
      "bankName": "Bank of Example",
      "bankAccountName": "Gate Pay OTC Collection",
      "countryId": 44,
      "country_name": "United Kingdom",
      "address": "1 Example Street, London",
      "iban": "GB11AAAA22223333444455",
      "swift": "ABCDEFGHXXX",
      "remittanceLineNumber": "021000021",
      "agentBankName": "",
      "agentBankSwift": "",
      "transfer_remark": "ORDER 71347515709194240"
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.gate.com/llms.txt

Use this file to discover all available pages before exploring further.

概述

本页说明 POST /open/institution/otc/api/recharge 接口。完整的请求参数、响应结构与示例由上方关联的 OpenAPI 定义渲染。

说明

使用建议

  • 调用该接口前,应先获取仍在有效期内的 OTC 报价。
  • 建议同时持久化保存 clientOrderIdorderId,便于后续对账与查询。
  • 接口返回的银行信息应视为结算指令,与订单快照一起保存。
  • 不要把“创建订单”理解为“付款完成”,后续仍需线下汇款并确认已付款。

机构说明

  • 机构侧请求需携带 X-GatePay-On-Behalf-Of,用于指定要操作的机构子账户。

请求头

X-GatePay-Certificate-ClientId
string
必填

用于标识调用应用的商户应用 ClientId。

X-GatePay-Signature
string
必填

按 GatePay 签名规则生成的 HMAC 签名。

X-GatePay-Timestamp
string
必填

用于防重放和验签的 Unix 时间戳。

X-GatePay-Nonce
string
必填

与时间戳配合使用的随机串,用于防止重放攻击。

请求体

application/json
quoteToken
string
必填

询价接口返回的 quote token。

bankAccountId
string
必填

用于汇款的商户银行账户 ID。

cryptoCurrency
string
必填

要接收的数字货币币种。当前支持:USDT、USDC。

fiatCurrency
string
必填

要支付的法币币种。当前支持:USD。

cryptoAmount
string
必填

预计入账的数字货币数量。

fiatAmount
string
必填

需要支付的法币金额。

type
string
必填

订单类型。入金场景使用 BUY。

clientOrderId
string
必填

商户自定义唯一订单号。

promCode
string

可选优惠码。

响应

200 - application/json

成功

code
string

业务响应码。

message
string

业务响应消息。

status
string

请求顶层状态。

data
object

入金订单数据。