API REFERENCE
Bizum
Bizum ist eine in Spanien weit verbreitete mobile Zahlungslösung für Sofortüberweisungen zwischen Privatpersonen und Unternehmen per Mobiltelefonnummer. Händlern bietet Bizum eine schnelle, sichere und benutzerfreundliche Möglichkeit, Zahlungen online und in Geschäften anzunehmen. Es lässt sich direkt in die Website, App oder das Kassensystem (POS) eines Unternehmens integrieren. Kunden geben einfach ihre Mobiltelefonnummer ein oder scannen zum Bezahlen einen QR-Code. Transaktionen werden in Echtzeit abgewickelt. Kunden müssen Zahlungen in ihrer Mobile-Banking-App auaufrisieren. Dies gewährleistet ein hohes Maß an Sicherheit und die Einhaltung der überarbeiteten Zahlungsdiensterichtlinie (PSD2). Die meisten großen spanischen Banken unterstützen Bizum. Der Dienst hat mehr als 25 Millionen Nutzer und bietet Händlern daher drei wesentliche Vorteile: mehr Kunden zu erreichen, Kaufabbrüche zu verringern und das Rückbuchungsrisiko auszuschließen.
| Parameter | Typ | Beschreibung | Erforderlich |
|---|---|---|---|
| user | String | Kassiererkonauf UID | Erforderlich |
| sign | String | Signature | Erforderlich |
| method | String | v3.CreatePayments | Erforderlich |
| time | Long | Timestamp | Erforderlich |
- Parameter
| Parameter | Typ | Beschreibung | Erforderlich |
|---|---|---|---|
| pay_method | String | online | Erforderlich |
| sub_pay_method | String | Bizum | Erforderlich |
| order_id | String | Händlerbestellnummer | Erforderlich |
| amount | String | Numerischer Betrag. Zum Beispiel € 24.99 muss angegeben werden als 24.99; Euro-Betrag >=1 | Erforderlich |
| currency | String | EUR | Erforderlich |
| description | String | Bestellbeschreibung | Erforderlich |
| demo | String | Benutzerdefiniertes Feld | Optional |
| timeout | String | Ablaufzeit in Minuten (0-1440) | Erforderlich |
| redirect_url | String | Weiterleitungs-URL nach der Zahlung | Optional |
| notify_url | String | URL für asynchrone Benachrichtigung nach der Zahlung | Erforderlich |
Signaturbeispiel:
Nach Parametern sortierte Werte, verkettet zu einer URL-ähnlichen Abfragezeichenfolge
"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"
Signieren Sie die Zeichenfolge A mit secret_key
Die resultierende Signatur lautet:
"YOUR_SIGNATURE"
Anfragebeispiel:
{
"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"
}
}
Antwortbeispiel:
{
"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": ""
}
Zusätzliche Informationen:
Antwortergebnis:
-
Eine erfolgreiche Anfrage gibt "status": true.
-
Eine fehlgeschlagene Anfrage gibt "status": false.
Wir empfehlen dringend, sowohl Bestellabfrage und Asynchrone Benachrichtigungen um Zahlungsstatus korrekt und aktuell zu halten.
Antwortcodes:
| 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 |
