跳转到主要内容
POST
/
payment
/
open
/
institution
/
v1
/
pay
/
address
/
create
创建订单
curl --request POST \
  --url https://openplatform.gateapi.io/payment/open/institution/v1/pay/address/create \
  --header 'Content-Type: application/json' \
  --header 'X-GatePay-Certificate-ClientId: <x-gatepay-certificate-clientid>' \
  --header 'X-GatePay-Nonce: <x-gatepay-nonce>' \
  --header 'X-GatePay-On-Behalf-Of: <x-gatepay-on-behalf-of>' \
  --header 'X-GatePay-Signature: <x-gatepay-signature>' \
  --header 'X-GatePay-Timestamp: <x-gatepay-timestamp>' \
  --data '
{
  "merchantTradeNo": "93840202212210025",
  "env": {
    "terminalType": "MINIAPP"
  },
  "goods": {
    "goodsName": "USDT_PAY_BTC_TEST",
    "goodsDetail": "yc"
  },
  "orderExpireTime": 1673410179000,
  "merchantUserId": 1336974,
  "chain": "BSC",
  "fullCurrType": "BTC_BSC"
}
'
{
  "status": "SUCCESS",
  "code": "000000",
  "errorMessage": "",
  "data": {
    "prepayId": "47656656276819968",
    "terminalType": "MINIAPP",
    "expireTime": 1673410179000,
    "chain": {
      "chain_type": "BSC",
      "fullCurrType": "USDT_BSC",
      "address": "0x1699dB45Dc502A0395038265fCBC4Fa05d6afFBD"
    }
  }
}

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 /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
必填

时间戳(毫秒)

示例:

"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
string

订单金额

surchargeAmount
string

附加费用

toleranceAmount
string

容差金额

fiatCurrency
string

法币币种,大写形式,如EUR、GBP、USD、CNY、JPY、AUD、CAD、CHF

fiatAmount
string

法币订单金额,最小值0.01,最高精度为2位

payCurrency
string

用户选择的支付币种,非闪兑单不需要传)

returnUrl
string

支付成功回调地址

cancelUrl
string

取消支付回调地址

channelId
string

客户名称

响应

200 - application/json

成功响应

响应参数

status
string
code
string
errorMessage
string
data
object