API REFERENCE
EPS
EPS is an online transfer system jointly developed by Austrian banks and the government. It is a major bank transfer payment method in Austria and is popular with Austrian shoppers. Customers who select EPS at checkout are redirected to their bank's online banking page, where they authorize payment through the online banking interface using the bank's security protocols. Funds are transferred from their bank account, payment is processed in real time, and both customer and merchant receive immediate payment confirmation.
| Parameter | Type | Description | Required |
|---|---|---|---|
| user | String | Cashier account UID | Required |
| sign | String | Signature | Required |
| method | String | v3.CreatePayments | Required |
| time | Long | Timestamp | Required |
- Parameters
| Parameter | Type | Description | Required |
|---|---|---|---|
| pay_method | String | online | Required |
| sub_pay_method | String | EPS | Required |
| order_id | String | Merchant order ID | Required |
| amount | String | Numeric amount. For example, € 24.99 must be written as 24.99; euro amount>=1 | Required |
| currency | String | EUR | Required |
| description | String | Order description | Required |
| demo | String | Custom field | Optional |
| timeout | String | Expiration time in minutes (0-1440) | Required |
| redirect_url | String | Redirect URL after payment completion | Optional |
| notify_url | String | Asynchronous notification URL after payment completion | Required |
Signature example:
Sorted parameters concatenated into a URL-style query string
"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"
Sign stringA using secret_key
The resulting signature is:
"YOUR_SIGNATURE"
Request example:
{
"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"
}
}
Response example:
{
"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": ""
}
Additional information:
Response result:
-
A successful request returns "status": true.
-
A failed request returns "status": false.
We strongly recommend using both Query Order and Asynchronous Notifications to keep payment statuses accurate and up to date.
Response codes:
| 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 |
