Notas de versión

Mantente al día con los cambios y las actualizaciones de la API de Kushki.

Usamos el estándar ISO 8601 (YYYY-MM-DD) para las fechas y el versionado semántico (MAJOR.MINOR.PATCH) para los números de versión, incrementando:

la versión MAJOR cuando hacemos cambios incompatibles en la API,

la versión MINOR cuando agregamos funcionalidad de forma retrocompatible, y

la versión PATCH cuando hacemos correcciones de errores retrocompatibles.

Tipos de cambios

NEW para funcionalidades nuevas.

IMPROVEMENTS para cambios en funcionalidades existentes.

DEPRECATED para funcionalidades que se eliminarán pronto.

REMOVED para funcionalidades ya eliminadas.

FIX para correcciones de errores.

SECURITY en caso de vulnerabilidades.

Última versión

1.8.3 - 2026-05-20

NEW

Apple Pay para suscripciones 🇨🇱 🇵🇪 🇲🇽

Apple Pay ya admite pagos de suscripción (cargos recurrentes) en las librerías Kushki.js v1 y Kushki.js Hosted Fields.

Con esta actualización, los comercios pueden generar un token de suscripción desde el flujo de Apple Pay enviando la bandera isSubscription a requestApplePayToken. Ese token se usa para crear un cargo recurrente con la API de suscripciones de Kushki.

Por ahora, las suscripciones con Apple Pay solo están disponibles en Chile, Perú y México, y admiten tarjetas Visa y Mastercard.

🧩 Para Kushki.js Hosted Fields

Apple Pay — Subscription example

requestApplePayToken — see isSubscription field

ApplePayGetTokenOptions — new isSubscription property

💻 Para Kushki.js v1

Apple Pay — Recurring Charges — new Apple Pay tab

requestApplePayToken — see isSubscription field

Novedades


`isSubscription`	Nuevo campo opcional `boolean` en `requestApplePayToken`. Envíalo como `true` para generar un token de suscripción en vez de un token de pago único.

Nota

Esta funcionalidad sigue en fase de pruebas y puede cambiar antes del lanzamiento completo.

Notas de versión anteriores

1.8.0 - 2025-10-29

NEW

Lanzamiento inicial de la documentación de Apple Pay 🇨🇱 🇵🇪

Presentamos la documentación inicial de la integración con Apple Pay para las librerías Kushki.js v1 y Kushki.js Hosted Fields.

Con esta funcionalidad, puedes mostrar Apple Pay entre las opciones de pago de tus clientes en los navegadores y dispositivos compatibles.

Por ahora, Apple Pay solo está disponible en Chile y Perú, y admite tarjetas Visa y Mastercard.

🧩 Para Kushki.js Hosted Fields

Explore the new integration details:

Apple Pay Overview

initApplePayButton method

ICardApplePay Interface

💻 Para Kushki.js v1

Revisa la documentación de la librería Kushki.js v1 para consultar la referencia y la guía de configuración.

Nota

Este es un lanzamiento inicial. La funcionalidad y la documentación siguen en fase de pruebas y pueden cambiar antes del lanzamiento completo.

1.6.5 - 2025-07-03

NEW

Card Payouts ya disponible en Perú 🇵🇪

Esta versión agrega soporte para Card Payouts con la librería Kushki JS Hosted Fields — la solución ideal para los comercios que no cumplen con PCI.

Hosted Fields permite recolectar de forma segura los datos del tarjetahabiente y de la tarjeta mediante iframes alojados en la infraestructura de Kushki. Así se garantiza el cumplimiento de PCI, porque la información sensible queda aislada de tus sistemas.

Una vez implementada, puedes solicitar dos tipos de token:

Token de pago único: para dispersiones individuales a una tarjeta.

Token de suscripción: para pagos recurrentes a una tarjeta. Devuelve un subscriptionId en vez de un token.

✅ Hosted Fields es la vía de integración recomendada para entornos de front-end que necesitan tokenización segura sin manejar directamente los datos de la tarjeta.

