API REFERENCE
Verrekeningsrapporten
Deze API haalt de verrekeningsrapporten van YabandPay op.
Tip
- YabandPay verrekent dagelijks om 4 uur 's ochtends (Nederlandse tijd) alle transacties van de vorige dag en genereert vervolgens de rapporten. We raden aan de rapporten na 7 uur Nederlandse tijd op te vragen.
- Voor elke winkel en betaalmethode wordt dagelijks een verrekeningsrapport gegenereerd. Een winkel met bijvoorbeeld twee betaalmethoden ontvangt 2 rapporten per dag.
- Alleen superbeheerderaccounts van merchants mogen deze API aanroepen. Operator- en kassieraccounts zijn niet bevoegd.
API-URL:https://mapi.yabandpay.com/Payments
Methode:POST
POST gegevenstype:Json
| Parameter | Type | Beschrijving | Verplicht |
|---|---|---|---|
| user | String | UID van het superbeheerderaccount | Verplicht |
| sign | String | Signature | Verplicht |
| method | String | v3.GetTradebill | Verplicht |
| time | Long | Timestamp | Verplicht |
- Parameters
| Parameter | Type | Beschrijving | Verplicht |
|---|---|---|---|
| command | String | getTradebill | Verplicht |
| bill_date | String | Factuurdatum in dd-MM-yyyy-notatie. Alleen downloadaanvragen voor facturen van de afgelopen drie maanden worden ondersteund. | Verplicht |
| nonce_string | String | Willekeurige tekenreeks van maximaal 32 tekens | Verplicht |
Voorbeeld van een handtekening:
Parameters op volgorde samengevoegd tot een querystring in URL-stijl
"bill_date=2024-02-19&command=getTradebill&method=v3.GetTradebill&nonce_string=tw5be5b7sry5prm96s&time=1708422208&user=036870"
Onderteken stringA met secret_key
De gegenereerde handtekening is:
"YOUR_SIGNATURE"
Voorbeeld van een aanvraag:
{
"user": "040268",
"sign": "YOUR_SIGNATURE",
"method": "v3.GetTradebill",
"time": 1708422208,
"data": {
"command": "getTradebill",
"bill_date": "19-02-2024",
"nonce_string": "tw5be5b7sry5prm96s"
}
}
Voorbeeld van een antwoord:
{
"status": true,
"code": 200,
"message": "",
"data": {
"tradebill": [
{
"time_zone": "GMT+1",
"MID": 102300,
"merchant_name": "Yaband Telecom B.V.",
"store_name": "YabandPay",
"sub_pay_method": "WeChat Pay",
"settlement_currency": "EUR",
"number_of_payment": 8,
"amount_of_payment": "53.25",
"number_of_refund": 0,
"amount_of_refund": "0.00",
"fee": "0.9",
"net_value": "52.35",
"vat": "0.19",
"state": "settled",
"transaction_date": "2024-02-19",
"due_date": "2024-02-21",
"settlement_date": "2024-02-21",
"clearing_id": "M20240220001503109569"
},
{
"time_zone": "GMT+1",
"MID": 102300,
"merchant_name": "Yaband Telecom B.V.",
"store_name": "YabandPay",
"sub_pay_method": "Alipay",
"settlement_currency": "EUR",
"number_of_payment": 9,
"amount_of_payment": "67.85",
"number_of_refund": 0,
"amount_of_refund": "0.00",
"fee": "1.23",
"net_value": "66.62",
"vat": "0.20",
"state": "settled",
"transaction_date": "2024-02-19",
"due_date": "2024-02-21",
"settlement_date": "2024-02-21",
"clearing_id": "M20240220001503109614"
}
],
"count": 2
}
}
Aanvullende informatie:
Beschrijving van antwoordparameters:
| Parameter | Type | Beschrijving |
|---|---|---|
| time_zone | String | Tijdzone van de verrekening, doorgaans de tijdzone van het land waar de merchant is geregistreerd |
| MID | String | MID van de merchant |
| merchant_name | String | Naam van de merchant |
| store_name | String | Naam van de merchantwinkel |
| sub_pay_method | String | Betaalmethode |
| settlement_currency | String | Verrekeningsvaluta, ISO 4217 |
| number_of_payment | String | Aantal betalingstransacties |
| amount_of_payment | String | Totaalbedrag van betalingstransacties |
| number_of_refund | String | Aantal terugbetalingstransacties |
| amount_of_refund | String | Totaalbedrag van terugbetalingstransacties |
| fee | String | Transactiekosten |
| net_value | String | Nettotransactiewaarde vóór aftrek van btw |
| vat | String | Btw over alle transactiekosten |
| state | String | Verrekeningsstatus: processing of settled |
| transaction_date | String | Datum waarop de transactie heeft plaatsgevonden |
| due_date | String | Verwachte verrekendatum |
| settlement_date | String | Werkelijke verrekendatum |
| clearing_id | String | Verrekenings-ID |
| count | String | Aantal geretourneerde records |
