Skip to main content
POST
创建订单

概述

本页说明 POST /payment/open/institution/v1/pay/address/create 接口。完整的请求参数、响应结构与示例由上方关联的 OpenAPI 定义渲染。 创建订单,订单币种和支付币种一致创建直付地址支付单,订单币种和支付币种不一致创建闪兑地址支付单

说明

  • 认证方式使用 GatePay 标准签名请求头。
  • 本页展示同一接口的机构路径版本。
  • 机构侧请求需携带 X-GatePay-On-Behalf-Of,用于表示本次代理请求的账户上下文;在机构代理商户 API 中通常填写目标子账户 ID。
  • 通用签名规则请参见 /api-reference/version/100/cn/common/securityAndSignature

请求头

X-GatePay-Certificate-ClientId
string
必填

商户客户端ID

示例:

"4186d0c6-6a35-55a9-8dc6-5312769dbff8"

X-GatePay-Signature
string
必填

签名

示例:

"672d5650dcc9bb22ebf25fa16c28d03c0e159d742a9176d4340a5da326d75dc8"

X-GatePay-Timestamp
string
必填

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

示例:

"1672905655498"

X-GatePay-Nonce
string
必填

随机数

示例:

"9578"

X-GatePay-On-Behalf-Of
string
必填

必填代理归属请求头。请填写本次请求的发起方账户 ID;在机构代理商户 API 中通常填写目标子账户 ID,在机构代扣与划转接口中可填写机构账户 ID 或子账户 ID。

请求体

application/json
merchantTradeNo
string
必填

商户系统中的交易号

env
object
必填
goods
object
必填
orderExpireTime
integer
必填

订单过期时间(毫秒)

merchantUserId
integer
必填

商户用户ID

chain
string
必填

链名称

fullCurrType
string
必填

带链币种

currency
string

加密货币币种。加密币下单时与 orderAmount 一并必传;纯法币下单(传 fiatCurrency + fiatAmount)时可省略,系统会换算为 USDT。须与 payCurrency 相同(未传 payCurrency 时以其回填)。

orderAmount
string

加密货币订单金额。加密币下单时与 currency 一并必传;纯法币下单(传 fiatCurrency + fiatAmount)时可省略。

surchargeAmount
string

附加费用

toleranceAmount
string

容差金额

fiatCurrency
string

法币币种,大写形式,如EUR、GBP、USD、CNY、JPY、AUD、CAD、CHF。纯法币下单时与 fiatAmount 一并传入,并省略 currency/orderAmount。

fiatAmount
string

法币订单金额,最小值0.01,最高精度为2位。纯法币下单时与 fiatCurrency 一并传入,并省略 currency/orderAmount。

payCurrency
string

用户支付币种。可选;未传时自动回填为 currency。若传入则必须与 currency 相同。

returnUrl
string

支付成功回调地址

cancelUrl
string

取消支付回调地址

channelId
string

客户名称

响应

200 - application/json

成功响应

响应参数

status
string
code
string
errorMessage
string
data
object