Formulario de Tokenización

El formulario de tokenización es una herramienta útíl cuando es necesario capturar de forma segura la información de tarjeta de los compradores para procesar el pago. En lugar de almacenar directamente los datos de la tarjeta, este formulario genera un token que puede enviarse al servidor del comercio para completar el proceso de compra.

Importando el JavaScript

Para integrar el Formulario de Tokenización, es necesario incluir un script que apunte a la URL del formulario. Esto permite acceder al objeto BambooForm que contiene los métodos necesarios para renderizar los formularios de Bamboo.

//STAGE - Ambiente de Pruebas:
<script src="https://capture.stage.bamboopayment.com"></script>

//PRODUCCIÓN:
<script src="https://capture.bamboopayment.com"></script>

Método renderTokenizationForm

Una vez importado el Script que apunta a los formularios de Bamboo, se puede invocar el método renderTokenizationForm que renderiza el Formulario de Tokenización, permitiendo a los compradores ingresar sus tarjetas de manera segura.

BambooForm.renderTokenizationForm(configuration);

Ejemplo de Solicitud

<script> 
BambooForm.renderTokenizationForm({
  containerId: 'MERCHANT_PAGE_CONTAINER_ID',
  metadata: {
    publicKey: 'MERCHANT_PUBLIC_KEY',
    targetCountryISO: 'UY',
    customer: {
      email: 'cliente@example.com',
      cardHolderName: 'Juan Pérez'
    },
    locale: 'es',
    logoUrl: '<https://mieshop.com/logo.png>'
  },
  hooks: {
    onOperationSuccess: (token) => {
      console.log('Token recibido:', token);
    },
    onOperationError: (error) => {
      console.error('Error:', error);
    }
  }
});
</script>

Parámetros de Configuración

Personalice su Formulario de Tokenización | objeto metadata

Puede personalizar el formulario de tokenización con su logo e idioma preferido, además de pre-llenar datos ya proporcionados por el comprador, o restringir la tokenización a tarjetas específicas.

Información del Cliente

Tokenización restringida a Tarjetas específicas

Gestione la interacción de su cliente | objeto hooks

Tokenización exitosa | objeto Token

El objeto token se devuelve en el hook onOperationSuccess ejecutado al completar exitosamente la tokenización y contiene los siguientes parámetros.

Formulario CVV

El Formulario CVV está diseñado específicamente para capturar el código de verificación de la tarjeta (CVV), que se encuentra en el reverso de la tarjeta física. Este formulario se utiliza cuando se requiere validar una transacción con el CVV, generalmente en pagos recurrentes o en compras en las que la información de la tarjeta ya ha sido previamente tokenizada. Uso típico: Cuando un cliente ha almacenado previamente su tarjeta de crédito a través del proceso de tokenización, pero se le solicita que ingrese su CVV para validar o completar una transacción, proporcionando una capa adicional de seguridad.

Método renderCVVForm

Una vez importado el Script que apunta a los formularios de Bamboo, tendrás acceso al método renderCVVForm que renderiza un formulario dedicado exclusivamente a la captura del CVV del cliente.

BambooForm.renderCVVForm(url, configurationCVV);

Parámetros de configuración

Ejemplo de uso

<script>
BambooForm.renderCVVForm(
  '<https://api.stage.bamboopayment.com/v1/Capture/?key=FEdJ84hzdIKBY0gyC7-NDG_I56ONV7HQ&session_id=CA_51864eaf-1603-4fe8-8720-ae8c569ea702&paymentProfileId=375108&brand=MasterCard&lastFour=4008>',
  {
    metadata: {
      locale: 'es',
      logoUrl: '<http://www.example.com/>'
    },
    hooks: {
       onOperationSuccess: () => {
        console.log('Operation successful');
      },
      onOperationError: (error) => {
        console.error('Error in CVV validation:', error);
      }
    }
  }
);
</script>

Última modificación 28 de noviembre de 2024

© Bamboo | All rights reserved 2024