API REFERENCE

Autorisierung einziehen

YabandPay documentation·Aktualisiert am 26. Okt. 2026

Gilt für: Einzug nach der Autorisierung

Ziehen Sie den Betrag nach erfolgreicher Autorisierung ein. Der Einzug muss innerhalb von 30 Tagen nach Abschluss der Autorisierung erfolgen. Andernfalls läuft die Autorisierung automatisch ab.

Die Einzugswährung muss mit der Autorisierungswährung übereinstimmen. Der Betrag darf den ursprünglich autorisierten Betrag nicht überschreiten.

Für jede autorisierte Transaktion ist nur ein Einzug zulässig. Mehrere Einzüge werden nicht unterstützt.

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

Parameter

Parameter	Typ	Beschreibung	Erforderlich
trade_id	String	trade_id of the Autorisierung	Erforderlich
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
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

"amount=1&currency=EUR&description=test&method=v3.Capture&notify_url=https://www.yabandpay.com/notify&request_id=ca51f2fas3i0f8uiw7efj6oe4i2w1ghj&time=1720684254&trade_id=160899f3-f6d9-a8d8-ab5b-82eacdab9c5b&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.Capture",
    "time": 1720684254,
    "data": {
        "description": "test",
        "trade_id": "160899f3-f6d9-a8d8-ab5b-82eacdab9c5b",
        "amount": "1",
        "currency": "EUR",
        "notify_url": "https://www.yabandpay.com/notify",
        "request_id": "ca51f2fas3i0f8uiw7efj6oe4i2w1ghj"
    }
}

Eintwortbeispiel:

{
    "status": true,
    "code": "200",
    "data": {
        "order_id": "YOUR_ORDER_ID",
        "trade_id": "160899f3-f6d9-a8d8-ab5b-82eacdab9c5b",
        "amount": "1",
        "currency": "EUR",
        "state": "paid"},
    "message": "",
    "response_id": "202407111550570060848432"
}

Zusätzliche Informationen:

Eintwortergebnis:

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

Wir empfehlen dringend, sowohl Bestellabfrage and Asynchrone Benachrichtigungen zu verwenden, damit die Zahlungsstatus korrekt und aktuell bleiben.

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
false	-4089	Exceed capture window
false	-4084	The captured amount exceeds the original authorized amount
false	-4085	The captured currency is different from the original authorization currency
false	-4024	The original trade ID is incorrect

Autorisierung einziehen