Dokumentation/API-Referenz

API REFERENCE

Bizum

POSThttps://mapi.yabandpay.com/Payments
Live API
API PLAYGROUND · Live API

Bizum

POSThttps://mapi.yabandpay.com/Payments
Automatically signed with your credentials

Request parameters9

Required fields first

介绍

pay_methodRequiredstringdata.pay_methodonline
sub_pay_methodRequiredstringdata.sub_pay_methodBizum
amountRequiredstringdata.amount金额数字。例如 € 24.99 应该写成24.99,欧元金额>=1
currencyRequiredstringdata.currencyEUR
descriptionRequiredstringdata.description订单描述
timeoutRequiredstringdata.timeout过期时间单位分钟(0-1440)
notify_urlRequiredstringdata.notify_url支付完成后异步通知地址
Optional parameters 2
demoOptionalstringdata.demo自定义字段
redirect_urlOptionalstringdata.redirect_url支付完成后跳转地址

Credentials stay on this page. Your secret key is never stored or sent to the documentation server.

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.


ParameterTypBeschreibungErforderlich
userStringKassiererkonauf UIDErforderlich
signStringSignatureErforderlich
methodStringv3.CreatePaymentsErforderlich
timeLongTimestampErforderlich
  • Parameter
ParameterTypBeschreibungErforderlich
pay_methodStringonlineErforderlich
sub_pay_methodStringBizumErforderlich
order_idStringHändlerbestellnummerErforderlich
amountStringNumerischer Betrag. Zum Beispiel € 24.99 muss angegeben werden als 24.99; Euro-Betrag >=1Erforderlich
currencyStringEURErforderlich
descriptionStringBestellbeschreibungErforderlich
demoStringBenutzerdefiniertes FeldOptional
timeoutStringAblaufzeit in Minuten (0-1440)Erforderlich
redirect_urlStringWeiterleitungs-URL nach der ZahlungOptional
notify_urlStringURL für asynchrone Benachrichtigung nach der ZahlungErforderlich

Signaturbeispiel:

Nach Parametern sortierte Werte, verkettet zu einer URL-ähnlichen Abfragezeichenfolge

"amount=1&currency=EUR&demo=test&description=YabandPay test&method=v3.CreatePayments&notify_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:
  1. Eine erfolgreiche Anfrage gibt "status": true.

  2. Eine fehlgeschlagene Anfrage gibt "status": false.

Wir empfehlen dringend, sowohl Bestellabfrage und Asynchrone Benachrichtigungen um Zahlungsstatus korrekt und aktuell zu halten.

Antwortcodes:
StatusCodeMessage
true200Success
false-1000Internal error
false-3001Required field is missing
false-403The signature Error
false-4011Not support the payment method