Interfaz ICard

Esta interfaz contiene todos los métodos que se usan al resolver initCardToken().

Métodos

MÉTODO	DESCRIPCIÓN
focus	Enfoca un campo hosted.
getFormValidity	Valida todos los campos.
onFieldBlur	Este evento se emite cuando el campo pierde el foco.
onFieldFocus	Este evento se ejecuta cuando el campo recibe el foco.
onFieldSubmit	Este evento se ejecuta cuando el campo se ha enviado.
onFieldValidity	Este evento se ejecuta cuando cambia la validez del campo.
onOTPValidation	Este evento se dispara cuando se requiere validación OTP.
requestToken	Obtén un token de pago con una tarjeta.
reset	Restablece un campo hosted.

focus

Focus on a server-side field.

Este método enfoca de forma asíncrona un campo del formulario del tipo indicado; si no, se genera una excepción.

Parámetros

PARÁMETRO	TIPO	REQUERIDO
`fieldType`	FieldTypeEnum	NO

Errores

CÓDIGO	MENSAJE	EJEMPLO	DESCRIPCIÓN
E010	Error al realizar focus en el campo	{ code: "E010", message: "Error al realizar focus en el campo" }	If the specified field type is invalid, it will return an E010 error

Ejemplo

getFormValidity

Esta función devuelve un FormValidity con el estado de validación de todos los campos.

Ejemplo

Validación de todos los campos hosted.

onFieldBlur

Este evento se emite cuando el campo pierde el foco.

Parámetros

PARÁMETRO	TIPO	REQUERIDO	DESCRIPCIÓN
`event`	fieldEvent	SÍ	Este callback se ejecuta cuando el campo hosted pierde el foco. fieldEvent: FieldValidity \| FormValidity
`fieldType`	FieldTypeEnum	NO	Define el tipo de campo si quieres controlar el evento blur de un campo hosted específico

Ejemplos

Manejo de los eventos blur de todos los campos hosted.

Manejo del evento blur de un campo hosted específico.

onFieldFocus

Este evento se ejecuta cuando el campo recibe el foco.

Parámetros

PARÁMETRO	TIPO	REQUERIDO	DESCRIPCIÓN
`event`	fieldEvent	SÍ	Este callback se ejecuta cuando el campo hosted recibe el foco. fieldEvent: FieldValidity \| FormValidity
`fieldType`	FieldTypeEnum	NO	Define el tipo de campo si quieres controlar el evento focus de un campo hosted específico

Ejemplos

Manejo de los eventos focus de todos los campos hosted.

Manejo del evento focus de un campo hosted específico.

onFieldSubmit

Este evento se ejecuta cuando el campo se ha enviado.

Parámetros

PARÁMETRO	TIPO	REQUERIDO	DESCRIPCIÓN
`event`	fieldEvent	SÍ	Este callback se ejecuta cuando el campo hosted se envía. fieldEvent: FieldValidity \| FormValidity
`fieldType`	FieldTypeEnum	NO	Define el tipo de campo si quieres controlar el envío del evento de un campo hosted específico

Ejemplos

Manejo de los eventos submit de todos los campos hosted.

Manejo del evento submit de un campo hosted específico.

onFieldValidity

Este evento se ejecuta cuando cambia la validación del campo.

Parámetros

PARÁMETRO	TIPO	REQUERIDO	DESCRIPCIÓN
`event`	fieldEvent	SÍ	Este callback se ejecuta cuando el campo hosted cambia su validez. fieldEvent: FieldValidity \| FormValidity
`fieldType`	FieldTypeEnum	NO	Define el tipo de campo si quieres controlar la validez del evento de un campo hosted específico

Ejemplos

Manejo de los eventos validity de todos los campos hosted.

Manejo del evento validity de un campo hosted específico.

onOTPValidation

Este evento se ejecuta cuando se ingresa un valor en el campo OTP para validar el código. La autenticación OTP usa una contraseña de un solo uso para dar más seguridad a las transacciones en línea. El usuario tiene 3 intentos para ingresar un OTP válido; si no, la transacción se rechaza.

Esta validación solo se ejecuta si el comercio tiene una regla OTP habilitada y se cumple la condición.

La validación OTP se activa cuando ingresas el tercer dígito en el campo OTP. Activa cada evento de validación y puedes capturar esos eventos con los callbacks onError u OnSuccess.

Parámetros

PARÁMETRO	TIPO	REQUERIDO	DESCRIPCIÓN
`onRequired`	callback	SÍ	Este callback se ejecuta cuando el token creado necesita validación OTP
`onError`	callback	SÍ	Este callback se ejecuta cuando la validación OTP devuelve un error
`onSuccess`	callback	SÍ	Este callback se ejecuta cuando la validación OTP es exitosa

Errores

Si la validación OTP es incorrecta, el callback onError devuelve los siguientes mensajes de error:

CÓDIGO	MENSAJE	EJEMPLO	DESCRIPCIÓN
E008	Error en la validación de OTP	{ code: "E008", message: "Error en la validación de OTP" }	Si la validación OTP no es correcta, el callback `onError` devuelve el código de error E008. Vuelve a intentarlo ingresando los datos correctos para la validación OTP.

Ejemplos

Manejo de los eventos onOTPValidation del campo hosted de OTP.

requestToken

Get a payment token with a card

Este método valida que todos los campos sean válidos y obtiene un token de pago con una tarjeta; si no, lanza una excepción.

Si el comercio tiene habilitada una regla OTP, 3DS o SiftScience, este método ejecuta automáticamente las validaciones de cada regla.

Cuando la instancia del método initCardToken se configura como suscripción, el token debe usarse para crear una suscripción; si no, puedes continuar con el flujo normal de pago único.

Este método devuelve un objeto de tipo TokenResponse con el token generado y, si hay diferidos, se devuelven en la respuesta.

Errores

Esta es la lista de errores que el método requestToken() puede devolver como un objeto KushkiError:

CÓDIGO	MENSAJE	EJEMPLO	DESCRIPCIÓN
E002	Error en solicitud de token	{ code: "E002", message: "Error en solicitud de token" }	Si ocurrió un error al solicitar un token, se devuelve el código de error E002. Valida que la información requerida se haya enviado correctamente.
E003	Error en solicitud de datos del comercio	{ code: "E003", message: "Error en solicitud de datos del comercio" }	Si ocurrió un error al solicitar la información del comercio. Vuelve a intentarlo; si el error persiste, contacta al soporte de Kushki.
E004	Error en solicitud de JWT	{ code: "E004", message: "Error en solicitud de JWT" }	Si el comercio tiene una regla 3DS habilitada y ocurrió un error al solicitar el JWT. Vuelve a intentarlo; si el error persiste, contacta al soporte de Kushki
E005	Campos 3DS inválidos	{ code: "E005", message: "Campos 3DS inválidos" }	Si el comercio tiene una regla 3DS habilitada y ocurrió un error en la autenticación 3DS. Vuelve a intentarlo asegurándote de ingresar correctamente los datos para la validación 3DS.
E006	Error en solicitud de validación de token	{ code: "E006", message: "Error en solicitud de validación de token" }	Si el comercio tiene una regla 3DS habilitada y ocurrió un error en la sesión de validación 3DS. Vuelve a intentarlo asegurándote de ingresar correctamente los datos para la validación 3DS; si el error persiste, contacta al soporte de Kushki
E007	Error en la validación del formulario	{ code: "E007", message: "Error en la validación del formulario" }	Si algún campo hosted no es válido, se devuelve el código de error E007. Vuelve a intentarlo asegurándote de ingresar correctamente los datos solicitados.
E008	Error en la validación de OTP	{ code: "E008", message: "Error en la validación de OTP" }	Si la validación OTP no es exitosa, el callback onError devuelve el código de error E008. Vuelve a intentarlo ingresando los datos correctos para la validación OTP

Ejemplos

One-time payment or subscription

Pago único o suscripción con diferido

reset

Reset a server-side field.

Este método restablece de forma asíncrona un campo del formulario del tipo indicado a su estado por defecto; si no, lanza una excepción.

Parámetros

PARÁMETRO	TIPO	REQUERIDO	DESCRIPCIÓN
fieldType	FieldTypeEnum	NO	Define el tipo de campo si quieres controlar la validez del evento de un campo hosted específico

Errores

CÓDIGO	MENSAJE	EJEMPLO	DESCRIPCIÓN
E009	Error al limpiar el campo	{ code: "E009", message: "Error al limpiar el campo" }	Si el tipo de campo indicado no es válido, el callback onError devuelve el código de error E009.

Métodos#

focus#

Parámetros#

Errores#

Ejemplo#

getFormValidity#

Ejemplo#

onFieldBlur#

Parámetros#

Ejemplos#

onFieldFocus#

Parámetros#

Ejemplos#

onFieldSubmit#

Parámetros#

Ejemplos#

onFieldValidity#

Parámetros#

Ejemplos#

onOTPValidation#

Parámetros#

Errores#

Ejemplos#

requestToken#

Errores#

Ejemplos#

reset#

Parámetros#

Errores#

Ejemplo#

Métodos

focus

Parámetros

Errores

Ejemplo

getFormValidity

Ejemplo

onFieldBlur

Parámetros

Ejemplos

onFieldFocus

Parámetros

Ejemplos

onFieldSubmit

Parámetros

Ejemplos

onFieldValidity

Parámetros

Ejemplos

onOTPValidation

Parámetros

Errores

Ejemplos

requestToken

Errores

Ejemplos

reset

Parámetros

Errores

Ejemplo