Token verkrijgen

Van toepassing op: een Token verkrijgen via de gehoste betaalpagina van YabandPay

De Hosted Payment Page (HPP) van YabandPay is een gebruiksklare betaalpagina die volledig door YabandPay wordt beheerd. Handelaren kunnen betalingen veilig accepteren doordat gevoelige PCI-gegevens op het systeem van YabandPay worden gehost. Het formulier kan als iframe of omleidingspagina in de checkout van de handelaar worden opgenomen.

Nadat de betaler een standaardcreditcardtransactie op de gehoste betaalpagina van YabandPay heeft voltooid en toestemming heeft gegeven, zet YabandPay de 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 betaal-URL. Nadat de gebruiker via die URL heeft betaald en toestemming heeft gegeven, 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 opnieuw een standaardcreditcardtransactie te starten om een Token te verkrijgen en daarna de betaling opnieuw te starten.

• Parameters

Signature example:

Gesorteerde parameters aaneengevoegd tot een queryreeks in URL-stijl

"3ds_initiate=01&amount=0.1&currency=EUR&description=test&email=JohnSmith@gmail.com&form_type=01&method=v3.CreateCardPayments&notify_url=https://www.yabandpay.com/notify&operation=11&order_id=1725875388&pay_method=online&request_id=dxktqiedfpkswnripi631ppg6fl2uoym&sub_pay_method=Cards HPP&time=1725875388&timeout=30&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": 1725875388,
    "data": {
        "3ds_initiate": "01",
        "description": "test",
        "timeout": "30",
        "pay_method": "online",
        "sub_pay_method": "Cards HPP",
        "operation": "11",
        "form_type": "01",
        "order_id": 1725875388,
        "amount": "0.1",
        "currency": "EUR",
        "email": "JohnSmith@gmail.com",
        "notify_url": "https://www.yabandpay.com/notify",
        "request_id": "dxktqiedfpkswnripi631ppg6fl2uoym"
    }
}

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: