Release notes

Discover the latest feature releases, product improvements and bug fixes of Kushki online payment services.

Stay up to date with changes and updates to the Kushki API.

We used the ISO 8601 standard (YYYY-MM-DD) for dates, the Semantic Versioning (MAJOR.MINOR.PATCH) for version numbers, increasing the:

1. MAJOR version when we make incompatible API changes,
2. MINOR version when we add functionality in a backward-compatible manner, and
3. PATCH version when we make backward-compatible bug fixes.

Types of changes

- NEW for new features.
- IMPROVEMENTS for changes in existing functionality.
- DEPRECATED for soon-to-be removed features.
- REMOVED for now removed features.
- FIX for any bug fixes.
- SECURITY in case of vulnerabilities.

Latest

1.8.0 - 2025-10-29

NEW

Apple Pay early documentation release 🇨🇱 🇵🇪

We’re introducing early-stage documentation for Apple Pay integration across both Kushki.js v1 and Kushki.js Hosted Fields libraries.

With this functionality, you can display Apple Pay among your customers’ payment options in supported browsers and devices.
At this stage, Apple Pay is available only for Chile and Peru, and supports Visa and Mastercard cards.

🧩 For Kushki.js Hosted Fields

Explore the new integration details:

- Apple Pay Overview

- initApplePayButton method

- ICardApplePay Interface

💻 For Kushki.js v1

- See the Kushki.js v1 library documentation for reference and setup guidance.

⚠️ This is an early release. The functionality and documentation are still in a testing phase and may change before the full rollout.

Previous release notes

1.6.5 - 2025-07-03

NEW

Card Payouts now available in Peru 🇵🇪

This release introduces support for Card Payouts through the Kushki JS Hosted Fields library — an ideal solution for merchants that are not PCI compliant.

Hosted Fields enables the secure collection of cardholder and card data using iframes hosted on Kushki's infrastructure. This approach ensures PCI compliance by isolating sensitive information from your systems.

Upon implementation, you can request two types of tokens:

- One-time payout token: For single card disbursements.
- Subscription token: For recurring payouts to a card. This returns a subscriptionId instead of a token.

> ✅ Hosted Fields is the recommended integration path for front-end environments that require secure tokenization without handling card data directly.

Check the full integration guide in the Kushki JS Hosted Fields documentation.

1.6.3 - 2025-02-21

DEPRECATED

- The DeviceTokenRequest object, which includes subscriptionId, will be deprecated in the initSecureDeviceToken method.

IMPROVEMENTS

- The requestDeviceToken method now supports the DeviceTokenRequest object, which includes subscriptionId, currency, amount, and additional parameters. Click here for more information.

1.6.2 - 2024-12-26

IMPROVEMENTS

* Updated the instructions for set up iOS library on kushki-ios-arm processors. Click here for more information.

1.6.1 - 2024-11-19

IMPROVEMENTS

* Updated the response for the requestValidate3DS() method in the Kushki.js library.

1.6.0 - 2024-08-02

NEW

* Added support for card branding animation via Kushki.js, Kushki.js Hosted Fields, Android SDK and iOS SDK integrations.
* Added error codes 21-23 for integrations via Kushki.js Hosted Fields.
* Added Security section to Kushki.js Hosted Fields library reference to group different authentication methods.
* Added Sift section in Kushki.js Hosted Fields reference for security authentications.
* Added requestInitAntiFraud method inside the Sift section.
* Added the requestBankList method to get the list of banks in transactions via transfer through Kushki.js Hosted Fields integrations.
* Added the requestBrandsByMerchant method to obtain the list of card networks available in your merchant's configuration through Kushki.js Hosted Fields integrations.
* Added the requestCommissionConfiguration method to obtain your merchant's commission configuration in Kushki.js Hosted Fields integrations.
* Added requestInitCardBrandingAnimation method to implement card branding animations in Kushki.js Hosted Fields integrations.

The following articles have also been added to the Kushki.js Hosted Fields library reference:

* SiftScienceObject
* requestBrandsByMerchant
* requestInitCardBrandingAnimation
* BrandByMerchantResponse
* MasterCardBrandingRequest
* VisaBrandingRequest
* requestBankList
* requestCommissionConfiguration
* CommissionConfigurationRequest

1.5.1 - 2024-05-30

NEW

We continue to improve our Kushki.js Hosted Fields library

You can now get the bin, card brand, expiration date, and last 4 digits of a card when generating a token for subscriptions by setting the fullResponse property to true. See additional information returned in the response.

Subscriptions section was created with every detail to generate a token for a subscription. Within the new section you will find information on how to generate a token for a recurring charge or for a one-click payment. You can also find information on how to skip CVV in a subscription.

Added the method initSecureDeviceToken to validate the CVV when making a One-click payment. Also we added information about ICardSubscriptions, CardInfo, SecureDeviceTokenOptions.

1.5.0 - 2024-04-10

NEW

One-click payments now available in kushki.js hosted fields

Securely collect and store your customers' card information for future one-click payments now available through the Kushki.js hosted fields library.

To make one-click payments follow the steps below:

Creating a subscription:

1. requestToken() (Kushki.js hosted fields library, frontend)
2. Create a subscription (API, backend)

Making a one-click payment:

1. requestDeviceToken() (Kushki.js hosted fields library, frontend)
2. Make an One-click payment (API, backend)

