1. Libraries & SDKs (Online Payments)
  • Home Page
  • Libraries & SDKs (Online Payments)
    • Release notes
    • Mobile
      • Kushki Android
      • Kushki iOS 
      • Kushki iOS ARM Setup
    • Web
      • Kushki.js 🌐
      • kushki.js-hosted-fields
        • kushki.js Hosted Fields
        • Guía de migración a Kushki.js 2.0
        • Antifraud
          • Interfaces
            • SecureInitRequest
            • SecureInitResponse
            • SiftScienceObject
          • Methods
            • requestInitAntiFraud
            • requestSecureInit
            • requestValidate3DS
        • Card
          • CarApplePay interface
            • ICardApplePay Interface
          • Card-Interface
            • ICard Interface
            • ICardSubscriptions Interface
          • Errors
            • Error list
          • Interfaces
            • Amount
            • ApplePayGetTokenOptions Interface
            • ApplePayOptions Interface
            • ApplePayPaymentContact
            • AppleTokenResponse
            • BrandByMerchantResponse Interface
            • CardFieldValues
            • CardInfo
            • CardOptions
            • CardTokenResponse
            • DeferredByBinOptionsResponse
            • DeferredInputValues
            • DeferredValuesResponse
            • DeviceTokenRequest
            • Field
            • FieldInstance
            • Fields
            • FieldValidity
            • FormValidity
            • MasterCardBrandingRequest
            • SecureDeviceTokenOptions
            • Styles
            • TokenResponse
            • VisaBrandingRequest
          • Methods
            • initApplePayButton
            • initCardToken
            • initSecureDeviceToken
            • requestBrandsByMerchant method
            • requestDeviceToken method
            • requestInitCardBrandingAnimation
          • Types
            • CssProperties
            • Currency
            • FieldTypeEnum
        • Card Payouts
          • Card Payouts Interface
            • ICardPayouts
          • Enumerations
            • Enumeration `InputModelEnum`
          • Errors
            • Errors
          • Interfaces
            • CardPayoutOptions
            • CardPayoutSubscriptionTokenResponse
            • CardPayoutUniqueTokenResponse
            • Field
            • Fields
            • FieldValidity
            • Interface FormValidity
            • Interface `Styles`
          • Methods
            • initCardPayoutToken
          • Type Aliases
            • CardPayoutTokenResponse
            • InputTypeEnum
          • Types
            • CssProperties
        • Kushki
          • Methods
            • init function
            • requestBankList function
            • requestCommissionConfiguration function
          • Classes
            • KushkiError
          • Interfaces
            • CommissionConfigurationRequest
            • IKushki
            • KushkiOptions
Bienvenida
Perú 🇵🇪México 🇲🇽Ecuador 🇪🇨Colombia 🇨🇴Chile 🇨🇱
Bienvenida
Perú 🇵🇪México 🇲🇽Ecuador 🇪🇨Colombia 🇨🇴Chile 🇨🇱
  1. Libraries & SDKs (Online Payments)

Release notes

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.3 - 2026-05-20
NEW

Apple Pay for subscriptions 🇨🇱 🇵🇪 🇲🇽#

Apple Pay now supports subscription (recurring) payments in both Kushki.js v1 and Kushki.js Hosted Fields libraries.
With this update, merchants can generate a subscription token via the Apple Pay flow by passing the isSubscription flag to requestApplePayToken. This token is used to create a recurring charge through Kushki's subscription API.
At this stage, Apple Pay subscriptions are available only for Chile, Peru, and Mexico, and support Visa and Mastercard cards.

🧩 For Kushki.js Hosted Fields#

Apple Pay — Subscription example
requestApplePayToken — see isSubscription field
ApplePayGetTokenOptions — new isSubscription property

💻 For Kushki.js v1#

Apple Pay — Recurring Charges — new Apple Pay tab
requestApplePayToken — see isSubscription field

What's new#

isSubscriptionNew optional boolean field in requestApplePayToken. Set to true to generate a subscription token instead of a one-time payment token.
Note
This functionality is still in a testing phase and may change before the full rollout.

Previous release notes#

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.
Note
This is an early release. The functionality and documentation are still in a testing phase and may change before the full rollout.

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.
See also the updated error list.

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

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 want.
Modified at 2026-06-26 21:24:31
Previous
Libraries & SDKs (Online Payments)
Next
Kushki Android
Built with