Consulta la guía completa de integración en la documentación de Kushki JS Hosted Fields.

1.6.3 - 2025-02-21

DEPRECATED

El objeto DeviceTokenRequest, que incluye subscriptionId, quedará obsoleto en el método initSecureDeviceToken.

IMPROVEMENTS

El método requestDeviceToken ya admite el objeto DeviceTokenRequest, que incluye subscriptionId, currency, amount y otros parámetros. Haz clic aquí para más información.

1.6.2 - 2024-12-26

IMPROVEMENTS

Actualizamos las instrucciones para configurar la librería de iOS en procesadores kushki-ios-arm. Haz clic aquí para más información.

1.6.1 - 2024-11-19

IMPROVEMENTS

Actualizamos la respuesta del método requestValidate3DS() en la librería Kushki.js.

1.6.0 - 2024-08-02

NEW

Agregamos soporte para la animación de branding de tarjeta en integraciones vía Kushki.js, Kushki.js Hosted Fields, Android SDK e iOS SDK.

Agregamos los códigos de error 21-23 para integraciones vía Kushki.js Hosted Fields.

Agregamos la sección Security a la referencia de la librería Kushki.js Hosted Fields para agrupar los distintos métodos de autenticación.

Agregamos la sección Sift en la referencia de Kushki.js Hosted Fields para las autenticaciones de seguridad.

Agregamos el método requestInitAntiFraud dentro de la sección Sift.

Agregamos el método requestBankList para obtener la lista de bancos en transacciones por transferencia en integraciones con Kushki.js Hosted Fields.

Agregamos el método requestBrandsByMerchant para obtener la lista de marcas de tarjeta disponibles en la configuración de tu comercio en integraciones con Kushki.js Hosted Fields.

Agregamos el método requestCommissionConfiguration para obtener la configuración de comisiones de tu comercio en integraciones con Kushki.js Hosted Fields.

Agregamos el método requestInitCardBrandingAnimation para implementar animaciones de branding de tarjeta en integraciones con Kushki.js Hosted Fields.

También agregamos estos artículos a la referencia de la librería Kushki.js Hosted Fields:

SiftScienceObject

requestBrandsByMerchant

requestInitCardBrandingAnimation

BrandByMerchantResponse

MasterCardBrandingRequest

VisaBrandingRequest

requestBankList

requestCommissionConfiguration

CommissionConfigurationRequest

1.5.1 - 2024-05-30

NEW

Seguimos mejorando nuestra librería Kushki.js Hosted Fields

Ya puedes obtener el bin, la marca de la tarjeta, la fecha de expiración y los últimos 4 dígitos de una tarjeta al generar un token para suscripciones: solo pon la propiedad fullResponse en true. Revisa la información adicional que se devuelve en la respuesta.

Creamos la sección de suscripciones con todo el detalle para generar un token de suscripción. Ahí encuentras cómo generar un token para un cargo recurrente o para un pago One-click. También encuentras cómo omitir el CVV en una suscripción.

Agregamos el método initSecureDeviceToken para validar el CVV al hacer un pago One-click. También agregamos información sobre ICardSubscriptions, CardInfo y SecureDeviceTokenOptions.

1.5.0 - 2024-04-10

NEW

Pagos One-click ya disponibles en kushki.js hosted fields

Recolecta y almacena de forma segura la información de tarjeta de tus clientes para futuros pagos One-click, ya disponible en la librería Kushki.js hosted fields.

Para hacer pagos One-click, sigue estos pasos:

Crear una suscripción:

requestToken() (Kushki.js hosted fields library, frontend)

Create a subscription (API, backend)

Hacer un pago One-click:

requestDeviceToken() (librería Kushki.js hosted fields, frontend)

Hacer un pago One-click (API, backend)

Para más información, revisa la nueva sección de pagos One-click.

Revisa también la lista de errores actualizada.

Autentica con 3D Secure en integraciones por API usando Kushki.js hosted fields