For more information, check the new One-click payments section.

Perform 3D Secure authentication for API integrations using Kushki.js hosted fields

You can now authenticate payments through 3D Secure if you have an API integration using the Kushki.js hosted fields library.

To authenticate payments through 3D Secure follow the steps below:

1. Get a Json Web Token (JWT).
2. Request a card token.
3. Authenticate through 3D Secure.
4. Make a charge or deferred charge.

For more information, check the new 3D Secure validation section.

See also the new requestSecureInit(), requestValidate3DS() and requestDeviceToken() methods, the SecureInitRequest, SecureInitResponse and DeviceTokenRequest interfaces.

1.4.0 - 2024-03-01

NEW

New Kushki.js Hosted Fields library

Introducing the new Kushki.js Hosted Fields library, which allows you to perform operations from your front-end to create payment flows with Kushki.

>#### Product in beta version 🔐

Find out more about this new library in Kushki.js Hosted Fields.

Presenting the new format for changes in documentation

The format has been updated for changes made to the documentation. Find the changes much easier with the types of changes separated by categories and with a different color for each one.

Now, all changes are concentrated in the release-notes file instead of having a separate file per version. You will be able to access all the changes from a single place.

The following types of changes were modified:

* Added -> NEW
* Changed -> IMPROVEMENTS
* Fixed -> FIX

Check the changes of each version with the new content menu.

IMPROVEMENTS

Improved navigation experience in the side menu which is now divided by categories.

1.3.1 - 2023-10-31

IMPROVEMENTS

- Kushki.js
- The data received through the requestSecureInit()method changed. Now receives 8-bin instead of card number.
- Updated test cases and cards for requestValidate3DS() method.

1.3.0 - 2023-09-27

NEW

- Added 3DS section in requestToken method for Android and iOS.
- Added new method requestSecureValidation for android and iOS.
- Added kushki-ios-intel and kushki-ios-arm libraries for iOS implementation.

IMPROVEMENTS

- Updated Android SDK to 1.7.0.
- Updated iOS libraries to kushki-ios-intel -> 2.6.0 and kushki-ios-arm -> 2.6.0.

DEPRECATED

- The iOS library was deprecated.

1.2.4 - 2023-02-03

IMPROVEMENTS

Replaced test card 4456540000000064 with 4456540000000063 for Transaction approved without 3DS validation scenario in Kushki.js.

1.2.3 - 2022-11-28

IMPROVEMENTS

Updated iOS SDK version to 2.4.2

1.2.2 - 2022-08-26

IMPROVEMENTS

Updated response for requestValidate3DS() and requestSecureServiceValidation() methods.

1.2.1 - 2022-08-23

NEW

3DS response example for requestDeviceToken() method in Kushki.js.

IMPROVEMENTS

Changed text from "subscriptions" to "recurring charges" in documentation.

1.2.0 - 2022-06-24

NEW

- Added requestSecureInit() method in Kushki.js library for obtaining the jwt parameter, required for 3DS authentication while consuming the Request a card token or Request a recurring charge token API methods.

1.1.0 - 2022-05-25

NEW

- 3DS and Sift support for Android SDK.
- 3DS support for Kushki.js. Added requestValidate3DS() method for One-Time Payment and card subscription.
- Eight-Digit BIN support

IMPROVEMENTS

- Android SDK upgrade to 1.4.4
- requestToken() to accept Context and Activity as parameters for 3DS and Sift.
- Updated responses for requestToken() (One-Time-Payment) and requestSubscriptionToken() (Card subscription) methods to add 3DS support.
- Kushki Android: updated getBinInfo() method description. Changed "first six digits" to "first eight digits".
- Kushki iOS: updated getCardInfo() method description. Changed "first six digits" to "first eight digits".
- Kushki.js:
- updated requestBinInfo() method description. Changed "first six digits" to "first eight digits".
- Updated requestDeferred() method example with 8-digit bin.

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 wants

Release notes

Release notes#

Types of changes#

Latest#

Apple Pay early documentation release 🇨🇱 🇵🇪#

🧩 For Kushki.js Hosted Fields#

💻 For Kushki.js v1#

Previous release notes#

1.6.5 - 2025-07-03#

Card Payouts now available in Peru 🇵🇪#

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#

We continue to improve our Kushki.js Hosted Fields library#

1.5.0 - 2024-04-10#

One-click payments now available in kushki.js hosted fields#

Perform 3D Secure authentication for API integrations using Kushki.js hosted fields#

1.4.0 - 2024-03-01#

New Kushki.js Hosted Fields library#

Presenting the new format for changes in documentation#

The side menu has been restructured by categories for better navigation#

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 #

Release notes

Types of changes

Latest

Apple Pay early documentation release 🇨🇱 🇵🇪

🧩 For Kushki.js Hosted Fields

💻 For Kushki.js v1

Previous release notes

1.6.5 - 2025-07-03

Card Payouts now available in Peru 🇵🇪

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

We continue to improve our Kushki.js Hosted Fields library

1.5.0 - 2024-04-10

One-click payments now available in kushki.js hosted fields

Perform 3D Secure authentication for API integrations using Kushki.js hosted fields

1.4.0 - 2024-03-01

New Kushki.js Hosted Fields library

Presenting the new format for changes in documentation

The side menu has been restructured by categories for better navigation

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