跳转到主要内容
POST
/
transfer
/
open
/
institution
/
v1
/
pay
/
convert
发起闪兑
curl --request POST \
  --url https://openplatform.gateapi.io/transfer/open/institution/v1/pay/convert \
  --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 '
{
  "clientReqId": "<string>",
  "quoteId": "<string>",
  "buyAmount": "<string>",
  "buyCurrency": "<string>",
  "sellAmount": "<string>",
  "sellCurrency": "<string>"
}
'
{
  "status": "<string>",
  "code": "<string>",
  "errorMessage": "<string>",
  "data": {
    "order_id": "<string>",
    "userId": "<string>",
    "sellCurrency": "<string>",
    "buyCurrency": "<string>",
    "sellAmount": "<string>",
    "buyAmount": "<string>",
    "status": "<string>",
    "rate": "<string>",
    "quoteId": "<string>",
    "createTime": "<string>"
  }
}

请求头

X-GatePay-Certificate-ClientId
string
必填

商户在Gate商户后台注册应用时分配的clientId

示例:

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

X-GatePay-Signature
string
必填

请求签名。GatePay通过此签名来确定此请求是否合法

X-GatePay-Timestamp
string
必填

请求生成时的UTC时间戳,milliseconds。请注意,GatePay不处理收到请求时间与这个时间戳差距大于10秒钟的请求

示例:

"1672905655498"

X-GatePay-Nonce
string
必填

随机字符串,字符符合HTTP Header头部的规范,建议长度在32个字符以内,字符串组成为数字和字母

示例:

"9578"

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

被代理的机构账户id

示例:

"2124538349"

请求体

application/json
clientReqId
string
必填

客户端请求 ID,用于幂等

quoteId
string
必填

报价 ID,须与 preview 返回一致

buyAmount
string
必填

购买数量,须与 preview 一致

buyCurrency
string
必填

购买币种,须与 preview 一致

sellAmount
string
必填

出售数量,须与 preview 一致

sellCurrency
string
必填

出售币种,须与 preview 一致

响应

200 - application/json

成功

status
string
code
string
errorMessage
string
data
object