Ya puedes autenticar pagos con 3D Secure si tienes una integración por API que usa la librería Kushki.js hosted fields.

Para autenticar pagos con 3D Secure, sigue estos pasos:

Get a Json Web Token (JWT).

Request a card token.

Authenticate through 3D Secure.

Make a charge or deferred charge.

Para más información, revisa la nueva sección de validación 3D Secure.

Revisa también los nuevos métodos requestSecureInit(), requestValidate3DS() y requestDeviceToken(), y las interfaces SecureInitRequest, SecureInitResponse y DeviceTokenRequest.

1.4.0 - 2024-03-01

NEW

Nueva librería Kushki.js Hosted Fields

Presentamos la nueva librería Kushki.js Hosted Fields, que te permite ejecutar operaciones desde tu front-end para crear flujos de pago con Kushki.

Product in beta version 🔐

Conoce más sobre esta nueva librería en Kushki.js Hosted Fields.

Presentamos el nuevo formato de los cambios en la documentación

Actualizamos el formato de los cambios que hacemos en la documentación. Ahora encuentras los cambios mucho más fácil: están separados por categorías y cada tipo tiene su propio color.

Ahora todos los cambios están reunidos en el archivo release-notes, en vez de tener un archivo por versión. Así consultas todos los cambios desde un solo lugar.

Modificamos estos tipos de cambio:

Added → NEW

Changed → IMPROVEMENTS

Fixed → FIX

1.3.1 - 2023-10-31

IMPROVEMENTS

Kushki.js

Cambiaron los datos que recibe el método requestSecureInit(). Ahora recibe el bin de 8 dígitos en vez del número de tarjeta.

Actualizamos los casos y las tarjetas de prueba del método requestValidate3DS().

1.3.0 - 2023-09-27

NEW

Agregamos la sección 3DS en el método requestToken para Android e iOS.

Agregamos el nuevo método requestSecureValidation para android e iOS.

Agregamos las librerías kushki-ios-intel y kushki-ios-arm para la implementación en iOS.

IMPROVEMENTS

Actualizamos el Android SDK a 1.7.0.

Actualizamos las librerías de iOS a kushki-ios-intel -> 2.6.0 y kushki-ios-arm -> 2.6.0.

DEPRECATED

La librería de iOS quedó obsoleta.

1.2.4 - 2023-02-03

IMPROVEMENTS

Reemplazamos la tarjeta de prueba 4456540000000064 por 4456540000000063 en el escenario Transacción aprobada sin validación 3DS de Kushki.js.

1.2.3 - 2022-11-28

IMPROVEMENTS

Updated iOS SDK version to 2.4.2

1.2.2 - 2022-08-26

IMPROVEMENTS

Actualizamos la respuesta de los métodos requestValidate3DS() y requestSecureServiceValidation().

1.2.1 - 2022-08-23

NEW

Ejemplo de respuesta 3DS del método requestDeviceToken() en Kushki.js.

IMPROVEMENTS

Cambiamos el texto de "suscripciones" a "cargos recurrentes" en la documentación.

1.2.0 - 2022-06-24

NEW

Agregamos el método requestSecureInit() en la librería Kushki.js para obtener el parámetro jwt, requerido para la autenticación 3DS al consumir los métodos de la API Solicitar un token de tarjeta o Solicitar un token de cargo recurrente.

1.1.0 - 2022-05-25

NEW

Soporte de 3DS y Sift para el Android SDK.

Soporte de 3DS para Kushki.js. Agregamos el método requestValidate3DS() para pago único y suscripción con tarjeta.

Soporte de BIN de ocho dígitos.

IMPROVEMENTS

Actualizamos el Android SDK a 1.4.4.

requestToken() ahora acepta Context y Activity como parámetros para 3DS y Sift.

Actualizamos las respuestas de los métodos requestToken() (pago único) y requestSubscriptionToken() (suscripción con tarjeta) para agregar soporte de 3DS.

