API REFERENCE
Obtenir trade_id
Paramètres
| Parameter | Type | Description | Obligatoire |
|---|---|---|---|
| data.invoice_id | string | 单号 | ✓ |
Obtenir trade_id à l’aide de invoice_id.
Conseil
Après la réussite d’une transaction, utilisez cette API pour obtenir le
trade_idcorrespondant afin d’effectuer des opérations ultérieures, telles qu’une augmentation ou une diminution de l’autorisation, une capture, une consultation, une annulation ou un remboursement.
URL de l’API (production) : https://mapi.yabandpay.com/Payments
URL de l’API (test) : https://acc-mapi.yabandpay.com/Payments
| Paramètre | Type | Description | Obligatoire |
|---|---|---|---|
| user | String | Compte caissier UID | Obligatoire |
| sign | String | Signature | Obligatoire |
| method | String | v3.GetTradeId | Obligatoire |
| time | Long | Timestamp | Obligatoire |
- Parameters | Paramètre | Type | Description | Obligatoire | |:--- |:--- |:--- |:--- | | invoice_id | String | Numéro de commande | Obligatoire |
Exemple de signature :
Paramètres triés et concaténés dans une chaîne de requête au format URL
"invoice_id=1234567&method=v3.GetTradeId&time=1546588959&user=YOUR_CASHIER_UID"
Signer stringA avec secret_key
La signature obtenue est :
"YOUR_SIGNATURE"
Exemple de requête :
{
"user": "YOUR_CASHIER_UID",
"sign": "YOUR_SIGNATURE",
"method": "v3.GetTradeId",
"time": 1546588959,
"data": {
"invoice_id": "1234567"
}
}
Exemple de réponse :
{
"status": true,
"code": "200",
"data": {
"trade_id": "2312e8b0-8ed5-6a66-293e-29efc206c599"
},
"message": ""
}
Informations complémentaires :
Résultat de la réponse :
-
Une requête réussie renvoie "status": true.
-
Une requête échouée renvoie "status": false.
Codes de réponse :
| Status | Code | Message |
|---|---|---|
| true | 200 | |
| false | -1000 | Internal error |
| false | -403 | The signature Error |
| false | -4006 | Order number does not exist |
Remarques
trade_id est généralement disponible environ 1 minute après la fin de la transaction.
Si l’erreur « Order number does not exist » est renvoyée, attendez environ 1 minute avant de réessayer.
