Dokumentation/API-Referenz

API REFERENCE

Abrechnungsberichte

POSThttps://mapi.yabandpay.com/Payments
Live API
API PLAYGROUND · Live API

Abrechnungsberichte

POSThttps://mapi.yabandpay.com/Payments
Automatically signed with your credentials

Request parameters3

Required fields first

清算报表

commandRequiredstringdata.commandgetTradebill
bill_dateRequiredstringdata.bill_date账单日期 格式dd-MM-yyyy 仅支持三个月内的账单下载申请。
nonce_stringRequiredstringdata.nonce_string随机字符串,不长于32位

Credentials stay on this page. Your secret key is never stored or sent to the documentation server.

Diese API ruft YabandPay-Abrechnungsberichte ab.

Tipp

  1. 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.
  1. 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.
  1. Diese API kann nur vom Superadmin-Konto des Händlers aufgerufen werden. Bediener- und Kassiererkonten sind dazu nicht berechtigt.
ParameterTypBeschreibungErforderlich
userStringUID des Superadmin-KontosErforderlich
signStringSignatureErforderlich
methodStringv3.GetTradebillErforderlich
timeLongTimestampErforderlich
  • Parameter
ParameterTypBeschreibungErforderlich
commandStringgetTradebillErforderlich
bill_dateStringRechnungsdatum im Format dd-MM-yyyy. Downloads sind nur für Rechnungen der letzten drei Monate möglich.Erforderlich
nonce_stringStringZufällige Zeichenfolge mit höchstens 32 ZeichenErforderlich

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:
ParameterTypBeschreibung
time_zoneStringAbrechnungszeitzone, normalerweise die Zeitzone des Registrierungslands des Händlers
MIDStringMID des Händlers
merchant_nameStringHändlername
store_nameStringName des Händlergeschäfts
sub_pay_methodStringZahlungsmethode
settlement_currencyStringAbrechnungswährung, ISO 4217
number_of_paymentStringAnzahl der Zahlungstransaktionen
amount_of_paymentStringGesamtbetrag der Zahlungstransaktionen
number_of_refundStringAnzahl der Rückerstattungstransaktionen
amount_of_refundStringGesamtbetrag der Rückerstattungstransaktionen
feeStringTransaktionsgebühren
net_valueStringNettotransaktionsbetrag vor Abzug der MwSt.
vatStringMwSt. auf alle Transaktionsgebühren
stateStringAbrechnungsstatus: processing oder settled
transaction_dateStringDatum der Transaktion
due_dateStringVoraussichtliches Abrechnungsdatum
settlement_dateStringTatsächliches Abrechnungsdatum
clearing_idStringAbrechnungs-ID
countStringAnzahl der zurückgegebenen Datensätze