API REFERENCE
EPS
EPS ist ein von österreichischen Banken und der Regierung gemeinsam entwickeltes Online-Überweisungssystem. Es ist eine wichtige Zahlungsmethode per Banküberweisung in Österreich und bei österreichischen Kunden beliebt. Kunden, die beim Bezahlvorgang EPS auswählen, werden zum Online-Banking ihrer Bank weitergeleitet und auaufrisieren die Zahlung dort gemäß den Sicherheitsverfahren ihrer Bank. Das Geld wird von ihrem Bankkonauf überwiesen, die Zahlung in Echtzeit verarbeitet und sowohl Kunde als auch Händler erhalten sofort eine Zahlungsbestätigung.
| Parameter | Typ | Beschreibung | Erforderlich |
|---|---|---|---|
| user | String | Kassiererkonauf UID | Erforderlich |
| sign | String | Signature | Erforderlich |
| method | String | v3.CreatePayments | Erforderlich |
| time | Long | Timestamp | Erforderlich |
- Parameter
| Parameter | Typ | Beschreibung | Erforderlich |
|---|---|---|---|
| pay_method | String | online | Erforderlich |
| sub_pay_method | String | EPS | 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 |
| demo | String | Benutzerdefiniertes Feld | Optional |
| timeout | String | Ablaufzeit in Minuten (0-1440) | Erforderlich |
| redirect_url | String | Weiterleitungs-URL nach Zahlungsabschluss | Optional |
| notify_url | String | URL für asynchrone Benachrichtigung nach Zahlungsabschluss | Erforderlich |
Signaturbeispiel:
Nach Parametern sortierte Werte, verkettet zu einer URL-ähnlichen Abfragezeichenfolge
"amount=1¤cy=EUR&demo=test&description=YabandPay test&method=v3.CreatePayments¬ify_url=https://www.yabandpay.com/notify&order_id=202508271641&pay_method=online&redirect_url=https://www.yabandpay.com&sub_pay_method=EPS&time=1646388458&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",
"sign": "YOUR_SIGNATURE",
"method": "v3.CreatePayments",
"time": 1646388458,
"data": {
"description": "YabandPay test",
"timeout":"0",
"pay_method": "online",
"sub_pay_method": "EPS",
"order_id": "YOUR_ORDER_ID",
"amount": "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": "c9a8217a-69d2-8338-c065-d24947aabd5a",
"amount": "1.00",
"currency": "EUR",
"url": "https://pay.yabandpay.com/pay_method/ZXBz/YzlhODIxN2EtNjlkMi04MzM4LWMwNjUtZDI0OTQ3YWFiZDVh",
"state": "processing"
},
"message": ""
}
Zusätzliche Informationen:
Antwortergebnis:
-
Eine erfolgreiche Anfrage gibt "status": true.
-
Eine fehlgeschlagene Anfrage gibt "status": false.
Wir empfehlen dringend, sowohl Bestellabfrage und Asynchrone Benachrichtigungen um Zahlungsstatus korrekt und aktuell 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 |
