API REFERENCE
Consulter un remboursement
Paramètres
| Parameter | Type | Description | Obligatoire |
|---|---|---|---|
| data.refund_id | string | YabandPay退款单号 | — |
| data.m_refund_id | string | 商户退款单号 | — |
| Paramètre | Type | Description | Obligatoire |
|---|---|---|---|
| user | String | Compte caissier UID | Obligatoire |
| sign | String | Signature | Obligatoire |
| method | String | v3.QueryRefundOrder | Obligatoire |
| time | Long | Timestamp | Obligatoire |
- Parameters | Paramètre | Type | Description | Obligatoire | |:------------|:--- |:--------------|:-------------------| | refund_id | String | Numéro de remboursement YabandPay | Facultatif (l’un des deux paramètres doit être fourni) | | m_refund_id | String | Numéro de remboursement du marchand | Facultatif (l’un des deux paramètres doit être fourni) |
Exemple de signature :
Paramètres triés et concaténés dans une chaîne de requête au format URL
"method=v3.QueryRefundOrder&time=1728566835&refund_id=3841510a-4d18-4a61-808d-431a45006de2&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.QueryRefundOrder",
"time": 1728566835,
"data": {
"refund_id": "3841510a-4d18-4a61-808d-431a45006de2"
}
}
Exemple de réponse :
{
"status": true,
"code": "200",
"data": {
"transaction_id": "20240903153820059756",
"refund_id": "20240903154342497308",
"m_refund_id": null,
"refund_time": "1725349422",
"state": "refunded",
"refund_amount": "0.01",
"refund_currency": "EUR",
"refund_description": "gary",
"notify_url": "null",
"demo": "",
"settlement_refund_amount": "0.01",
"settlement_refund_currency": "EUR",
"merchant_cost": "0.1",
"yb_transaction_id": "c07859aa-3d12-69d4-ef2f-a9556d9c4d33"
},
"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.
Statut du remboursement :
| Code | State | Message |
|---|---|---|
| 20 | to-be-approval | En attente de l’approbation d’un administrateur. |
| 21 | refund pending | Le solde actuel est insuffisant. Le remboursement sera soumis automatiquement lorsque les fonds seront suffisants. |
| 22 | refund processing | La demande de remboursement a été soumise et est en cours de traitement par le système. |
| 23 | refunded | Le remboursement a été effectué avec succès. |
| true | 24 | |
| false | -25 | Internal error |
| false | -26 | The signature Error |
