获取trade_id
通过invoice_id获取trade_id。
[!TIP|style:flat]
交易成功后,可通过该接口获取对应的
trade_id,用于后续操作(如增加预授权、减少预授权、请款、查询、撤销或退款等)。
API URL(生产环境):https://mapi.yabandpay.com/Payments
API URL(测试环境):https://test.yabandpay.com/Payments
Method:POST
POST data type:Json
| 参数 | 类型 | 描述 | 是否必填 |
|---|---|---|---|
| user | String | 收银员账号的UID | 必填 |
| sign | String | 签名 | 必填 |
| method | String | v3.GetTradeId | 必填 |
| time | Long | 时间戳 | 必填 |
- 参数
| 参数 | 类型 | 描述 | 是否必填 |
|---|---|---|---|
| invoice_id | String | 单号 | 必填 |
签名示例:
拼接为URL方式并排序后的字符串
"invoice_id=1234567&method=v3.GetTradeId&time=1546588959&user=016683"
得到的 stringA 使用 secret_key做签名
得到的签名如下:
"8516dbeaf0c105e6df6e8da07f28f466a59ec1f8f5471ceed068a676fc2ce63c"
提交示例:
{
"user": "016683",
"sign": "8516dbeaf0c105e6df6e8da07f28f466a59ec1f8f5471ceed068a676fc2ce63c",
"method": "v3.GetTradeId",
"time": 1546588959,
"data": {
"invoice_id": "1234567"
}
}
返回示例:
{
"status": true,
"code": "200",
"data": {
"trade_id": "2312e8b0-8ed5-6a66-293e-29efc206c599"
},
"message": ""
}
更多信息:
返回结果:
若调用成功,则返回
"status": true若调用失败,则返回
"status": false
返回代码:
| Status | Code | Message |
|---|---|---|
| true | 200 | |
| false | -1000 | Internal error |
| false | -403 | The signature Error |
| false | -4006 | Order number does not exist |
注意事项
trade_id 通常需在交易完成约 1 分钟后方可获取。
若返回错误信息 "Order number does not exist",请间隔约 1 分钟后重试获取。