Tokenizar tarjeta

Esta sección detalla el uso del endpoint para tokenizar tarjetas de crédito o débito. La tokenización permite almacenar de forma segura los datos de la tarjeta del cliente y utilizarlos en transacciones futuras sin necesidad de solicitar nuevamente la información sensible.

Detalles del endpoint

Método: POST
URL: /api/v1/transactions/tokenization

Este endpoint genera un token único (cardIdentifier) que representa los datos de la tarjeta del cliente, permitiéndote procesar pagos posteriores de manera segura y conforme a los estándares PCI DSS.

Configuración de la solicitud

Headers

Header	Descripción
`X-API-KEY`	API Key generada en Cubo Admin.
`Content-Type`	`application/json`

Si aún no has generado tu API Key, revisa nuestra sección de autenticación.

Cuerpo de la solicitud

Parámetro	Tipo	Descripción
`clientName`	`string`	Nombre del cliente.
`clientEmail`	`string`	Correo electrónico del cliente.
`clientPhone`	`string`	Teléfono del cliente con código de país.
`cardHolder`	`string`	Nombre del titular de la tarjeta.
`cardNumber`	`string`	Número de la tarjeta de crédito o débito.
`cvv`	`string`	Código de seguridad de la tarjeta.
`month`	`string`	Mes de expiración de la tarjeta en formato `MM`.
`year`	`string`	Año de expiración de la tarjeta en formato `YY`.

A continuación se muestra un ejemplo de la solicitud en formato JSON:


{
  "clientName": "John Doe",
  "clientEmail": "[email protected]",
  "clientPhone": "+50322577777",
  "cardHolder": "John Doe",
  "cardNumber": "9999998523950797",
  "cvv": "123",
  "month": "12",
  "year": "26"
}

Ejemplos de uso

JavaScript


fetch('https://<CUBO_API_URL>/api/v1/transactions/tokenization', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-KEY': 'TU_API_KEY_AQUI',
  },
  body: JSON.stringify({
    clientName: 'John Doe',
    clientEmail: '[email protected]',
    clientPhone: '+50322577777',
    cardHolder: 'John Doe',
    cardNumber: '9999998523950797',
    cvv: '123',
    month: '12',
    year: '26',
  }),
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

Respuestas del servidor

✅ Respuesta exitosa

Indica que la tarjeta fue tokenizada exitosamente. El cardIdentifier devuelto puede ser utilizado para procesar pagos futuros.


{
  "cardIdentifier": "c71cf205-b7d9-4982-80d6-26dc3542ee0e"
}

💡

Guarda el cardIdentifier de forma segura en tu base de datos, asociado al cliente correspondiente. Este token es único y representa los datos de la tarjeta sin exponer información sensible.

❌ Respuesta de error

Indica que la tokenización fue rechazada debido a un error en la solicitud o problemas con los datos de la tarjeta.


{
  "statusCode": 400,
  "message": "Error al tokenizar la tarjeta",
  "error": "Bad Request"
}

Uso del token en pagos posteriores

Una vez que hayas obtenido el cardIdentifier, puedes utilizarlo para procesar pagos sin necesidad de solicitar nuevamente los datos de la tarjeta al cliente. Esto mejora la experiencia del usuario y mantiene la seguridad de la información sensible.