Kushki Android: actualizamos la descripción del método getBinInfo(). Cambiamos "los primeros seis dígitos" por "los primeros ocho dígitos".

Kushki iOS: actualizamos la descripción del método getCardInfo(). Cambiamos "los primeros seis dígitos" por "los primeros ocho dígitos".

Kushki.js:

Actualizamos la descripción del método requestBinInfo(). Cambiamos "los primeros seis dígitos" por "los primeros ocho dígitos".

Actualizamos el ejemplo del método requestDeferred() con un bin de 8 dígitos.

1.0.1 - 2022-05-16

IMPROVEMENTS

Android SDK upgrade to 1.4.3.

1.0.0 - 2022-02-21

NEW

Accept payment wherever you want.

Tipos de cambios#

Última versión#

1.8.3 - 2026-05-20#

Apple Pay para suscripciones 🇨🇱 🇵🇪 🇲🇽#

🧩 Para Kushki.js Hosted Fields#

💻 Para Kushki.js v1#

Novedades#

Notas de versión anteriores#

1.8.0 - 2025-10-29#

Lanzamiento inicial de la documentación de Apple Pay 🇨🇱 🇵🇪#

🧩 Para Kushki.js Hosted Fields#

💻 Para Kushki.js v1#

1.6.5 - 2025-07-03#

Card Payouts ya disponible en Perú 🇵🇪#

1.6.3 - 2025-02-21#

1.6.2 - 2024-12-26#

1.6.1 - 2024-11-19#

1.6.0 - 2024-08-02#

1.5.1 - 2024-05-30#

Seguimos mejorando nuestra librería Kushki.js Hosted Fields#

1.5.0 - 2024-04-10#

Pagos One-click ya disponibles en kushki.js hosted fields#

Autentica con 3D Secure en integraciones por API usando Kushki.js hosted fields#

1.4.0 - 2024-03-01#

Nueva librería Kushki.js Hosted Fields#

Presentamos el nuevo formato de los cambios en la documentación#

1.3.1 - 2023-10-31#

1.3.0 - 2023-09-27#

1.2.4 - 2023-02-03#

1.2.3 - 2022-11-28#

1.2.2 - 2022-08-26#

1.2.1 - 2022-08-23#

1.2.0 - 2022-06-24#

1.1.0 - 2022-05-25#

1.0.1 - 2022-05-16#

1.0.0 - 2022-02-21#

Tipos de cambios

Última versión

1.8.3 - 2026-05-20

Apple Pay para suscripciones 🇨🇱 🇵🇪 🇲🇽

🧩 Para Kushki.js Hosted Fields

💻 Para Kushki.js v1

Novedades

Notas de versión anteriores

1.8.0 - 2025-10-29

Lanzamiento inicial de la documentación de Apple Pay 🇨🇱 🇵🇪

🧩 Para Kushki.js Hosted Fields

💻 Para Kushki.js v1

1.6.5 - 2025-07-03

Card Payouts ya disponible en Perú 🇵🇪

1.6.3 - 2025-02-21

1.6.2 - 2024-12-26

1.6.1 - 2024-11-19

1.6.0 - 2024-08-02

1.5.1 - 2024-05-30

Seguimos mejorando nuestra librería Kushki.js Hosted Fields

1.5.0 - 2024-04-10

Pagos One-click ya disponibles en kushki.js hosted fields

Autentica con 3D Secure en integraciones por API usando Kushki.js hosted fields

1.4.0 - 2024-03-01

Nueva librería Kushki.js Hosted Fields

Presentamos el nuevo formato de los cambios en la documentación

1.3.1 - 2023-10-31

1.3.0 - 2023-09-27

1.2.4 - 2023-02-03

1.2.3 - 2022-11-28

1.2.2 - 2022-08-26

1.2.1 - 2022-08-23

1.2.0 - 2022-06-24

1.1.0 - 2022-05-25

1.0.1 - 2022-05-16

1.0.0 - 2022-02-21