Solicitar token de Pago V2

Conceptos Generales

El token de pago es un identificador único que representa los datos de la tarjeta del cliente. Este token debe enviarse a tu backend para realizar la transacción de manera segura.

En esta guía, detallamos el paso a paso para obtener el token y generar un pago con tarjeta desde tu backend. Para ello, debes solicitar el token de pago con nuestro SDK en tu frontend y luego enviarlo a tu backend, siguiendo las instrucciones de estos ENDPOINTS

Los pasos para generar el token de la tarjeta son:

  • Generar una PUBLIC API KEY en el panel de Pagos Online (https://app.zenrise.io/me?tab=devs)
  • Importamos el SDK
  • Instanciamos el SDK con la API KEY previamente generada
  • Tokenizamos los datos de la tarjeta del cliente
  • Realizamos la transacción con el token de pago: Ver

Importamos el SDK

En su código html puede importar la ultima versión de nuestro SDK de la siguiente forma

<script src="https://cdn.zenrise.io/libraries/js/sdk/zenrise-sdk-v2.2.0.js" charset="utf-8"></script>

Instanciamos el SDK

Para usar el SDK, debe instanciarlo con la api key generada en el panel de Pagos Online. Cabe destacar que si la api key fue generada en el entorno de producción, el SDK se configurará automáticamente para trabajar en producción, de lo contrario, se configurará para trabajar en el entorno de desarrollo.

const zenrise = new Zenrise.SdkV2('pk_{enviroment}_{publickey}');

Tokenizar Datos de Tarjeta

Para tokenizar los datos de la tarjeta del cliente, debe llamar al método getCardToken() y pasarle los datos correspondientes. A continuación, se muestra la estructura de datos requerida por el método:

function getCardData() {
const holderId = {
type: "dni",
number: "31658703"
}
return {
card_number: "4507000000000000",
card_expiration_month: "08",
card_expiration_year: "22",
security_code: "123",
card_holder_name: "Esteban Mesa",
card_holder_identification: holderId
}
}

Nota: Si está utilizando la tokenización para generar suscripciones, el campo security_code no es necesario y no debe ser enviado.

Una vez que haya construido los datos de la tarjeta, llame al método para generar el token de pago especificando el tipo de pago:

function getCardToken(type: "pago-unico" | "suscripcion" | "ahora-12" = "pago-unico") {
const paymentToken = await zenrise.getCardToken(getCardData(), type);
return paymentToken;
}

El objeto payment token es el que deberá ser enviado a su backend y esta compuesto de la siguiente forma

{
"token": "card_14d90286f3154ebf8763c3f2...",
"bin": "450000",
"lastFourDigits": "0000",
"fingerPrintId": "14d90286-f315-4ebf-..."
}

Importante!

Este token de pago es único por transacción por lo tanto cada vez que quiera hacer una transacción por mas que sea un re intento deberá volver a solicitarlo.