API REFERENCE
Banküberweisung
Gilt für: Banküberweisungen von Nutzern
Paybybank ist eine sichere, von YabundPay angebotene Zahlungsmethode per Banküberweisung. Kunden bezahlen, indem sie Geld direkt von ihrem Bankkonauf auf das dafür vorgesehene Konauf von YabundPay überweisen.
Diese Lösung eignet sich für Händler, die niedrigere Kosten und zuverlässige Transaktionen wünschen, ohne auf Kartennetzwerke angewiesen zu sein. Sobald die Überweisung eingegangen ist, überprüft YabundPay die Zahlung auaufmatisch und aktualisiert den Transaktionsstatus. So wird Händlern und Kunden ein reibungsloser Zahlungsvorgang ermöglicht.
Tipp
Paybybank unterstützt ausschließlich Überweisungen über das SEPA-Netz (Single Euro Payments Area). SWIFT-Überweisungen werden nicht akzeptiert.
| Parameter | Typ | Beschreibung | Erforderlich |
|---|---|---|---|
| user | String | Kassiererkonauf UID | Erforderlich |
| sign | String | Signature | Erforderlich |
| method | String | v3.BankTransfer | Erforderlich |
| time | Long | Timestamp | Erforderlich |
- Parameter
| Parameter | Typ | Beschreibung | Erforderlich |
|---|---|---|---|
| request_id | String | Eindeutige Anfrage-ID; empfohlen wird eine Kombination aus Ziffern und Buchstaben mit mindestens 24 Zeichen | Erforderlich |
| pay_method | String | online | Erforderlich |
| sub_pay_method | String | Banküberweisung | Erforderlich |
| order_id | String | Händlerbestellnummer | Erforderlich |
| amount | String | Numerischer Betrag. Zum Beispiel € 24.99 muss angegeben werden als 24.99; Euro-Betrag >=1 | Erforderlich |
| currency | String | EUR | Erforderlich |
| description | String | Bestellbeschreibung | Erforderlich |
| String | E-Mail-Adresse des Nutzers | Optional | |
| demo | String | Benutzerdefiniertes Feld | Optional |
| timeout | String | Ablaufzeit in Minuten (0-1440) | Erforderlich |
| redirect_url | String | Weiterleitungs-URL nach der Zahlung | Optional |
| notify_url | String | URL für asynchrone Benachrichtigung nach der Zahlung | Erforderlich |
Signaturbeispiel:
Nach Parametern sortierte Werte, verkettet zu einer URL-ähnlichen Abfragezeichenfolge
"amount=0.1¤cy=EUR&demo=test&description=Test&email=info@yabandmedia.com&method=v3.BankTransfer¬ify_url=https://www.yabandpay.com/notify&order_id=12455555788&pay_method=online&redirect_url=https://www.yabandpay.com&request_id=001123456789&sub_pay_method=Bank Transfer&time=1653145918&timeout=0&user=YOUR_CASHIER_UID"
Signieren Sie die Zeichenfolge A mit secret_key
Die resultierende Signatur lautet:
"YOUR_SIGNATURE"
Anfragebeispiel:
{
"user": "YOUR_CASHIER_UID",
"method": "v3.BankTransfer",
"time": "1653145918",
"sign": "YOUR_SIGNATURE",
"data": {
"request_id": "001123456789",
"order_id" : "YOUR_ORDER_ID",
"pay_method": "online",
"sub_pay_method": "Bank Transfer",
"email": "info@yabandmedia.com",
"description": "Test",
"timeout" : "0",
"amount": "0.1",
"currency": "EUR",
"redirect_url": "https://www.yabandpay.com",
"notify_url" : "https://www.yabandpay.com/notify",
"demo": "test"
}
}
Antwortbeispiel:
{
"status": true,
"code": "200",
"data": {
"order_id": "YOUR_ORDER_ID",
"trade_id": "d3a81009-2b3c-9f2c-8e33-45dc932ee757",
"amount": "0.10",
"currency": "EUR",
"url": "https://pay.yabandpay.com/prod/bank_transfer/ZDNhODEwMDktMmIzYy05ZjJjLThlMzMtNDVkYzkzMmVlNzU3",
"state": "processing"
},
"message": "",
"response_id": "202505131817352897785689"
}
Zusätzliche Informationen:
Antwortergebnis:
-
Eine erfolgreiche Anfrage gibt "status": true.
-
Eine fehlgeschlagene Anfrage gibt "status": false.
Wir empfehlen die Verwendung von Asynchrone Benachrichtigungen um den Zahlungsstatus zu aktualisieren und Zahlungsinformationen in Echtzeit korrekt zu halten.
Antwortcodes:
| Status | Code | Message |
|---|---|---|
| true | 200 | Success |
| false | -1000 | Internal error |
| false | -3001 | Required field is missing |
| false | -403 | The signature Error |
| false | -4011 | Not support the payment method |
