Cómo funciona
El proceso consta de los siguientes pasos clave:- Recopilación de información de la tarjeta: La información de la tarjeta se recopila de forma segura a través de un formulario dentro de tu aplicación y luego se transmite a la API de Localpayment.
- Generación de tokens: Localpayment almacena de forma segura la información de la tarjeta y genera un token único e irreversible que representa los datos de la misma. Este token se devuelve en la respuesta de la API.
- Uso de la tarjeta tokenizada: Para los pagos posteriores con tarjeta, enviarás la propiedad
card.tokenen lugar de los datos reales de la tarjeta del cliente.
Antes de comenzar
Antes de tokenizar una tarjeta, asegúrate de haber completado lo siguiente:Credenciales de API
Credenciales API válidas y token de acceso para la autenticación.
Configuración de la cuenta
Configuración adecuada de la cuenta para el país de destino y verificación de la empresa.
Lista blanca de IP
Incluye en la lista blanca las direcciones IP de tus servidores para el acceso a la API.
Endpoint del webhook
Configura una URL de webhook para recibir notificaciones de pago.
Métodos de tokenización
Existen dos métodos disponibles para tokenizar una tarjeta:Opción 1: Endpoint para la tokenización de tarjetas
Puedes tokenizar de forma segura la información de la tarjeta para su uso futuro a través de un endpoint dedicado. Para tokenizar una tarjeta, envía una solicitudPOST al endpoint Tokenizar tarjeta con los siguientes parámetros:
Ejemplo de solicitud
curl
Ejemplo de respuesta exitosa
En respuesta, la API devuelve el token de la tarjeta:Campos de respuesta clave
Opción 2: Tokenización de la tarjeta durante el pago
Localpayment permite a los comercios tokenizar tarjetas durante el procesamiento de pagos incluyendo el parámetrosave en las solicitudes de pago. Este enfoque simplificado te permite procesar una transacción y almacenar los datos de la tarjeta en una sola llamada a la API.
Para tokenizar una tarjeta, envía una solicitud POST al endpoint Crear Payin e incluye la propiedad card.save establecida en true en tu solicitud de Payin.
Ejemplo de solicitud
curl
Ejemplo de respuesta exitosa
En respuesta, la API devuelve el token de la tarjeta:Campos de respuesta clave
Uso de tarjetas tokenizadas
Para usar una tarjeta tokenizada en un pago, incluye elcard.token en tu solicitud de pago.
Ejemplo de solicitud con token
curl
Obtener información de la tarjeta
Una vez tokenizada una tarjeta, puedes recuperar sus detalles mediante la API de Localpayment. Esto te permite mostrar a los clientes los métodos de pago almacenados, manteniendo la conformidad con la normativa PCI. Para obtener la información de una tarjeta, envía una solicitudGET al endpoint Obtener detalles de la tarjeta, incluyendo el token de la tarjeta como parámetro de consulta.
Ejemplo de solicitud
curl
Ejemplo de respuesta exitosa
En respuesta, la API devuelve los detalles de la tarjeta:Eliminar una tarjeta tokenizada
Elimina permanentemente los tokens de tarjeta almacenados mediante un endpoint de API dedicado. Esta acción irreversible ayuda a mantener el cumplimiento de las normativas de privacidad de datos y permite una gestión adecuada del ciclo de vida de la tarjeta. Para eliminar una tarjeta tokenizada, envía una solicitudDELETE al endpoint Eliminar tarjeta tokenizada, incluyendo el token de la tarjeta como parámetro de consulta.
Ejemplo de solicitud
curl
Ejemplo de respuesta exitosa
Una eliminación exitosa normalmente devolverá un objeto JSON vacío:Próximos pasos
Ahora que has tokenizado correctamente una tarjeta, puedes utilizar el token generado para un procesamiento seguro en todos los servicios de pago de Localpayment:Pagos únicos
Utiliza el token para procesar pagos únicos e inmediatos.
Suscripciones
Configura ciclos de facturación recurrentes automatizados utilizando la tarjeta tokenizada.
Cuotas
Ofrece a tus clientes opciones de pago a plazos mediante la tarjeta tokenizada.
3D Secure
Mejora la seguridad de los pagos con tarjeta tokenizada mediante la autenticación 3D Secure.

