API REFERENCE

Autorisatie incasseren

YabandPay documentation·Bijgewerkt op 26 okt 2026

Van toepassing op: incasseren na autorisatie

Incasseer de bestelling nadat de autorisatie is geslaagd. De incasso moet binnen 30 dagen na voltooiing van de autorisatie plaatsvinden; anders verloopt de autorisatie automatisch.

De valuta van de incasso moet overeenkomen met de autorisatievaluta en het bedrag mag het oorspronkelijk geautoriseerde bedrag niet overschrijden.

Per geautoriseerde transactie is slechts één incasso toegestaan. Meerdere incasso’s worden niet ondersteund.

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.Capture	Verplicht
time	Long	Timestamp	Verplicht

Parameters

Parameter	Type	Beschrijving	Verplicht
trade_id	String	trade_id van de autorisatie	Verplicht
amount	String	Bedrag als numerieke tekenreeks. Voer bijvoorbeeld 24.99 in voor € 24.99.	Verplicht
currency	String	ISO-valutacode 4217, bijvoorbeeld EUR of CHF	Verplicht
description	String	Bestelomschrijving	Verplicht
notify_url	String	URL voor asynchrone melding na betaling	Verplicht
request_id	String	Unieke aanvraag-ID; aanbevolen wordt een combinatie van cijfers en letters van ten minste 24 tekens	Verplicht

Handtekeningvoorbeeld:

Gesorteerde parameters aaneengevoegd tot een queryreeks in URL-stijl

"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"

Onderteken stringA met secret_key

De resulterende handtekening is:

"YOUR_SIGNATURE"

Aanvraagvoorbeeld:

{
    "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"
    }
}

Antwoordvoorbeeld:

{
    "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"
}

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
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

Autorisatie incasseren