API REFERENCE
设备查询
商户此接口获取pos设备的列表
API URL(生产环境):https://mapi.yabandpay.com/Payments
API URL(测试环境):https://acc-mapi.yabandpay.com/Payments
| 参数 | 类型 | 描述 | 是否必填 |
|---|---|---|---|
| user | String | Merchant级超级管理员账号的的UID | 必填 |
| sign | String | 签名 | 必填 |
| method | String | v3.GetPOSList | 必填 |
| time | Long | 时间戳 | 必填 |
- 参数
| 参数 | 类型 | 描述 | 是否必填 |
|---|---|---|---|
| request_id | String | 请求id需保持唯一,建议24以上位数字+字母 | 必填 |
签名示例:
拼接为URL方式并排序后的字符串
"method=v3.GetPOSList&request_id=a7z1lox4l6z6mdx1udgn5gtezasze1x0&time=1560753647&user=YOUR_CASHIER_UID"
得到的 stringA 使用 secret_key做签名
得到的签名如下:
"YOUR_SIGNATURE"
提交示例:
{
"user": "YOUR_CASHIER_UID",
"sign": "YOUR_SIGNATURE",
"method": "v3.GetPOSList",
"time": 1560753647,
"data": {
"request_id": "a7z1lox4l6z6mdx1udgn5gtezasze1x0"
}
}
返回示例:
{
"status": true,
"code": "200",
"data": {
"POS": [
{
"tid": "T125118250",
"uid": "T125118250",
"sn": "N62XXXXXXXX",
"model": "N62",
"secretkey": "YOUR_SECRET_KEY",
"store_id": "1265484354",
"store_name": "test store1"
},
{
"tid": "T125118251",
"uid": "T125118251",
"sn": "N62XXXXXXXX",
"model": "N62",
"secretkey": "YOUR_SECRET_KEY",
"store_id": "1265484354",
"store_name": "test store1"
},
{
"tid": "T125118252",
"uid": "T125118252",
"sn": "N62XXXXXXXX",
"model": "N62",
"secretkey": "YOUR_SECRET_KEY",
"store_id": "1265484355",
"store_name": "test store2"
}
]
},
"message": ""
}
更多信息:
返回结果:
-
若调用成功,则返回"status": true
-
若调用失败,则返回"status": false
返回代码:
| Status | Code | Message |
|---|---|---|
| true | 200 | Success |
| false | -1000 | Internal error |
| false | -3001 | Required field is missing |
| false | -3002 | duplicate request_id |
| false | -403 | The signature Error |
