Interfaz ICardSubscriptions
Métodos#
| MÉTODO | DESCRIPCIÓN |
|---|
| focus | Hace foco en un hosted field. |
| 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. |
| requestDeviceToken | Obtén un device token seguro para suscripciones bajo demanda o pagos one-click. |
| reset | Restablece un hosted field. |
focus#
Este método hace foco de forma asíncrona en un campo del formulario del tipo indicado; de lo contrario, se genera una excepción.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#
Esta función devuelve un FormValidity que representa el estado de validación del campo CVV.Ejemplo#
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 hosted field pierde el foco. fieldEvent: FieldValidity | FormValidity |
| fieldType | FieldTypeEnum | NO | Define el tipo de campo si quieres controlar el evento de pérdida de foco de un hosted field específico |
Ejemplos#
Manejo del evento blur para obtener FormValidity.Handling blur event to get cvv FieldValidityonFieldFocus#
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 hosted field recibe el foco. fieldEvent: FieldValidity | FormValidity |
| fieldType | FieldTypeEnum | NO | Define el tipo de campo si quieres controlar el evento de foco de un hosted field específico |
Ejemplos#
Handling focus event to get FormValidityHandling focus event to get cvv FieldValidityonFieldSubmit#
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 hosted field se envía.
fieldEvent: FieldValidity | FormValidity |
| fieldType | FieldTypeEnum | NO | Define el tipo de campo si quieres controlar el evento de envío de un hosted field específico |
Ejemplos#
Handling submit event to get FormValidityHandling submit event to get FieldValidityonFieldValidity#
Este evento se ejecuta cuando cambia la validez del campo.Parámetros#
| PARÁMETRO | TIPO | REQUERIDO | DESCRIPCIÓN |
|---|
| event | fieldEvent | SÍ | Este callback se ejecuta cuando el hosted field cambia su validez. fieldEvent: FieldValidity | FormValidity |
| fieldType | FieldTypeEnum | NO | Define el tipo de campo si quieres controlar la validez del evento de un hosted field específico |
Ejemplos#
Handling FormValidity event of cvv fieldHandling FieldValidity event of cvv fieldrequestDeviceToken#
Obtén un device token seguro para suscripciones bajo demanda o pagos one-click.Este método valida si el campo cvv es válido y genera un device token. Si la validación falla, se lanza una excepción.Si el comercio o la suscripción requieren los servicios 3DS o Sift Science, este método realiza automáticamente las validaciones necesarias según cada regla.Parámetros#
body: DeviceTokenRequest (Opcional) Objeto con subscriptionId y otros parámetros para casos específicos.
Devuelve#
Promise<TokenResponse>: TokenResponse object with token
Lanza#
Objeto KushkiErrorResponse con el código y el mensaje del errorErrores#
Si ocurre un error en el endpoint "requestDeviceToken", el sistema lanza un error E002.
Si ocurre un error en el endpoint "requestMerchantSettings", el sistema lanza un error E003.
Si el comercio tiene configuraciones de Sift Science y falta options.subscriptionId en el cuerpo de la solicitud, o la solicitud falla, el sistema lanza un error E016.
Si el comercio está configurado con una regla 3DS y ocurre un error en el endpoint "requestJWT", el sistema lanza un error E004.
Si el comercio está configurado con una regla 3DS y ocurre un error durante la autenticación 3DS, el sistema lanza un error E005.
Si el comercio está configurado con una regla 3DS y ocurre un error durante la validación de la sesión 3DS, el sistema lanza un error E006.
Si el campo cvv es inválido, el sistema lanza un error E007.
Si el cuerpo "DeviceTokenRequest" no está definido, el sistema lanza un error E020.
Ejemplos#
Ejemplo para validaciones 3DS y Siftreset#
Este método restablece de forma asíncrona un campo del formulario del tipo indicado a su estado por defecto; de lo contrario, lanza una excepción.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 es inválido, el callback onError devuelve el código de error E009. |
Ejemplo#
Modified at 2026-09-11 14:38:21
