查询换汇订单信息
该API用于查询换汇订单信息
在执行完成外汇订单后,可以通过查询换汇订单信息接口获取最新订单信息。
API URL:https://mapi.yabandpay.com/Payments
Method:POST
POST data type:Json
| 参数 | 类型 | 描述 | 是否必填 |
|---|---|---|---|
| user | String | Merchant级的UID | 必填 |
| sign | String | 签名 | 必填 |
| method | String | v3.QueryFXOrder | 必填 |
| time | Long | 时间戳 | 必填 |
- 参数
| 参数 | 类型 | 描述 | 是否必填 |
|---|---|---|---|
| trade_id | String | 询价的id | 必填 |
| request_id | String | 请求id需保持唯一,建议24以上位数字+字母 | 必填 |
签名示例:
拼接为URL方式并排序后的字符串
"method=v3.QueryFXOrder&trade_id=4a49ffb3-a30f-ba92-9422-1969afb6f1210e1c&request_id=203040950640690239603690&time=1546588959&user=016683"
得到的 stringA 使用 secret_key做签名
得到的签名如下:
"8d53a15c0f1790dd636962eecaac8e936f3344c44c215a988f8363821bc31eae"
提交示例:
{
"user": "040268",
"sign": "ae1085ba3aadf276f8fd50598f00da1131e2f394da982be0a47ebe43a72bcba3",
"method": "v3.QueryFXOrder",
"time": 1546588959,
"data": {
"trade_id": "4a49ffb3-a30f-ba92-9422-1969afb6f121",
"request_id": "2030409506406902396036948"
}
}
返回示例:
{
"status": true,
"code": "200",
"data": {
"status": "complete",
"booking_status": "pending",
"settlement_status": "pending",
"sell_currency": "USD",
"buy_currency": "EUR",
"sold_currency": "USD",
"sold_amount": 1000,
"bought_currency": "EUR",
"bought_amount": 830.58,
"tenor": "TOD",
"exchange_rate": 0.8305804,
"trade_id": "4a49ffb3-a30f-ba92-9422-1969afb6f121",
"order_id": "513456465135416545",
"quote_id": "78636c41-d214-4a8f-ae22-5c112ca0e1c7",
"reference": "test",
"response_id": "203040950640690239603690"
},
"message": ""
}
更多信息:
返回结果:
- 调用成功,则返回
"status": true - 调用失败,则返回
"status": false
返回代码:
| Status | Code | Message |
|---|---|---|
| true | 200 | |
| false | -1000 | Internal error |
| false | -403 | The signature Error |
| false | -2001 | The user not exist |
| false | -3001 | Required field is missing |
| false | -4118 | Incorrect request ID |
| false | -4118 | Incorrect request ID |