Token verkrijgen (directe integratie)

Van toepassing op: PCI DSS-gecertificeerde handelaren en instellingen

Gebruik deze API om een volledige betaling uit te voeren (3DS-verificatie is verplicht). YabandPay zet gevoelige kaarthoudergegevens om in een willekeurige tekenreeks (een Token), zodat de gegevens niet meer naar de kaarthouder te herleiden zijn. Het Token kan voor de volgende betalingen worden gebruikt:

1. Klanten kunnen met één klik op de checkoutpagina betalen zonder creditcardgegevens in te voeren.
2. Handelaren kunnen het Token gebruiken voor terugkerende betalingen, abonnementskosten en vergelijkbare doeleinden.

[!TIP|style:flat] Workflow

1. Schakel Token-betalingen in. Neem contact op met uw accountmanager om de Token-betaalfunctie te activeren.

2. Verkrijg toestemming van de gebruiker. Wanneer u expressbetalingen (Token-betalingen) voor consumenten inschakelt, moet u gebruikers duidelijk informeren en hun toestemming verkrijgen om mogelijke geschillen te voorkomen.

3. Verkrijg een Token. Start eerst een standaardcreditcardtransactie. YabandPay retourneert een URL. Nadat de gebruiker via die URL de 3DS-verificatie heeft voltooid, retourneert YabandPay het Token in een asynchrone melding met de payment_token_object parameter.

4. Start een Token-betaling. Neem het Token op in de payment_token_object variabele. Als de Token-validatie slaagt, verwerkt YabandPay de betaling. Als de validatie mislukt, retourneert YabandPay een fout. In dat geval raden we aan deze transactiestroom opnieuw te doorlopen om een Token te verkrijgen en vervolgens de betaling opnieuw te starten.

• Parameters

Signature example:

Gesorteerde parameters aaneengevoegd tot een queryreeks in URL-stijl

"3ds_initiate=01&amount=0.1&cardinfo={"card_holder":"John Smith","email":"JohnSmith@gmail.com","card_number":"4356789012345670","expiration_month":"01","expiration_year":"2023","cvc":"123"}&currency=EUR&description=test&method=v3.CreateCardPayments&notify_url=https://www.yabandpay.com/notify&operation=11&order_id=1756878556&pay_method=online&redirect_url=https://www.yabandpay.com/redirect_url&request_id=a7z1lox4l6z6mdx1udgn5gtezasze1x0&sca_exemption=LowValue&sub_pay_method=Card&time=1756878556&timeout=0&user=YOUR_CASHIER_UID"

Sign stringA met secret_key

De resulterende handtekening is:

"YOUR_SIGNATURE"

Request example:

{
	"user": "YOUR_CASHIER_UID",
	"sign": "YOUR_SIGNATURE",
	"method": "v3.CreateCardPayments",
	"time": 1756878556,
	"data": {
		"description": "test",
		"3ds_initiate": "01",
		"timeout": "0",
		"pay_method": "online",
		"sub_pay_method": "Card",
		"operation": "11",
		"order_id": 1756878556,
		"cardinfo": "{\"card_holder\":\"John Smith\",\"card_number\":\"4356789012345670\",\"expiration_month\":\"01\",\"expiration_year\":\"2023\",\"cvc\":\"123\"}",
		"sca_exemption": "LowValue",
		"amount": "0.1",
		"currency": "EUR",
		"email": "JohnSmith@gmail.com",
        "redirect_url": "https://www.yabandpay.com/redirect_url",
        "notify_url": "https://www.yabandpay.com/notify",
		"request_id": "a7z1lox4l6z6mdx1udgn5gtezasze1x0"
	}
}

Response example:

{
    "status": true,
    "code": "200",
    "data": {
        "order_id": "YOUR_ORDER_ID",
        "trade_id": "2b2aa1af-6e97-4c01-8c52-86200bf66c82",
        "amount": "0.1",
        "currency": "EUR",
        "url": "https://pay.yabandpay.com/pay_method/Y3JlZGl0Y2FyZA==/MmIyYWExYWYtNmU5Ny00YzAxLThjNTItODYyMDBiZjY2Yzgy",
        "state": "processing"
    },
    "message": "",
    "response_id": "202409091749500451314672"
}

Aanvullende informatie:

MIT & CIT :

MIT = Merchant Initiated subsequent transactions. Token-betalingen die door de handelaar worden gestart.

CIT = Cardholder Initiated Subsequent transactions. Token-betalingen waarbij de klant betrokken is. Geef bij het activeren van betalingen aan of u MIT of CIT nodig hebt, zodat de juiste modus kan worden ingesteld.

Payment result:

1. Een geslaagde aanvraag retourneert "status": true.

2. Een mislukte aanvraag retourneert "status": false.

Stuur de klant door naar de geretourneerde url. Nadat de klant daar de kaartgegevens heeft ingevoerd en de betaling heeft voltooid, wordt deze doorgestuurd naar url, de klant wordt doorgestuurd naar redirect_url. We raden sterk aan zowel Query Order and Asynchronous Notifications te gebruiken om de betalingsstatussen actueel en nauwkeurig te houden.

Returned Token:

1. Nadat de klant toestemming heeft gegeven en de betaling is geslaagd, retourneert YabandPay payment_token_object via een asynchrone melding.

2. Als de klant geen toestemming geeft of de betaling niet voltooit, retourneert de asynchrone melding geen payment_token_object.

3DS low-value exemption:

Transacties tot de onderstaande limieten komen mogelijk in aanmerking als transactie met een laag bedrag. Als het bestelbedrag niet hoger is dan het toepasselijke bedrag hieronder, mag transactiecode 02 (vrijstelling voor lage bedragen) met goedkeuring worden gebruikt.

Response codes: