API REFERENCE
Terugbetaling opvragen
API-URL：https://mapi.yabandpay.com/Payments
Methode：POST
POST gegevenstype：Json
| Parameter | Type | Beschrijving | Verplicht |
|---|---|---|---|
| user | String | Kassieraccount UID | Verplicht |
| sign | String | Signature | Verplicht |
| method | String | v3.QueryRefundOrder | Verplicht |
| time | Long | Timestamp | Verplicht |
- Parameters
| Parameter | Type | Beschrijving | Verplicht |
|---|---|---|---|
| refund_id | String | YabandPay-terugbetalingsordernummer | Optioneel (een van beide velden is verplicht) |
| m_refund_id | String | Terugbetalingsordernummer van de merchant | Optioneel (een van beide velden is verplicht) |
Voorbeeld van een handtekening:
Parameters op volgorde samengevoegd tot een querystring in URL-stijl
"method=v3.QueryRefundOrder&time=1728566835&refund_id=3841510a-4d18-4a61-808d-431a45006de2&user=YOUR_CASHIER_UID"
Onderteken stringA met secret_key
De gegenereerde handtekening is:
"YOUR_SIGNATURE"
Voorbeeld van een aanvraag:
{
"user": "YOUR_CASHIER_UID",
"sign": "YOUR_SIGNATURE",
"method": "v3.QueryRefundOrder",
"time": 1728566835,
"data": {
"refund_id": "3841510a-4d18-4a61-808d-431a45006de2"
}
}
Voorbeeld van een antwoord:
{
"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": ""
}
Aanvullende informatie:
Resultaat van het antwoord:
-
Bij een geslaagde aanvraag wordt "status": true geretourneerd.
-
Bij een mislukte aanvraag wordt "status": false geretourneerd.
Terugbetalingsstatus:
| Code | Status | Bericht |
|---|---|---|
| 20 | to-be-approval | Wacht op goedkeuring door de beheerder. |
| 21 | refund pending | Het huidige saldo is onvoldoende. De terugbetaling wordt automatisch ingediend zodra er voldoende saldo beschikbaar is. |
| 22 | refund processing | Het terugbetalingsverzoek is ingediend en wordt door het systeem verwerkt. |
| 23 | refunded | De terugbetaling is geslaagd. |
| 24 | refund failed | De terugbetaling is mislukt. Probeer het opnieuw. |
| 25 | refund error | De terugbetaling is mislukt. Neem contact op met onze online klantenservice. |
| 26 | refund cancelled | De terugbetalingsorder is geannuleerd. |