Saltar al contenido principal
La tokenización con Localpayment proporciona una forma segura de gestionar la información de las tarjetas, reduciendo el riesgo de seguridad y simplificando las transacciones futuras.

Cómo funciona

El proceso consta de los siguientes pasos clave:
  1. 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.
  2. 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.
  3. Uso de la tarjeta tokenizada: Para los pagos posteriores con tarjeta, enviarás la propiedad card.token en 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 solicitud POST 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ámetro save 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 el card.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 solicitud GET 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 solicitud DELETE 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.
Última modificación el 10 de noviembre de 2026