Solicitar un token de tarjeta

Esta funcionalidad está disponible para los siguientes modelos:
☑ Acquirer
☑ Aggregator

Solicita un token de tarjeta que luego puedes usar para hacer un cargo a un cliente con el endpoint charge.

Importante a considerar: 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 pueden usarse para una única transacción (incluso si la transacción falló). Deberás solicitar un token nuevo cuando expire.

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

Transacciones recurrentes*

Esta funcionalidad está disponible para los siguientes modelos:
☑ Acquirer
☐ Aggregator

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

initialRecurrence: El comercio debe generar un token enviando la información completa de la tarjeta (number, expiration date, cvv, etc.) para registrarla. Se devuelve un token para continuar con el pago.

subsequentRecurrence: El comercio puede generar un token enviando los datos de la tarjeta que ya envió con un initialRecurrence; con esto el comercio puede omitir el ingreso del CVV y hacer un cargo después con el flujo actual.

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

¿Quieres validar una cuenta?*

Esta funcionalidad está disponible para los siguientes modelos:
☑ Acquirer
☐ Aggregator

Envía el parámetro transactionMode como accountValidation para solicitar un token de validación de cuenta que luego puedas usar para verificar una cuenta con el endpoint card/v1/validation. Asegúrate de fijar el totalAmount en 0.

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 incrustarla.
callbackUrl	string	Callback donde 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 devuelven los campos que se listan abajo

PROPIEDAD	VALORES POSIBLES	DESCRIPCIÓN
url	string	URL que se debe 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 viene la url que debes mostrar al tarjetahabiente para la autenticación 3D Secure, si es necesario. Para información más detallada, visita la guía 3D Secure API authentication.

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

NOTA: Para habilitar 3DS en modo de pruebas en tu comercio, se requiere una configuración adicional que realiza Kushki.

callbackUrl

La función de callback te indica si la autenticación 3D Secure fue exitosa o si hubo algún problema durante el proceso. Esta url se llama automáticamente después de autenticar, mediante un redirect 301 haciendo una petición GET a la url enviada 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 continuar con el cargo. Si es false, el tarjetahabiente tiene 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 un cargo si la autenticación 3D Secure fue exitosa.
message	string	Si hay un problema durante la autenticación, aquí 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

Esta funcionalidad está disponible para los siguientes modelos:

Expiración del token

Transacciones recurrentes*

Esta funcionalidad está disponible para los siguientes modelos:

¿Quieres validar una cuenta?*

Esta funcionalidad está disponible para los siguientes modelos:

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

Esta funcionalidad está disponible para los siguientes modelos:#

Expiración del token#

Transacciones recurrentes*#

Esta funcionalidad está disponible para los siguientes modelos:#

¿Quieres validar una cuenta?*#

Esta funcionalidad está disponible para los siguientes modelos:#

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

callbackUrl#

Ejemplo de callback de autenticación exitosa#

Ejemplo de callback con problema de autenticación#

Request

Responses

Esta funcionalidad está disponible para los siguientes modelos:

Expiración del token

Transacciones recurrentes*

Esta funcionalidad está disponible para los siguientes modelos:

¿Quieres validar una cuenta?*

Esta funcionalidad está disponible para los siguientes modelos:

Autenticación 3D Secure (3DS)*

callbackUrl

Ejemplo de callback de autenticación exitosa

Ejemplo de callback con problema de autenticación