API REFERENCE

Autorisatie verlagen

YabandPay documentation·Bijgewerkt op 26 okt 2026

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

Parameters

Parameter	Type	Beschrijving	Verplicht
trade_id	String	trade_id van de te verlagen autorisatie	Verplicht
amount	String	Numeriek bedrag. € 24.99 moet bijvoorbeeld worden geschreven als 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 voltooiing van de betaling	Verplicht
request_id	String	Unieke aanvraag-ID; minimaal 24 alfanumerieke tekens worden aanbevolen	Verplicht

Handtekeningvoorbeeld:

Gesorteerde parameters aaneengevoegd tot een queryreeks in URL-stijl

"amount=0.1&currency=EUR&description=test&method=v3.PreauthDecrement&notify_url=https://www.yabandpay.com/notify&request_id=skc5vtsovtetqe09us0jdrqm1vjdeaki&time=1774246236&trade_id=9222e0e1-6ef5-639f-3692-90f1e2a33e68&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.PreauthDecrement",
    "time": 1774246236,
    "data": {
        "description": "test",
        "trade_id": "9222e0e1-6ef5-639f-3692-90f1e2a33e68",
        "amount": "0.1",
        "currency": "EUR",
        "notify_url": "https://www.yabandpay.com/notify",
        "request_id": "skc5vtsovtetqe09us0jdrqm1vjdeaki"
    }
}

Antwoordvoorbeeld:

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

Aanvullende informatie:

Resultaat van het antwoord:

Een geslaagde aanvraag retourneert "status": true.
Een mislukte aanvraag retourneert "status": false.

Deze API verlaagt het autorisatiebedrag. Het resultaat wordt synchroon geretourneerd. De verlaging mag het geautoriseerde bedrag niet overschrijden.

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	-4024	The original trade ID is incorrect

Autorisatie verlagen

Autorisatie verlagen

Request parameters6

减少预授权

Handtekeningvoorbeeld:

Aanvraagvoorbeeld:

Antwoordvoorbeeld:

Aanvullende informatie:

Resultaat van het antwoord:

Antwoordcodes: