API REFERENCE
EPS
EPS is een online overschrijvingssysteem dat gezamenlijk is ontwikkeld door Oostenrijkse banken en de overheid. Het is een belangrijke betaalmethode via bankoverschrijving in Oostenrijk en is populair bij Oostenrijkse consumenten. Klanten die bij het afrekenen EPS kiezen, worden doorgestuurd naar de onlinebankieromgeving van hun bank. Daar autoriseren zij de betaling met de beveiligingsprotocollen van de bank. Het geld wordt van hun bankrekening overgemaakt, de betaling wordt in realtime verwerkt en zowel de klant als de handelaar ontvangt onmiddellijk een betalingsbevestiging.
API-URL:https://mapi.yabandpay.com/Payments
Methode:POST
POST gegevenstype:Json
| Parameter | Type | Beschrijving | Verplicht |
|---|---|---|---|
| user | String | Kassiersaccount UID | Verplicht |
| sign | String | Signature | Verplicht |
| method | String | v3.CreatePayments | Verplicht |
| time | Long | Timestamp | Verplicht |
- Parameters
| Parameter | Type | Beschrijving | Verplicht |
|---|---|---|---|
| pay_method | String | online | Verplicht |
| sub_pay_method | String | EPS | Verplicht |
| order_id | String | Bestel-ID van de handelaar | Verplicht |
| amount | String | Numeriek bedrag. Schrijf bijvoorbeeld € 24.99 als 24.99; het eurobedrag moet >=1 zijn | Verplicht |
| currency | String | EUR | Verplicht |
| description | String | Bestelomschrijving | Verplicht |
| demo | String | Aangepast veld | Optioneel |
| timeout | String | Vervaltijd in minuten (0-1440) | Verplicht |
| redirect_url | String | Omleidings-URL na afronding van de betaling | Optioneel |
| notify_url | String | URL voor asynchrone melding na afronding van de betaling | Verplicht |
Handtekeningvoorbeeld:
Gesorteerde parameters aaneengevoegd tot een queryreeks in URL-stijl
"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"
Onderteken stringA met secret_key
De resulterende handtekening is:
"YOUR_SIGNATURE"
Aanvraagvoorbeeld:
{
"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"
}
}
Antwoordvoorbeeld:
{
"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": ""
}
Aanvullende informatie:
Resultaat van het antwoord:
-
Een geslaagde aanvraag retourneert "status": true.
-
Een mislukte aanvraag retourneert "status": false.
We raden sterk aan zowel Bestelling opvragen als Asynchrone meldingen te gebruiken om de betalingsstatussen actueel en nauwkeurig te houden.
Antwoordcodes:
| Status | Code | Bericht |
|---|---|---|
| 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 |
