Solicitar un token de tarjeta

Solicita un token de tarjeta que después puedas usar para cobrarle a un cliente con el
endpoint charge.

Importante: Si usas esta opción para solicitar el token, asegúrate de cumplir con todos los requisitos PCI para manejar datos de tarjeta en tus servidores.

Expiración del token
Los tokens expiran en 30 minutos y solo se pueden usar para una única transacción (incluso si la transacción salió mal). Cuando expire, tendrás que solicitar un token nuevo.

Nota: El token que entrega Kushki solo encripta y envía información. Si quieres almacenar la información de la tarjeta para compras futuras, ve a la sección One-Click & Scheduled Payments.

Transacciones recurrentes*

Envía el parámetro transactionMode para solicitar un token de cargo recurrente que después puedas usar para crear un cargo recurrente, así:

initialRecurrence: los comercios deben generar un token enviando la información completa de la tarjeta (número, fecha de expiración, cvv, etc.) para registrarla. Se devolverá un token para continuar el pago.

subsequentRecurrence: el comercio podrá generar un token enviando los datos de la tarjeta que ya envió antes con un initialRecurrence; con esto el comercio podrá omitir el ingreso del CVV y hacer un cargo más adelante con el flujo actual.

NOTA: Si quieres procesar un cargo recurrente con un motor externo, debes omitir el envío del CVV.

Autenticación 3D Secure (3DS)*

Para autenticar una tarjeta con 3D Secure, además de la información necesaria para generar un token, debes enviar los campos que se listan abajo

PROPIEDAD	VALORES POSIBLES	DESCRIPCIÓN
authValidation	`url` `iframe`	Define el tipo de integración que quieres para la autenticación 3DS. Usa `url` para redirección o `iframe` para embeber.
callbackUrl	string	Callback al que se enviará la respuesta de la autenticación 3D Secure.

Si la transacción dispara una regla de autenticación 3D Secure en el comercio, además del token se devolverán los campos que se listan abajo

PROPIEDAD	VALORES POSIBLES	DESCRIPCIÓN
url	string	URL que debes usar para la autenticación 3D Secure.
secureService	`3dsecure`	Indica el servicio de autenticación de la transacción.
secureId	string	ID de seguridad de la transacción.

Ejemplo

{
    "token": "sBkQ7F110000tI1HVq116862fd5Ah3mG",
    "url": "https://uat-auth.kushkipagos.com?token=sBkQ7F110000tI1HVq116862fd5Ah3mG&merchantId=306cb10581bb4acb9a2bfc77e163c482&bin=NDM0OTAwMzA=&callbackUrl=https://www.kushkipagos.com/callback/&isSandbox=false",
    "secureService": "3dsecure",
    "secureId": "1f5584db-0c5b-c729-a19c-6eb0283ca448"
}

En el campo url vendrá la url que tendrás que mostrarle al tarjetahabiente para la autenticación 3D Secure, si hace falta. Para más detalle, revisa la guía 3D Secure API authentication.

Para más información sobre 3D Secure, revisa Accept payments with 3DS.

NOTA: Para habilitar 3DS en modo de prueba en tu comercio, Kushki debe hacer una configuración adicional.

callbackUrl

La función de callback te avisará si la autenticación 3D Secure fue exitosa o si hubo algún problema durante el proceso. Esta url se llamará automáticamente después de autenticar, mediante un redirect 301 con una petición GET a la url que enviaste en el campo callbackUrl, con los parámetros de la respuesta en la url (path parameters).

Nota: El parámetro booleano sucess indica si la transacción se autenticó correctamente (true) o si hubo un problema con la autenticación 3D Secure (false). Si es true, puedes seguir con el cargo. Si es false, el tarjetahabiente tendrá hasta 3 intentos para reintentar la autenticación antes de que la transacción sea declinada.

PROPIEDAD	TIPO	DESCRIPCIÓN
success	boolean	Indica si la autenticación 3D Secure fue exitosa o no.
token	string	Token que devuelve Kushki para usarlo al hacer el cargo, en caso de que la autenticación 3D Secure haya sido exitosa.
message	string	Si hubo un problema durante la autenticación, acá se devuelve el motivo.

Ejemplo de callback de autenticación exitosa

https://www.tutienda.com/?success=true&token=cfa0bfec88324bd7a5c6c1ad9135a846

Ejemplo de callback con problema de autenticación

https://www.tutienda.com/?success=false&message=Error%20en%20la%20validación%20de%203DS&token=cfa0bfec88324bd7a5c6c1ad9135a846

Expiración del token

Transacciones recurrentes*

Autenticación 3D Secure (3DS)*

callbackUrl

Ejemplo de callback de autenticación exitosa

Ejemplo de callback con problema de autenticación

Request

Responses

Solicitar un token de tarjeta

Expiración del token#

Transacciones recurrentes*#

Autenticación 3D Secure (3DS)*#

callbackUrl#

Ejemplo de callback de autenticación exitosa#

Ejemplo de callback con problema de autenticación#

Request

Responses

Expiración del token

Transacciones recurrentes*

Autenticación 3D Secure (3DS)*

callbackUrl

Ejemplo de callback de autenticación exitosa

Ejemplo de callback con problema de autenticación