Obtener token

Se aplica a: obtener un token mediante la página de pago alojada por YabandPay

La página de pago alojada (HPP) de YabandPay es una página lista para usar y mantenida íntegramente por YabandPay. Los comercios pueden aceptar pagos de forma segura alojando los datos PCI confidenciales en el sistema de YabandPay. El formulario puede integrarse en el flujo de pago como iframe o página de redirección.

After the payer completes a standard credit card transaction on the YabandPay hosted payment page and gives consent, YabandPay convierte los datos confidenciales del titular en una cadena aleatoria (un token) para eliminar la información identificativa. El token puede utilizarse para los siguientes pagos:

1. Los usuarios pueden pagar con un solo clic en la página de pago sin introducir los datos de la tarjeta de crédito.
2. Los comercios pueden utilizar este token para pagos recurrentes, cargos de suscripción y otros fines similares.

[!TIP|style:flat] Workflow

1. Active los pagos con token. Póngase en contacto con su gestor de cuenta para habilitar esta función.

2. Obtenga el consentimiento del usuario. Al habilitar pagos exprés (pagos con token) para consumidores, debe informarles claramente y obtener su consentimiento para evitar posibles disputas.

3. Obtener un token. Primero, inicie una transacción estándar con tarjeta de crédito. YabandPay devuelve una URL de pago. Cuando el usuario complete el pago mediante esa URL y dé su consentimiento, YabandPay devolverá el token en una notificación asíncrona utilizando el parámetro payment_token_object parameter.

4. Inicie un pago con token. Incluya el token en la payment_token_object variable. Si la validación del token es correcta, YabandPay procesa el pago con token. Si falla, YabandPay devuelve un error. En ese caso, recomendamos iniciar otra transacción estándar con tarjeta para obtener un token y volver a iniciar el pago.

• Parameters

Signature example:

Sorted parameters concatenated into a URL-style query string

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

The resulting signature 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"
}

Additional information:

MIT & CIT :

MIT = Merchant Initiated subsequent transactions. Token payments initiated by the merchant.

CIT = Cardholder Initiated Subsequent transactions. Token payments involving the customer. When activating payments, specify whether you need MIT or CIT so the appropriate mode can be configured.

Payment result:

1. A successful request returns "status": true.

2. A failed request returns "status": false.

Redirija al cliente a la url. After entering card details and completing payment at this url, the customer is redirected to redirect_url. Recomendamos encarecidamente utilizar tanto Consulta de pedido como Notificaciones asíncronas para mantener los estados de pago precisos y actualizados.

Returned Token:

1. After the customer grants authorization and the payment succeeds, YabandPay returns payment_token_object through an asynchronous notification.

2. If the customer does not grant authorization or does not complete payment, the asynchronous notification does not return payment_token_object.

3DS low-value exemption:

Transactions within the following limits may qualify as low-value transactions. If the order amount is less than or equal to the applicable amount below, transaction code 02 (low-value exemption) may be used with approval.

Response codes: