API REFERENCE
Consultar dispositivos
Parámetros
| Parameter | Type | Descripción | Obligatorio |
|---|---|---|---|
| data.request_id | string | 请求id需保持唯一，建议24以上位数字+字母 | ✓ |
Los comercios utilizan esta API para obtener la lista de dispositivos POS.
API URL (production): https://mapi.yabandpay.com/Payments
API URL (test): https://acc-mapi.yabandpay.com/Payments
| Parámetro | Tipo | Descripción | Obligatorio |
|---|---|---|---|
| user | String | UID of the Merchant-level super administrator account | Obligatorio |
| sign | String | Signature | Obligatorio |
| method | String | v3.GetPOSList | Obligatorio |
| time | Long | Timestamp | Obligatorio |
- Parámetros
| Parámetro | Tipo | Descripción | Obligatorio |
|---|---|---|---|
| request_id | String | ID de solicitud único; se recomienda una combinación de letras y números de al menos 24 caracteres | Obligatorio |
Ejemplo de firma:
Parámetros ordenados y concatenados en una cadena de consulta con formato de URL
"method=v3.GetPOSList&request_id=a7z1lox4l6z6mdx1udgn5gtezasze1x0&time=1560753647&user=YOUR_CASHIER_UID"
Firme la cadena A con secret_key
La firma resultante es:
"YOUR_SIGNATURE"
Ejemplo de solicitud:
{
"user": "YOUR_CASHIER_UID",
"sign": "YOUR_SIGNATURE",
"method": "v3.GetPOSList",
"time": 1560753647,
"data": {
"request_id": "a7z1lox4l6z6mdx1udgn5gtezasze1x0"
}
}
Ejemplo de respuesta:
{
"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": ""
}
Información adicional:
Resultado de la respuesta:
-
Una solicitud correcta devuelve "status": true.
-
Una solicitud fallida devuelve "status": false.
Códigos de respuesta:
| 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 |