跳转到主要内容
POST
/
open
/
otc
/
api
/
recharge
创建 OTC 入金订单
curl --request POST \
  --url https://openplatform.gateapi.io/open/otc/api/recharge \
  --header 'Content-Type: application/json' \
  --header 'X-GatePay-Certificate-ClientId: <x-gatepay-certificate-clientid>' \
  --header 'X-GatePay-MerchantId: <x-gatepay-merchantid>' \
  --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",
  "bankId": "ba_123456789",
  "currency": "USDT",
  "amount": "1088.42",
  "fiatCurrency": "USD",
  "fiatAmount": "1000"
}
'
{
  "code": "<string>",
  "status": "<string>",
  "errorMessage": "<string>",
  "data": {
    "orderId": "<string>",
    "otcOrderId": "<string>",
    "currency": "<string>",
    "amount": "<string>",
    "fiatCurrency": "<string>",
    "fiatAmount": "<string>",
    "cfRate": "<string>",
    "bankId": "<string>",
    "bankNumber": "<string>",
    "paid": true,
    "status": "<string>",
    "card_info": {
      "id": 123,
      "uid": 123,
      "entity": "<string>",
      "bank_account_name": "<string>",
      "bank_name": "<string>",
      "bank_country": "<string>",
      "bank_address": "<string>",
      "bank_code": "<string>",
      "branch_code": "<string>",
      "iban": "<string>",
      "swift": "<string>",
      "remittance_line_number": "<string>",
      "agent_bank_name": "<string>",
      "agent_bank_swift": "<string>",
      "transferRemark": "<string>",
      "memo": "<string>",
      "is_default": true,
      "bank_id": "<string>"
    },
    "createTime": 123,
    "promoCode": "<string>",
    "transferRemark": "<string>"
  }
}

概述

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

说明

使用建议

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

请求头

X-GatePay-Certificate-ClientId
string
必填

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

X-GatePay-Signature
string
必填

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

X-GatePay-Timestamp
string
必填

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

X-GatePay-Nonce
string
必填

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

X-GatePay-MerchantId
integer<int64>
必填

商户 ID。

请求体

application/json
quoteToken
string
必填

报价接口返回的报价 token。

bankId
string
必填

用于汇款的商户银行 ID。

currency
string
必填

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

amount
string
必填

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

fiatCurrency
string
必填

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

fiatAmount
string
必填

需要支付的法币金额。

promoCode
string

可选优惠码。

响应

200 - application/json

成功

code
string

业务响应码。

status
string

请求顶层状态。

errorMessage
string

请求失败时的错误信息。

data
object