API REFERENCE
Abrechnungsberichte
Diese API ruft YabandPay-Abrechnungsberichte ab.
Tipp
- YabandPay rechnet täglich um 4 Uhr morgens (niederländische Zeit) alle Transaktionen des Vortags ab und erstellt Berichte. Wir empfehlen, die Berichte nach 7 Uhr niederländischer Zeit abzufragen.
- Für jedes Geschäft und jede Zahlungsmethode wird täglich ein Abrechnungsbericht erstellt. Verwendet ein Geschäft beispielsweise zwei Zahlungsmethoden, erhält es pro Tag 2 Berichte.
- Diese API kann nur vom Superadmin-Konto des Händlers aufgerufen werden. Bediener- und Kassiererkonten sind dazu nicht berechtigt.
| Parameter | Typ | Beschreibung | Erforderlich |
|---|---|---|---|
| user | String | UID des Superadmin-Kontos | Erforderlich |
| sign | String | Signature | Erforderlich |
| method | String | v3.GetTradebill | Erforderlich |
| time | Long | Timestamp | Erforderlich |
- Parameter
| Parameter | Typ | Beschreibung | Erforderlich |
|---|---|---|---|
| command | String | getTradebill | Erforderlich |
| bill_date | String | Rechnungsdatum im Format dd-MM-yyyy. Downloads sind nur für Rechnungen der letzten drei Monate möglich. | Erforderlich |
| nonce_string | String | Zufällige Zeichenfolge mit höchstens 32 Zeichen | Erforderlich |
Signaturbeispiel:
Die sortierten Parameter werden zu einer URL-ähnlichen Abfragezeichenfolge verkettet.
"bill_date=2024-02-19&command=getTradebill&method=v3.GetTradebill&nonce_string=tw5be5b7sry5prm96s&time=1708422208&user=036870"
Signieren Sie stringA mit secret_key.
Die resultierende Signatur lautet:
"YOUR_SIGNATURE"
Anfragebeispiel:
{
"user": "040268",
"sign": "YOUR_SIGNATURE",
"method": "v3.GetTradebill",
"time": 1708422208,
"data": {
"command": "getTradebill",
"bill_date": "19-02-2024",
"nonce_string": "tw5be5b7sry5prm96s"
}
}
Antwortbeispiel:
{
"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
}
}
Weitere Informationen:
Beschreibungen der Antwortparameter:
| Parameter | Typ | Beschreibung |
|---|---|---|
| time_zone | String | Abrechnungszeitzone, normalerweise die Zeitzone des Registrierungslands des Händlers |
| MID | String | MID des Händlers |
| merchant_name | String | Händlername |
| store_name | String | Name des Händlergeschäfts |
| sub_pay_method | String | Zahlungsmethode |
| settlement_currency | String | Abrechnungswährung, ISO 4217 |
| number_of_payment | String | Anzahl der Zahlungstransaktionen |
| amount_of_payment | String | Gesamtbetrag der Zahlungstransaktionen |
| number_of_refund | String | Anzahl der Rückerstattungstransaktionen |
| amount_of_refund | String | Gesamtbetrag der Rückerstattungstransaktionen |
| fee | String | Transaktionsgebühren |
| net_value | String | Nettotransaktionsbetrag vor Abzug der MwSt. |
| vat | String | MwSt. auf alle Transaktionsgebühren |
| state | String | Abrechnungsstatus: processing oder settled |
| transaction_date | String | Datum der Transaktion |
| due_date | String | Voraussichtliches Abrechnungsdatum |
| settlement_date | String | Tatsächliches Abrechnungsdatum |
| clearing_id | String | Abrechnungs-ID |
| count | String | Anzahl der zurückgegebenen Datensätze |
