API REFERENCE
Bank Transfer
Applies to: user bank transfers
Paybybank is a secure bank transfer payment method offered by YabandPay. Customers pay by transferring funds directly from their bank accounts to YabandPay's designated account.
This solution is ideal for merchants seeking lower costs and reliable transactions without relying on card networks. Once the transfer is received, YabandPay automatically verifies the payment and updates the transaction status, ensuring a smooth payment experience for merchants and customers.
Tip
Paybybank only supports transfers through the SEPA (Single Euro Payments Area) network. SWIFT transfers are not accepted.
| Parameter | Type | Description | Required |
|---|---|---|---|
| user | String | Cashier account UID | Required |
| sign | String | Signature | Required |
| method | String | v3.BankTransfer | Required |
| time | Long | Timestamp | Required |
- Parameters
| Parameter | Type | Description | Required |
|---|---|---|---|
| request_id | String | Unique request ID; a combination of digits and letters at least 24 characters is recommended | Required |
| pay_method | String | online | Required |
| sub_pay_method | String | Bank Transfer | 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 |
| String | User email address | Optional | |
| demo | String | Custom field | Optional |
| timeout | String | Expiration time in minutes (0-1440) | Required |
| redirect_url | String | Redirect URL after payment | Optional |
| notify_url | String | Asynchronous notification URL after payment | Required |
Signature example:
Sorted parameters concatenated into a URL-style query string
"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"
Sign stringA using secret_key
The resulting signature is:
"YOUR_SIGNATURE"
Request example:
{
"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"
}
}
Response example:
{
"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"
}
Additional information:
Response result:
-
A successful request returns "status": true.
-
A failed request returns "status": false.
We recommend using Asynchronous Notifications to update the payment status and keep payment information accurate in real time.
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 |
