API REFERENCE

Gehostete Zahlungsseite

YabandPay documentation·Aktualisiert am 26. Okt. 2026

Für Kartenautorisierungen und Direktkäufe

Die Gehostete Zahlungsseite (HPP) von YabandPay ist eine sofort einsatzbereite, vollständig von YabandPay verwaltete Zahlungsseite. Händler können Zahlungen sicher annehmen, da sensible PCI-Daten im System von YabandPay verarbeitet werden. Das Formular kann als iFrame oder Weiterleitungsseite in den Bezahlvorgang des Händlers eingebunden werden.

Tipp

Authorizations are valid for 30 days. Authorization orders expire automatically after 30 days.

Parameter	Typ	Beschreibung	Erforderlich
user	String	Kassiererkonto UID	Erforderlich
sign	String	Signature	Erforderlich
method	String	v3.CreateCardPayments	Erforderlich
time	Long	Timestamp	Erforderlich

Parameter

Parameter	Typ	Beschreibung	Erforderlich
pay_method	String	online	Erforderlich
sub_pay_method	String	Karten-HPP	Erforderlich
operation	String	1.Sales 2.Authorisation；	Erforderlich
order_id	String	Händlerbestellnummer	Erforderlich
3ds_initiate	String	01. Enable 3DS verification; 02. Disable 3DS (requires activation approval); 03. SCA exemption (requires activation approval).	Erforderlich
sca_exemption	String	LowValue	Required when 3ds_initiate=03
amount	String	Betrag als numerische Zeichenfolge. Geben Sie beispielsweise 24.99 for € 24.99.	Erforderlich
currency	String	ISO 4217 Währungscode, zum Beispiel EUR oder CHF	Erforderlich
description	String	Bestellbeschreibung	Erforderlich
form_type	String	Type of returned url; defaults to 01. 01.completed, 02.iframe	Optional
email	string	E-Mail-Adresse des Karteninhabers	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
request_id	String	Eindeutige Einfrage-ID; empfohlen wird eine Kombination aus Ziffern und Buchstaben mit mindestens 24 Zeichen	Erforderlich

Signaturbeispiel:

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

"3ds_initiate=01&amount=1&currency=EUR&description=test&email=JohnSmith@gmail.com&form_type=01&method=v3.CreateCardPayments&notify_url=https://www.yabandpay.com/notify&operation=1&order_id=203040950640690239603690&pay_method=online&redirect_url=https://www.yabandpay.com/redirect_url&request_id=tscqf7ki76o7aem4z1yl1xs72f89fptl&sub_pay_method=Cards HPP&time=1720680417&timeout=0&user=YOUR_CASHIER_UID"

Sign stringA using secret_key

The resulting signature is:

"YOUR_SIGNATURE"

Einfragebeispiel:

{
    "user": "YOUR_CASHIER_UID",
    "sign": "YOUR_SIGNATURE",
    "method": "v3.CreateCardPayments",
    "time": 1720680417,
    "data": {
        "description": "test",
        "form_type": "01",
        "3ds_initiate": "01",
        "timeout": "0",
        "pay_method": "online",
        "sub_pay_method": "Cards HPP",
        "operation": "1",
        "order_id": "YOUR_ORDER_ID",
        "amount": "1",
        "currency": "EUR",
        "email": "JohnSmith@gmail.com",
        "redirect_url": "https://www.yabandpay.com/redirect_url",
        "notify_url": "https://www.yabandpay.com/notify",
        "request_id": "tscqf7ki76o7aem4z1yl1xs72f89fptl"
    }
}

Eintwortbeispiel:

{
    "status": true,
    "code": "200",
    "data": {
        "order_id": "YOUR_ORDER_ID",
        "trade_id": "160899f3-f6d9-a8d8-ab5b-82eacdab9c5b",
        "amount": "1.00",
        "currency": "EUR",
        "url": "https://pay.yabandpay.com/payments/callback/order/MTYwODk5ZjMtZjZkOS1hOGQ4LWFiNWItODJlYWNkYWI5YzVi",
        "state": "processing"
    },
    "message": "",
    "response_id": "202407111544200649155078"
}

Zusätzliche Informationen:

Eintwortergebnis:

Eine erfolgreiche Einfrage gibt "status": true.
Eine fehlgeschlagene Einfrage gibt "status": false.

Redirect the customer to the returned url. After entering card details and completing payment there, the customer is redirected to redirect_url. Wir empfehlen dringend, sowohl Bestellabfrage and Asynchrone Benachrichtigungen zu verwenden, damit die Zahlungsstatus korrekt und aktuell bleiben. a) Ein order state of paid indicates a successful payment. b) Ein order state of authorized indicates a successful Autorisierung. To capture an authorized payment, call the Capture Authorization API.

Eintwortcodes:

Status	Code	Message
true	200
false	-1000	Internal error
false	-403	The signature Error
false	-2001	The user not exist
false	-3001	Required field is missing
false	-4118	Incorrect request ID

Gehostete Zahlungsseite