Skip to main content
POST
创建 OTC 入金订单

概述

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

说明

使用建议

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

请求头

X-GatePay-Certificate-ClientId
string
必填

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

X-GatePay-Signature
string
必填

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

X-GatePay-Timestamp
string
必填

毫秒级时间戳,与服务端时间偏差不得超过30秒

X-GatePay-Nonce
string
必填

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

X-GatePay-On-Behalf-Of
string

机构子账户 UID。仅在机构代替子账户发起业务请求时传输;直连商户请求时不需要传输。

请求体

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