ICardSubscriptions Interface
ICardSubscriptions Interface
Methods
| METHOD | DESCRIPTION |
|---|---|
| focus | Focus on a hosted field. |
| getFormValidity | Validate all fields. |
| onFieldBlur | This event is emitted when the field loses focus. |
| onFieldFocus | This event is executed when the field is focused. |
| onFieldSubmit | This event is executed when the field has been submitted. |
| onFieldValidity | This event is executed when the validity of the field changes. |
| requestDeviceToken | Obtain a payment token with a card. |
| reset | Reset a hosted field. |
focus
Errors
| CODE | MESSAGE | EXAMPLE | DESCRIPTION |
|---|---|---|---|
| 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 |
Example
getFormValidity
Example
onFieldBlur
Parameters
| PARAMETER | TYPE | REQUIRED | DESCRIPTION |
|---|---|---|---|
| event | fieldEvent | YES | This callback is executed when the hosted field is blurry. fieldEvent: FieldValidity | FormValidity |
| fieldType | FieldTypeEnum | NO | Set the field type if you want to control the event blurring of a specific hosted field |
Examples
onFieldFocus
Parameters
| PARAMETER | TYPE | REQUIRED | DESCRIPTION |
|---|---|---|---|
| event | fieldEvent | YES | This callback is executed when the hosted field is focused. fieldEvent: FieldValidity | FormValidity |
| fieldType | FieldTypeEnum | NO | Set the field type if you want to control the event focus of a specific hosted field |
Examples
onFieldSubmit
Parameters
| PARAMETER | TYPE | REQUIRED | DESCRIPTION |
|---|---|---|---|
| event | fieldEvent | YES | This callback is executed when the hosted field is sent. fieldEvent: FieldValidity | FormValidity |
| fieldType | FieldTypeEnum | NO | Set the field type if you want to control the event dispatch of a specific hosted field |
Examples
onFieldValidity
Parameters
| PARAMETER | TYPE | REQUIRED | DESCRIPTION |
|---|---|---|---|
| event | fieldEvent | YES | This callback is executed when the hosted field changes its validity. fieldEvent: FieldValidity | FormValidity |
| fieldType | FieldTypeEnum | NO | Set the field type if you want to control the validity of a specific hosted field event |
Examples
requestDeviceToken
Parameters
subscriptionId and other params for specific cases.Returns
Promise<TokenResponse>: TokenResponse object with tokenThrows
KushkiErrorResponse object with code and message of errorErrors
"requestDeviceToken" endpoint, the system throws an E002 error.- If an error occurs on the
"requestMerchantSettings" endpoint, the system throws an E003 error.- If the merchant has Sift Science configurations and
options.subscriptionId is missing in the request body or the request fails, the system throws an E016 error.- If the merchant is configured with a 3DS rule and an error occurs on the
"requestJWT" endpoint, the system throws an E004 error.- If the merchant is configured with a 3DS rule and an error occurs during 3DS authentication, the system throws an E005 error.
- If the merchant is configured with a 3DS rule and an error occurs during 3DS session validation, the system throws an E006 error.
- If the
cvv field is invalid, the system throws an E007 error.- If the
"DeviceTokenRequest" body is not defined, the system throws an E020 error.Examples
reset
Errors
| CODE | MESSAGE | EXAMPLE | DESCRIPTION |
|---|---|---|---|
| E009 | Error al limpiar el campo | { code: "E009", message: "Error al limpiar el campo" } | If the specified field type is invalid, the onError callback will return the error code E009. |
Example
Modified atĀ 2026-03-09 19:19:59