API REFERENCE
Obtener trade_id
Parámetros
| Parameter | Type | Descripción | Obligatorio |
|---|---|---|---|
| data.invoice_id | string | 单号 | ✓ |
Obtener trade_id using invoice_id.
Consejo
Después de una transacción correcta, utilice esta API para obtener el correspondiente
trade_idpara operaciones posteriores, como aumentar o reducir la autorización, capturar fondos, consultar, revertir o reembolsar.
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 | Cuenta de cajero UID | Obligatorio |
| sign | String | Signature | Obligatorio |
| method | String | v3.GetTradeId | Obligatorio |
| time | Long | Timestamp | Obligatorio |
- Parámetros
| Parámetro | Tipo | Descripción | Obligatorio |
|---|---|---|---|
| invoice_id | String | Order number | Obligatorio |
Ejemplo de firma:
Parámetros ordenados y concatenados en una cadena de consulta con formato de URL
"invoice_id=1234567&method=v3.GetTradeId&time=1546588959&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.GetTradeId",
"time": 1546588959,
"data": {
"invoice_id": "1234567"
}
}
Ejemplo de respuesta:
{
"status": true,
"code": "200",
"data": {
"trade_id": "2312e8b0-8ed5-6a66-293e-29efc206c599"
},
"message": ""
}
Información adicional:
Resultado de la respuesta:
-
A successful request returns "status": true.
-
A failed request returns "status": false.
Códigos de respuesta:
| Status | Code | Message |
|---|---|---|
| true | 200 | |
| false | -1000 | Internal error |
| false | -403 | The signature Error |
| false | -4006 | Order number does not exist |
Notes
trade_id es generally available approximately 1 minute after transaction completion.
If the error "Order number does not exest" es returned, wait approximately 1 minute before trying again.
