文档中心/API 接口

API REFERENCE

创建换汇订单

POSThttps://mapi.yabandpay.com/Payments
实际接口
API PLAYGROUND · 实际接口

创建换汇订单

POSThttps://mapi.yabandpay.com/Payments
填写凭据后自动签名

请求参数4

先填写必填项

创建换汇订单

order_id必填stringdata.order_id外汇订单id
quote_id必填stringdata.quote_id询价的id
request_id必填stringdata.request_id请求id需保持唯一,建议24以上位数字+字母
可选参数 1
reference可选stringdata.reference备注

凭据仅在当前页面使用。secret_key 不保存,也不发送给文档服务器。

该API用于创建换汇订单

在完成汇率查询后,必须在30 秒内使用返回的quote_id执行换汇订单。

小贴士

获取quote_id后,需在30 秒内提交并执行外汇订单。

若超过有效时间,需重新调用汇率查询接口获取新的报价。

请使用专有账号

user=040268

参数类型描述是否必填
userStringMerchant级的UID必填
signString签名必填
methodStringv3.ExecuteFXOrder必填
timeLong时间戳必填
  • 参数
参数类型描述是否必填
order_idString外汇订单id必填
quote_idString询价的id必填
request_idString请求id需保持唯一,建议24以上位数字+字母必填
referenceString备注非必填

签名示例:

拼接为URL方式并排序后的字符串

"method=v3.ExecuteFXOrder&order_id=202603051019-16&quote_id=83e96dc0-8f8e-48c7-9bc4-6acc1019fced&reference=YB test&request_id=203040950640690239603690g-24&time=1546588959&user=040268"

得到的 stringA 使用 secret_key做签名

得到的签名如下:

"YOUR_SIGNATURE"

提交示例:

{
  "user": "040268",
  "sign": "YOUR_SIGNATURE",
  "method": "v3.ExecuteFXOrder",
  "time": 1546588959,
  "data": {
    "order_id": "YOUR_ORDER_ID",
    "quote_id": "83e96dc0-8f8e-48c7-9bc4-6acc1019fced",
    "reference": "YB test",
    "request_id": "203040950640690239603690g-24"
  }
}

返回示例:

{
  "status": true,
  "code": "200",
  "data": {
    "booking_status": "pending",
    "settlement_status": "pending",
    "sell_currency": "GBP",
    "buy_currency": "DKK",
    "sold_currency": "GBP",
    "sold_amount": "1.00",
    "bought_currency": "DKK",
    "bought_amount": "8.54",
    "tenor": "TOD",
    "exchange_rate": "8.544924729",
    "order_id": "YOUR_ORDER_ID",
    "quote_id": "83e96dc0-8f8e-48c7-9bc4-6acc1019fced",
    "trade_id": "6e5cf660fb58455cd68a413a8249061a",
    "reference": "YB test"
  },
  "message": "",
  "response_id": "202603181703581985574708"
}

更多信息:

返回结果:
  1. 调用成功,则返回"status": true
  2. 调用失败,则返回"status": false
返回代码:
StatusCodeMessage
true200
false-1000Internal error
false-403The signature Error
false-2001The UID not exist
false-3001Required field is missing
false-4118Incorrect request ID