API REFERENCE
Bankoverschrijving
Van toepassing op: bankoverschrijvingen door gebruikers
Paybybank is een veilige betaalmethode via bankoverschrijving van YabandPay. Klanten betalen door geld rechtstreeks van hun bankrekening over te maken naar de aangewezen rekening van YabandPay.
Deze oplossing is ideaal voor handelaren die lagere kosten en betrouwbare transacties willen zonder afhankelijk te zijn van kaartnetwerken. Zodra de overschrijving is ontvangen, verifieert YabandPay de betaling automatisch en werkt het de transactiestatus bij, zodat zowel handelaren als klanten soepel kunnen betalen.
Tip
Paybybank ondersteunt alleen overschrijvingen via het SEPA-netwerk (Single Euro Payments Area). SWIFT-overschrijvingen worden niet geaccepteerd.
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.BankTransfer | Verplicht |
| time | Long | Timestamp | Verplicht |
- Parameters
| Parameter | Type | Beschrijving | Verplicht |
|---|---|---|---|
| request_id | String | Unieke aanvraag-ID; aanbevolen wordt een combinatie van cijfers en letters van ten minste 24 tekens | Verplicht |
| pay_method | String | online | Verplicht |
| sub_pay_method | String | Bankoverschrijving | 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 |
| String | E-mailadres van de gebruiker | Optioneel | |
| demo | String | Aangepast veld | Optioneel |
| timeout | String | Vervaltijd in minuten (0-1440) | Verplicht |
| redirect_url | String | Omleidings-URL na betaling | Optioneel |
| notify_url | String | URL voor asynchrone melding na betaling | Verplicht |
Handtekeningvoorbeeld:
Gesorteerde parameters aaneengevoegd tot een queryreeks in URL-stijl
"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"
Onderteken stringA met secret_key
De resulterende handtekening is:
"YOUR_SIGNATURE"
Aanvraagvoorbeeld:
{
"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"
}
}
Antwoordvoorbeeld:
{
"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"
}
Aanvullende informatie:
Resultaat van het antwoord:
-
Een geslaagde aanvraag retourneert "status": true.
-
Een mislukte aanvraag retourneert "status": false.
We raden aan Asynchrone meldingen te gebruiken om de betalingsstatus bij te werken en de betalingsinformatie in realtime actueel 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 |
