API REFERENCE
Bizum
Bizum is een veelgebruikte mobiele betaaloplossing in Spanje voor directe overboekingen tussen consumenten en bedrijven via mobiele telefoonnummers. Voor handelaren biedt Bizum een snelle, veilige en gebruiksvriendelijke manier om online en in fysieke winkels betalingen te accepteren. De betaalmethode kan rechtstreeks worden geïntegreerd in de website, applicatie (APP) of het kassasysteem (POS) van een bedrijf. Consumenten voeren eenvoudig hun mobiele telefoonnummer in of scannen een QR-code om te betalen. Transacties worden in realtime verwerkt. Consumenten moeten betalingen autoriseren via de mobiele bankapp, wat zorgt voor een hoog beveiligingsniveau en naleving van de herziene richtlijn betalingsdiensten (PSD2). De meeste grote Spaanse banken ondersteunen Bizum. De dienst heeft meer dan 25 miljoen gebruikers en biedt handelaren daarom drie belangrijke voordelen: meer klanten bereiken, minder verlaten winkelwagens en geen risico op terugboekingen.
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 | Bizum | 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 betaling | Optioneel |
| notify_url | String | URL voor asynchrone melding na 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=20240726785412369&pay_method=online&redirect_url=https://www.yabandpay.com&sub_pay_method=Bizum&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": "Bizum",
"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": "6ff1026e-e4e9-f6c9-d275-3323594064e0",
"amount": "1.00",
"currency": "EUR",
"url": "https://pay.yabandpay.com/pay_method/Yml6dW0=/NmZmMTAyNmUtZTRlOS1mNmM5LWQyNzUtMzMyMzU5NDA2NGUw",
"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 |
