Release notes

Learn about the latest updates to our API, and Drop-in/Components for web, iOS, and Android.

This page contains the release notes for Pay by Link, Checkout API, and Drop-in/Components for web, iOS, Android, React Native, and Flutter starting from 2020.

Get updates by RSS
Filter by
Web Components/Drop-in
Version...
March 2025
SunMonTueWedThuFriSat
1
2345678
9101112131415
16171819202122
23242526272829
3031
Select dates
Copy url
icon
Web Components/Drop-in v6.11.0

This release requires Checkout API v69 or later. We recommend that you use the latest version of Checkout API.

Improved
  • For cards, when the shopper enters their card number in the Card number field, the length of the card number is no longer restricted based on the Bank Identification Number (BIN).
Fixed
  • For Apple Pay in apps that use server-side rendering: the iframe detection code no longer crashes when rendering. This fixes the known issue from v6.10.0.
  • For cards, when you select the icon for an inoput field, the corresponding field now correctly gets the focus state.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@6.11.0

Copy url
icon
Web Components/Drop-in v6.10.0

This release requires Checkout API v69 or later. We recommend that you use the latest version of Checkout API.

New
Fixed
  • For Drop-in, when using Google Pay as an instant payment type, the challengeWindowSize is now handled correctly.
  • Fixed Brazilian social security number translation (CPF/CNPJ) for different languages.
  • Fixed an issue where the exposed types for Google Pay and Apple Pay were not being found.
Improved
  • For single branded cards, the error message shown to when there configuration is incorrect is updated.
  • Improved the contrast, aria-expand attribute for radio buttons, and SVG alt descriptions to follow a11y guidelines.
  • For Google Pay, an error is thrown when the configuration is missing the required merchant ID.
Known issues
  • For Apple Pay in apps that use server-side rendering: the iframe detection code crashes when rendering. Fixed in v6.11.0.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@6.10.0

Copy url
icon
Web Components/Drop-in v6.9.0

This release requires Checkout API v69 or later. We recommend that you use the latest version of Checkout API.

New
Improved
  • When the shopper selects the Pay button, the Open Invoice and ACH Components become disabled.
  • For Boleto: additional properties have been added to the BoletoConfiguration TypeScript interface.
  • For cards: the onAutoComplete type has been added to the CustomCardConfiguration type.
  • For Google Pay: the challengeWindowSize type has been added to the GooglePayComponent TypeScript interface.
Fixed
  • For Google Pay: when you call reject on the onClick event, an unhandled exception can no longer be triggered.
  • For gift cards: when the shopper pays with a second gift card the UI no longer becomes unresponsive.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@6.9.0

Copy url
icon
Web Components/Drop-in v6.8.0

This release requires Checkout API v69 or later. We recommend that you use the latest version of Checkout API.

Known issues
  • Style issues no longer occur due to font scaling, because rem is now used for the font size unit.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@6.8.0

Copy url
icon
Web Components/Drop-in v5.71.2

This release requires Checkout API v69 or later. We recommend that you use the latest version of Checkout API.

Fixed
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.71.2

Copy url
icon
Web Components/Drop-in v6.7.0

This release requires Checkout API v69 or later. We recommend that you use the latest version of Checkout API.

Improved
  • Added tracking for API errors for internal endpoints for analytics purposes.
  • During the process of handling the payment response, Drop-in/Components no longer makes a duplicated internal API request.
  • For the Custom Card Component, TypeScript types for configuration parameters are now more explicitly declared.
Fixed
  • For cards, the styling for the confirmation message to remove a stored card no longer causes responsiveness issues.
  • For Click to Pay, button elements that appeared as links now appear as buttons.
  • For Google Pay, when the value of the GooglePayButton attribute buttonRadius is 0, it no longer fails to be passed to the createButton function.
  • The Klarna Component now initializes the Klarna Widget SDK correctly. This fixes the known issue from v6.6.0.
  • For Trustly, missing translations have been added.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@6.7.0

Copy url
icon
Web Components/Drop-in v6.6.0

This release requires Checkout API v69 or later. We recommend that you use the latest version of Checkout API.

Known issues
  • The Klarna Component encounters an error when initializing the Klarna Widget SDK. Fixed in v6.7.0.
New
  • For the online banking payment methods in Slovakia and the Czech Republic, bank logo icons now appear in the list of banks.
Improved
  • For WeChat Pay QR codes, updated the text indicating the time left to pay for the zh-CN locale.
  • For ACH Direct Debit, removed the text under the Account holder name field.
  • When you set the Country and State fields to required in the payment form, the setting now correctly applies to the fields.
  • For donations, the nonprofit logo and description no longer cover the donation banner, and the banner now maintains it's aspect ratio when scaling according to the shopper's screen size.
Fixed
  • For cards, when the card is detected in the Card number field,
  • When multiple variants of Klarna are available in the payment methods list, you can now make sure that the payment is made with the correct variant with the new activate() method.
    • For Drop-in: this happens automatically.
    • For Components: you must call active() when the shopper selects a variant of Klarna.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@6.6.0

Copy url
icon
Web Components/Drop-in v6.5.1

This release requires Checkout API v69 or later. We recommend that you use the latest version of Checkout API.

Fixed
  • For cards, when the expiryDate is only one digit, the onBlur validation now gets triggered.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@6.5.1

Copy url
icon
Web Components/Drop-in v6.5.0

This release requires Checkout API v69 or later. We recommend that you use the latest version of Checkout API.

Improved
  • For PayMe, when the shopper pays, the UI shows instructions to complete the transaction.

  • For PayNow, when the shopper pays on a tablet or mobile device, the UI now shows instructions to complete the transaction.

Fixed
  • When creating a production build, the auto.js code is no longer tree-shaken by bundlers.
  • For integrations using the address lookup feature for cards: the State or province field no longer resets when the shopper selects a value for the Country field.
  • The Iceland Krona currency (ISK) now correctly uses minor units.
  • For UPI, the initial value for isValid is now true only for UPI QR.
  • To support earlier iOS versions, the ECMAScript version is now the 2020 version.
  • For Payconiq, the UI now includes instructions for the QR code, and an unused button label is now removed.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@6.5.0

Copy url
icon
Web Components/Drop-in v5.71.1

This release requires Checkout API v69 or later. We recommend that you use the latest version of Checkout API.

Fixed
  • For integrations using the address lookup feature for cards: the State or province field no longer resets when the shopper selects a value for the Country field.
  • For UPI, the default value for isValid is now true only for UPI QR.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.71.1

Copy url
icon
Web Components/Drop-in v6.4.0

This release requires Checkout API v69 or later. We recommend that you use the latest version of Checkout API.

New
  • All action types now trigger the onActionHandled callback.
    • For all action types, except for threeds2, the original action object is passed to the callback.
  • For ACH, the shopper can now select the Savings or Checking account type.
Improved
  • For improved developer experience, we now export the CustomTranslations type.
  • document.querySelector is now called only once, instead of three times.
Fixed
  • get-process-message.handler.js no longer causes exceptions. The new optional chaining operator for the postMessage handler function now prevents improperly formed events.
  • When you call actions.reject() in the beforeSubmit callback, the UI no longer set the UI in an error state. Previously, it caused a call to handleFailedResult, which caused the onPaymentFailed callback to be called and set the UI in an error state.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@6.4.0

Copy url
icon
Web Components/Drop-in v5.71.0

This release requires Checkout API v69 or later. We recommend that you use the latest version of Checkout API.

New
  • For ACH, the shopper can now select the Savings or Checking account type.
Fixed
  • get-process-message.handler.js no longer causes exceptions. The new optional chaining operator for the postMessage handler function now prevents improperly formed events.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.71.0

Copy url
icon
Web Components/Drop-in v6.3.0

This release requires Checkout API v69 or later. We recommend that you use the latest version of Checkout API.

Improved
  • For Pay by Bank payments in the US, the payment form now shows US bank logos.
  • For Click to Pay with Visa, custom timeouts now get reported to the Visa SDK.
Fixed
  • For Click to Pay with Visa, when the shopper selects Enter, the event no longer propagates to other views.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@6.3.0

Copy url
icon
Web Components/Drop-in v5.70.0

This release requires Checkout API v69 or later. We recommend that you use the latest version of Checkout API.

Improved
  • For Pay by Bank payments in the US, the payment form now shows US bank logos.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.70.0

Copy url
icon
Web Components/Drop-in v5.69.1

This release requires Checkout API v69 or later. We recommend that you use the latest version of Checkout API.

Improved
  • For Click to Pay with Visa, custom timeouts now get reported to the Visa SDK.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.69.1

Copy url
icon
Web Components/Drop-in v5.69.0
Improved
  • For Drop-in, when loading, payment methods that are not supported are filtered out before the individual payment method Components are created.
  • When loading, during the internal setup requests, the browserInfo information is included.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.69.0
Changed

Copy url
icon
Web Components/Drop-in v6.2.0

This release requires Checkout API v69 or later. We recommend that you use the latest version of Checkout API.

Improved
  • When loading, during the internal setup requests, the browserInfo information is included.
  • For Drop-in, when loading, payment methods that are not supported are filtered out before the individual payment method Components are created.
  • For Apple Pay, the ApplePaySession property is now optional in the Window interface.
Fixed
  • For Apple Pay, ApplePayService no longer causes reliability issues with SonarCloud.
  • Projects that use webpack 4 can now directly import styles from the adyen.css file.
  • For cards, the Enter key now correctly triggers validation and submission. Previously, a regression issue prevented the actions from being triggered.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@6.2.0
Changed

Copy url
icon
Web Components/Drop-in v6.1.1
Improved
  • Removed the unused region role from the payment method item to follow a11y guidelines.
Fixed
  • Fixed validation for Lithuanian postal codes to support inputs with 4 digits, 5 digits, and the LT prefix.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@6.1.1

Copy url
icon
Web Components/Drop-in v5.68.1
Improved
  • Removed the unused region role from the payment method item to follow a11y guidelines.
Fixed
  • Fixed validation for Lithuanian postal codes to support inputs with 4 digits, 5 digits, and the LT prefix.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.68.1

Copy url
icon
Web Components/Drop-in v6.1.0

This release requires Checkout API v69 or later. We recommend that you use the latest version of Checkout API.

New
  • For ANCV, after the shopper makes a partial payment, the ANCV ID and deducted balance is shown on the screen where they select the payment method for the remaining balance.
Improved
  • Updated currency information for the following locales:
    • Iceland (ISK)
    • Bulgaria (BGN)
Fixed

For stored cards, the holder name is now correctly passed when making the payment.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@6.1.0

Copy url
icon
Web Components/Drop-in v5.68.0

This release requires Checkout API v69 or later. We recommend that you use the latest version of Checkout API.

New
  • For ANCV, after the shopper makes a partial payment, the ANCV ID and deducted balance is shown on the screen where they select the payment method for the remaining balance.
Fixed

For stored cards, the holder name is now correctly passed when making the payment.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.68.0

Copy url
icon
Web Components/Drop-in v6.0.3
New
  • For Riverty, the consent checkbox now includes a link to the Riverty privacy policy.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@6.0.3

Copy url
icon
Web Components/Drop-in v5.67.1
New
  • For Riverty, the consent checkbox now includes a link to the Riverty privacy policy.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.67.1

Copy url
icon
Web Components/Drop-in v6.0.2

This release requires Checkout API v69 or later. We recommend that you use the latest version of Checkout API.

Fixed

For UPI, the TypeScript type error for formatProps has been fixed.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@6.0.2

Copy url
icon
Web Components/Drop-in v6.0.1

This release requires Checkout API v69 or later. We recommend that you use the latest version of Checkout API.

Fixed

For PayPal, the bug where the payment didn't get finalized after the PayPal lightbox closed no longer occurs.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@6.0.1

Copy url
icon
Web Components/Drop-in v6.0.0

This release requires Checkout API v69 or later. We recommend using the latest Checkout API version.

Breaking Changes

General

  • Drop-in/Components is no longer supported on Internet Explorer 11.
  • If you integrate with npm, we've changed how you import Drop-in/Components to reduce the bundle size.
  • If you integrate with embedded scripts, we changed how we expose the AdyenCheckout and Drop-in/Components on the window object.
  • We've changed how you create an instance of Drop-in or Component.
  • For the onSubmit() event handler, you now need to resolve/reject an actions object to continue or halt the payment flow.
  • For the onAdditionalDetails() event handler, you now need to resolve/reject an actions object to continue or halt the payment flow.
  • The onPaymentCompleted() event is no longer triggered for failed payments, instead the onPaymentFailed() event is triggered.
  • The showPayButton parameter now defaults to true.
  • The onValid() event is removed.
  • The setStatusAutomatically property is no longer supported. If a payment is successful or if it fails, the component is kept in loading state and merchant must handle it accordingly.
  • We've changed how you style Drop-in/Components to give you more fine-grained control by using custom CSS properties. Update your CSS styles accordingly.
  • The countryCode property is now mandatory. It must be set directly in the AdyenCheckout configuration object, or in the /sessions request.
  • The showFormInstruction property is no longer supported.
  • When instantiating AdyenCheckout, you can no longer set the configuration property 'installmentOptions'. It must be set in the Card Component configuration instead.
  • You can no longer set the configuration property paymentMethodsConfiguration when initializing AdyenCheckout. Instead, set it in the Drop-in configuration.
  • The locale in your global configuration object must follow the xx-YY format, where xx specifies the language, and YY specifies the region. Locales that are not formatted correctly will be ignored and fallback to en-US. See all supported locales on our GitHub.
    Exception: For Arabic, the locale must be set to ar.
  • TypeScript types are now imported directly from the root of the package, for example:
    Copy code
    import type { CardConfiguration } from '@adyen/adyen-web';

Payment method specific

Express payment methods

  • For Google Pay express, the event handler onPaymentDataChanged now works only when the Component configuration property isExpress is set to true.
  • For Apple Pay express, the event handlers onShippingContactSelected and onShippingMethodSelected now work only when the Component configuration property isExpress is set to true.
  • For Paypal Express, the onShippingChange() event handler is no longer supported. Migrate to the onShippingAddressChange() and onShippingOptionsChange() event handlers.
  • The onShopperDetails() event for PayPal is renamed to onAuthorized() and it must be resolved or rejected to finalize the payment.
  • For Google Pay, the isAvailable() method does not return a boolean flag anymore. Instead, the promise is resolved when the payment is available and rejected otherwise.

Card payment methods

  • The Card Component configuration property showBrandsUnderCardNumber is no longer supported.
  • The challengeWindowSize configuration parameter can now be set in the card object within paymentMethodsConfiguration instead of the threeDS2 object.
  • The Custom Card Component is renamed from securedfields to CustomCard and created as:
    Copy code
    new CustomCard()

Other payment methods

  • For PayPal, the onCancel() event handler is no longer supported. To detect when the PayPal lightbox is closed, listen to the onError event with error type CANCEL.
  • For Klarna, the token property is replaced with the authorization_token from the /payments/details request.
  • For Adyen Giving, you now need to integrate with the Giving Campaign Manager Component.
  • We no longer support the payment method QiwiWallet.

Partial payments

New
  • onPaymentMethodsRequest() is a new event, which is triggered when a partial payment is made and the associated order isn't fully paid. Use the even handler to request payment methods for a new payment.
  • onPaymentFailed() is a new event, which is triggered when a payment fails. Previously, this event was part of onPaymentCompleted().
  • You can now disable the final animation after a successful or failed payment in Drop-in, by setting disableFinalAnimation to true.
  • Shoppers can now confirm the payment by pressing the Enter key. If the payment has a validation issue, an error is shown in the Drop-in/Components interface.
    • You can customize, or prevent, the Enter keypress behavior by implementing an onEnterKeyPressed() event handler on AdyenCheckout.
  • Support for six more locales: Catalan (ca-ES), Icelandic (is-IS), Bulgarian (bg-BG), Estonian (et-EE), Latvian (lv-LV) and Lithuanian (lt-lT).
  • Support for Apple Pay Order tracking in Drop-in and in the Apple Pay Component.
  • Support for tree shaking when integrating through npm.
Changed
  • onPaymentCompleted() now works for both Sessions and Advanced flow.
  • We have replaced input field placeholder texts with permanently visible contextual elements to enhance the accessibility and UX. You can still apply and customize placeholders.
  • For Google Pay and Apple Pay, the onAuthorized event is now triggered before the onSubmit event. The onAuthorized event must be resolved in order to proceed with the payment flow.
  • We have improved AVS checks for GooglePay and ApplePay by adding the billing address to state.data if available during payment method authorization.
  • Drop-in no longer uses radio buttons by default.
  • The WeChatPay timer now defaults to 30 minutes.
Updating to this version

Install this version of the Adyen Drop-in/Components Node.js package:

Copy code
npm install @adyen/adyen-web@6.0.0 --save

Copy url
icon
Web Components/Drop-in v5.67.0

This release requires Checkout API v68 or later.

New
  • For the Card Component, the info event now has the configData object that includes details about the configuration of the Component.
  • Google Pay now supports the borderRadius property.
Fixed

For installments, the text above the radio buttons or dropdown menu now shows correctly.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.67.0

Copy url
icon
Web Components/Drop-in v5.66.1

This release requires Checkout API v68 or later.

Improved
  • For the Sessions flow: when a fatal error occurs while setting up the session, the onError callback now includes the full error object. Previously, it included only a hard-coded error message.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.66.1

Copy url
icon
Web Components/Drop-in v5.66.0

This release requires Checkout API v68 or later.

New
  • Support for the UPI Intent flow, where the shopper on a mobile device can choose a UPI app to pay through. They are redirected to and complete the payment on the selected app.
Fixed
  • For Click to Pay, previously used cards now shown above newly created cards.
  • For ACH, the showPayButton configuration is no longer ignored.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.66.0

Copy url
icon
Web Components/Drop-in v5.65.0

This release requires Checkout API v68 or later.

New
  • The new iDEAL payment flow where the shopper is redirected to the iDEAL payment page to select their bank and authorize the payment.
Improved
  • For 3D Secure 2, the analytics events now include the following information:
    • subType: the type of event.
    • result: the outcome of the event.
  • For Google Pay, when the shopper pays with card, the state.data now includes the origin to trigger the 3D Secure 2 native flow.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.65.0

Copy url
icon
Web Components/Drop-in v5.64.0

This release requires Checkout API v68 or later.

Fixed
  • For open invoice payment methods:
    • When the shopper selects and deselects the consent checkbox, the Uncaught TypeError: Cannot use 'in' operator to search for 'errorI18n' in true error no longer occurs.
    • Errors related to the screen reader panel no longer causes issues with the logic of the OpenInvoice Component.
  • For ANCV, a new order is no longer created when it is used as the second payment of a partial payment. The custom payButton now submits the correct data.
New
  • When the shopper checks out, the checkoutAttemptIdobject is now always passed in the initial API request.
  • For cards, the unencrypted expiry date can now be passed to the onFieldValid callback. To enable this, set exposeExpiryDate to true.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.64.0

Copy url
icon
Web Components/Drop-in v5.63.0

This release requires Checkout API v68 or later.

Changed
  • For the phone number field in the payment form:
    • The Country selector for the phone number field is now called Country/Region.
    • Flag icons are no longer included in the selector.
Fixed
  • For voucher payment methods, the voucher now shows expiration the date and time.
  • For wallet payment methods used as express payment methods, the function to submit analytics now works as expected.
  • Drop-in no longer fails to render when only express payment methods are available.
Updating to this version

Upgrading to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.63.0

Copy url
icon
Web Components/Drop-in v5.62.0

This release requires Checkout API v68 or later.

Improved

For cards, the shopper can now enter a 19-digit Diners card number.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.62.0

Copy url
icon
Web Components/Drop-in v5.61.0

This release requires Checkout API v68 or later.

New
  • For analytics and data tracking, the information collected now includes data about whether wallet payment methods are used as express payment methods.
Improved
  • For the address fields of the payment form, the forward slash character (/) is now allowed.
Fixed
  • For open invoice payment methods (like Riverty), the SRPanel for screen readers now correctly includes the first name and last name fields in the delivery address.
  • For combobox UI elements, when nothing is selected, aria-activedescendant is now null.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.61.0

Copy url
icon
Web Components/Drop-in v5.60.0

This release requires Checkout API v68 or later.

Fixed
  • For cards, Boleto, and ACH: when making the /payments request, the billingAddress.firstName and billingAddress.lastName parameters are no longer included.
  • For the Sessions flow: when making a zero-auth transaction (amount: 0) the payment details are stored only when the storePaymentMethodMode parameter in the /sessions request is set to do so. This fixes the known issue from v5.59.0.
Improved
  • For Apple Pay: you no longer get warnings in your integrated development environment (IDE) because of TypeScript type issues.
  • For cards: the shopper can now enter a Discover card number with the length of 19 digits.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.60.0

Copy url
icon
Web Components/Drop-in v5.59.0

This release requires Checkout API v68 or later.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.59.0
Fixed

When making a zero-auth transaction (amount: 0) to store payment details, we now always pass the storePaymentMethod object to our server.

Known issues
  • For the Sessions flow: if your /sessions request included either enableRecurring or enableOneClick, making a zero-auth transaction fails.
  • For the Advanced flow: if your /payments request included either enableRecurring or enableOneClick, making a zero-auth transaction fails.
New

Copy url
icon
Web Components/Drop-in v5.58.0
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.58.0
New
  • New payment method: Online Banking Finland. Payment method type: ebanking_FI.
  • Support for the new Riverty component (riverty) in AT, CH, and DE. This component will replace afterpay_default in the future.
  • For Drop-in, when countryCode is set to FI, no payment method is selected by default and all payment methods are collapsed to comply with Finnish regulations.
Fixed
  • Fixed an issue where clicking on Card fields caused console errors for shoppers using an iOS device.

Copy url
icon
Web Components/Drop-in v5.57.0
Improved
  • For Blik, the Drop-in/Component now shows identifiers next to stored payment methods.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.57.0--save

Copy url
icon
Web Components/Drop-in v5.56.1

This release requires Checkout API v68 or later.

Improved
  • For card, when making a zero-auth transaction:
    • The text on the pay button is now Save details.
    • A checkbox no longer shows.
  • For Drop-in, after a zero-auth transaction, the text for the success message is Details saved.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.56.1--save

Copy url
icon
Web Components/Drop-in v5.56.0

This release requires Checkout API v68 or later.

New

Payment method: PayMe. Payment method type: payme.

Improved
  • For QR code payment methods, the payment status check now calculates elapsed time more accurately.
  • For the custom card integration with encryption, the Component now gives a console warning for an unsupported value in the data-cse attribute.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.56.0--save

Copy url
icon
Web Components/Drop-in v5.55.1

This release requires Checkout API v68 or later.

Fixed

For QR code payment methods, the payment method logo now loads and shows correctly.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.55.1 --save

Copy url
icon
Web Components/Drop-in v5.55.0

This release requires Checkout API v68 or later.

Improved

For cards, the startup log includes more detailed information that can be used to debug issues.

Updating to this version

Upgrading to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.55.0--save

Copy url
icon
Web Components/Drop-in v5.54.0

This release requires Checkout API v68 or later.

New
  • For the card Component: the address lookup feature now includes the new onAddressSelected callback to handle additional information for address completion services that require a second callback, like Google Place Autocomplete API.
  • For Click to Pay, if the shopper gives consent, you can now enable the cookie for Mastercard and Visa.
Improved
  • For Click to Pay, the loading image is now an animated SVG file.
Fixed
  • For Drop-in:
    • Payment methods that are not cards no longer include the fundingSource object with credit or debit.
    • For Klarna B2B, the logo is now correct.
  • For redirect payment methods, the browserInfo parameter is now included in the state.data. Previously, some redirect payment methods didn't work on mobile.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.54.0 --save

Copy url
icon
Web Components/Drop-in v5.53.3

This release requires Checkout API v68 or later.

Fixed
  • For Riverty, in the space for the consent checkbox:
    • The link for payment conditions now correctly goes to the terms and conditions.
    • For AfterPay, the terms and condition box now shows Riverty as the payment method name. .
  • For AfterPay B2B, the consent checkbox is now removed.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.53.3 --save

Copy url
icon
Web Components/Drop-in v5.53.2

This release requires Checkout API v68 or later.

Fixed

Types are resolved when using different moduleResolution values within the Typescript config.

Improved

Payment methods that show a QR code and redirect button in checkout now show the redirect button before the QR code image.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.53.2 --save

Copy url
icon
Web Components/Drop-in v5.53.1

This release requires Checkout API v68 or later.

Fixed

A Typescript issue with the paymentMethodConfiguration object types.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.53.1 --save

Copy url
icon
Web Components/Drop-in v5.53.0

This release requires Checkout API v68 or later.

New

Payment method variant:

Fixed
  • For SEPA, accessing component.data, no longer causes a crash. The properties ibanNumber and ownerName are now automatically populated with empty strings.
  • For Click to Pay, the button to resend the confirmation code now works.
  • The paymentMethodConfiguration typescript definition no longer causes a linter warning.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.53.0 --save

Copy url
icon
Web Components/Drop-in v5.52.0

This release requires Checkout API v68 or later.

New

Adds support for the payment method ANCV.

Improved
  • Timeouts on SecuredFieldsProvider are now reset after unmounting the Component. This avoids an error when mounting and immediately unmounting.
Fixed
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.52.0 --save

Copy url
icon
Web Components/Drop-in v5.51.0

This release requires Checkout API v68 or later.

New

If Drop-in or Component is inside of an iframe element on your website, you can now configure redirects to be performed on the top level window. To do this, set redirectFromTopWhenInIframe to true.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.51.0 --save

Copy url
icon
Web Components/Drop-in v5.50.1

We recommend you use Checkout API v70 or later.

Improved
  • Added additional safety checks to validate the user input when shoppers use co-badged cards.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.50.1 --save

Copy url
icon
Web Components/Drop-in v5.50.0

This release requires Checkout API v68 or later.

Changed

For Bancontact cards, the paymentMethod.type is now bcmc. Previously, it was scheme.

Fixed

If there's no expiry date included for a stored card, the payment form no longer shows the Expiry date field. Previously, it showed undefined/undefined.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.50.0 --save

Copy url
icon
Web Components/Drop-in v5.49.6

This release requires Checkout API v68 or later.

Fixed

For cards, the storeDetails property is no longer mistakenly set to true in some cases.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.49.6 --save

Copy url
icon
Web Components/Drop-in v5.49.5

This release requires Checkout API v68 or later.

Fixed

An error no longer causes the Postal Code field for some regions to accept zero characters, leading to failed validation.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.49.5 --save

Copy url
icon
Web Components/Drop-in v5.49.4

This release requires Checkout API v68 or later.

Improved
  • If you opt out of sending telemetry data and set analytics.enabled to false, the paymentMethod.checkoutAttemptId is set to do-not-track.
  • Internal refactoring for some of the payment form inputs to improve the Typescript type safety.
Fixed

When a page has more than one Card Component, the cvcPolicy and expiryDatePolicy properties can no longer be overwritten.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.49.4 --save

Copy url
icon
Web Components/Drop-in v5.49.3

This release requires Checkout API v68or later.

Fixed
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.49.3 --save

Copy url
icon
Web Components/Drop-in v5.49.2

This release requires Checkout API v68 or later.

Improved
  • For Trustly, some text that describes payment method is shown above the Continue button.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.49.2 --save

Copy url
icon
Web Components/Drop-in v5.49.1

This release requires Checkout API v68 or later.

Fixed
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.49.1 --save

Copy url
icon
Web Components/Drop-in v5.49.0

This release requires Checkout API v68 or later.

Fixed
  • For the Advanced flow, if the update function changes the available payment methods, the payment method list reloads and shows the new payment methods.
  • The aria-labelledby tag is no longer duplicated, so screen readers no longer read the tag twice.
  • For Klarna, Drop-in no longer gets stuck in the loading state.
Improved

For card payments, if Click to Pay doesn't load after 5 seconds, the card payment form is loaded and shown instead.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.49.0 --save

Copy url
icon
Web Components/Drop-in v5.48.0

This release requires Checkout API v68 or later.

Improved
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.48.0 --save

Copy url
icon
Web Components/Drop-in v5.47.0

This release requires Checkout API v68 or later.

New

By default, input fields that aren't required now have indicators to show that they aren't required. To turn off the indicators, set showFormInstruction to false.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.47.0 --save

Copy url
icon
Web Components/Drop-in v5.46.1

This release requires Checkout API v68 or later.

Improved
Fixed
  • For 3D Secure 2, authentication no longer fails because of threeDSServerTransID validation. Previously, some payments failed authentication because of a false mismatch of the threeDSServerTransID.
  • For the Sessions flow, telemetry data now includes payment currency and amount.
  • For QR code payment using Drop-in, the screen reader can now read information about payment status.
  • The SRPanel for screen readers is no longer duplicated.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.46.1 --save

Copy url
icon
Web Components/Drop-in v5.46.0

This release requires Checkout API v68 or later.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.46.0 --save

Copy url
icon
Web Components/Drop-in v5.45.0

This release requires Checkout API v68 or later.

Changed
Improved
  • Postal code input fields now includes regex validation that accepts hyphens between the 5th and 6th digits for Brazilian postal codes.
Fixed
  • For gift cards, when you use a custom brand logo, it now shows correctly.
  • When using Drop-in in an iframe element, Apple Pay no longer causes Drop-in to crash.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.45.0 --save
New

You can now enable suggesting billing addresses when the shopper starts to enter their address in the payment form. Implement the new onAddressLookup function.


Copy url
icon
Web Components/Drop-in v5.44.0

This release requires Checkout API v68 or later.

New

Payment method: Cash App Pay. Payment method type: cashapp.

Improved

For QR codes, the countdown timer can now be read by screen readers.

Fixed

For screen readers:

  • Drop-down menus options can now be read accurately.
  • Payment method names in the Drop-in payment methods list now get read once. Previously, payment method names were read twice.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.44.0 --save

Copy url
icon
Web Components/Drop-in v5.43.1

This release requires Checkout API v68 or later.

Improved
  • For cards, if you set the installmentOptions property in the global configuration object, you now get a warning message.
  • For Drop-in, if you set a payment method specific configuration property in the global configuration object, you now get a warning message.
  • For Components, if you try to create an unrecognized payment method Component, you now get an error message.
Fixed
  • The SRPanel for screen readers now has the static type of srPanel. Previously the _id property was undefined.
  • The CoreOptions object now includes types that were previously missing.
  • Screen readers can now read the alt text for brand logos. Previously the aria-hidden attribute prevented this.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.43.1 --save

Copy url
icon
Web Components/Drop-in v5.43.0

This release requires Checkout API v68 or later.

Improved
  • For cards, the onBinLookup event now additionally contains paymentMethodVariant that specifies the card brand variant.
  • For SEPA, the owner name and IBAN number fields now include labels to follow a11y guidelines.
Fixed
  • Images no longer fail to load and cause a crash. This fixes the known issue from v5.41.0 to v5.42.1.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.43.0 --save

Copy url
icon
Web Components/Drop-in v5.42.1

This release requires Checkout API v68 or later.

Fixed

On the Safari browser v16.4 or earlier, the payment form no longer shows errors when validating email address. This fixes the known issue from v5.42.0.

Known issues
  • The Custom card, SEPA and Redirect Components receive getImage errors when retrieving brand or validation icons. Fixed in v5.43.0.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.42.1 --save

Copy url
icon
Web Components/Drop-in v5.42.0

This release requires Checkout API v68 or later.

New
  • The PayPal component now supports Venmo.
Fixed
  • Client-side email address validation is improved.
  • The screen readers now communicate errors regarding client-side email address validation.
  • The GetImage property no longer causes a crash of the custom card Component.
  • The typing of the BrowserInfo object has been fixed.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.42.0 --save
Known issues
  • The Custom card, SEPA and Redirect Components receive getImage errors when retrieving brand or validation icons. Fixed in v5.43.0.
  • On the Safari browser v16.4 or earlier, the payment form shows errors when validating email addresses. Fixed in v5.42.1.

Copy url
icon
Web Components/Drop-in v5.41.0

This release requires Checkout API v68 or later.

Improved
  • The way images and assets are loaded internally. This shouldn't affect the code in your integration.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.41.0 --save
Known issues
  • The Custom card, SEPA and Redirect Components receive getImage errors when retrieving brand or validation icons. Fixed in v5.43.0.
  • On the Safari browser v16.4 or earlier, the payment form shows errors when validating email addresses. Fixed in v5.43.0.

Copy url
icon
Web Components/Drop-in v5.40.1

This release requires Checkout API v68 or later.

Fixed
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.40.1 --save

Copy url
icon
Web Components/Drop-in v5.40.0

This release requires Checkout API v68 or later.

New

For online banking payment methods, terms and conditions now show above the Continue button.

Fixed

In the payment form:

  • Address input fields now accept the dash (-) character.
  • Labels for input fields are no longer cut off on small screens. For example, the House number label now shows completely on a 320px viewport.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.40.0 --save

Copy url
icon
Web Components/Drop-in v5.39.1

This release requires Checkout API v68 or later.

Fixed
  • For Boleto Bancário:
    • When the shopper selects the checkbox to send a copy of the payment form to their email, a validation error no longer occurs.
    • The first name and last name input fields now have more descriptive and accessible error messages.
  • For BLIK, the input field for the verification code no longer includes suggested values, because verification codes aren't reusable.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.39.1 --save

Copy url
icon
Web Components/Drop-in v5.39.0

This release requires Checkout API v68 or later.

New
  • Apple Pay now supports recurring payments. Use the new recurringPaymentRequest property to accept recurring payments.
  • For PayPal, you can now customize the Pay Later message. Set the new enableMessages property to true.
Improved
  • For cards, the payment form now shows the scheme name Visa instead of the value in the descriptorName field.
  • The Fieldset component now uses fieldset and legend elements. Screen readers can now read the relationship between different form controls.
  • Brand icons for cards and QR codes now include alt text that corresponds to the brand name.
Fixed
  • For bank payments, the payment button in the payment form now no longer shows when the showPayButton property is set to false.
  • For the Advanced flow with cards, the check for the object to show stored payment methods from the /paymentMethods response now correctly checks for storedPaymentMethods. Previously, it checked for storePaymentMethods.
  • For Visa, the checkoutOrchestrator property is now named correctly. Previously, it was named checkoutOrchestator.
  • For ApplePay:
    • The amount property is no longer passed to UIElement.
    • The configuration property is no longer passed to UIElement.
    • The Wallets configuration no longer uses deprecated values.
  • For card payments that go through a successful 3D Secure 2 challenge, onComplete can no longer be mistakenly called more than once.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
nmp install @adyen/adyen-web@5.39.0 --save

Copy url
icon
Web Components/Drop-in v5.38.0

This release requires Checkout API v68 or later.

New
  • For Adyen Giving, you can now add a message above the Donate button. In the DonationComponent configuration, use the new disclaimerMessage prop.
  • Apple Pay now supports the eftpos card network.
Improved
  • Increased contrast ratio for the outline of buttons and, when the payment form has more than 3 supported card brands, for the number that indicates the number of additional supported card brands.
  • Error messages that occur in the drop-down list of issuers can now be read by screen readers.
  • Accessibility improvements that follow a11y guidelines.
Fixed
  • Shoppers on mobile devices can now select an issuer from the drop-down list of issuers without error. This fixes the known issue from v5.37.0.
  • For MB WAY, the payment form no longer shows more than one label for each input field.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.38.0 --save

Copy url
icon
Web Components/Drop-in v5.37.0

This release requires Checkout API v68 or later.

Improved

This release enhances the accessibility of Web Drop-in and Components:

  • We made major improvements related to how errors are handled by screen readers. For more information, see pull request in GitHub.
  • We've updated a drop-down box that is used throughout Web Drop-in and Components to better support keyboard and accessible technology user interaction. For more information, see pull request in Github.
  • We've improved UI text and translations for credit card payments in over 20 languages. For more information, see pull request in GitHub.
Known issues

For payment methods that include a list of issuers, shoppers on mobile are not able to select an issuer from the drop-down list. Fixed in v5.38.0.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.37.0 --save

Copy url
icon
Web Components/Drop-in v5.36.0

This release requires Checkout API v68 or later.

New
Copy code
onAuthorized: (resolve, reject, event) => {
reject({
errors: [
new ApplePayError(
'shippingContactInvalid',
'locality',
'Field locality is required'
),
]
})
}

By doing so, you can show useful error messages to your shoppers when the payment fails.

Improved
  • For returning ACH Direct Debit shoppers, we now display the last four numbers of their bank account number for recognition.
Fixed
  • Drop-in and Components no longer have errors related to accessing localStorage when rendered in an <iframe> in a Google Chrome incognito window.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.36.0 --save

Copy url
icon
Web Components/Drop-in v5.35.0

This release requires Checkout API v68 or later.

Fixed
  • For debit card payments, shoppers are no longer shown installment options, as installments aren't compatible with debit cards.
  • The state of Blik Components can now only be accessed once the component is fully rendered, preventing errors.
New
  • In Card Components and Card Drop-in, you can now add an optional disclaimer. The disclaimer may include a hyperlink, for example to link to your terms and conditions:
Field Description
disclaimerMessage.message A string of text that is shown in the bottom of the Card Component. Use %{linkText} to reference the optionally defined hyperlink.
disclaimerMessage.linkText The hyperlink's text
disclaimerMessage.link The hyperlink's destination. The link opens in a new tab.

Example:

Copy code
disclaimerMessage: {
message: 'By continuing you accept the %{linkText} of MyStore',
linkText: 'terms and conditions',
link: 'https://www.adyen.com'
}
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.35.0 --save

Copy url
icon
Web Components/Drop-in v5.34.0

This release requires Checkout API v68 or later.

New
  • You can now set the PayPal intent for an individual payment through the Drop-in or Component configuration. This value overrides the general one retrieved from your Customer Area.
  • We now track amount and currency data of payments.
Improved
  • Payment methods that use QR codes don't automatically redirect shoppers on mobile devices to the QR code's destination anymore. Instead, shoppers are presented an Open app button that redirects them to complete the payment.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.34.0 --save

Copy url
icon
Web Components/Drop-in v5.33.0

This release requires Checkout API v68 or later.

New

The new onActionHandled callback informs you when an action, for example a QR code or 3D Secure authentication screen, is shown to the shopper. It returns data that contains the type of component that shows the action to the shopper and a description of the action.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.33.0 --save

Copy url
icon
Web Components/Drop-in v5.32.0

This release requires Checkout API v68 or later.

New

For Online banking Poland, the list of issuers now includes issuer logos.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.32.0 --save

Copy url
icon
Web Components/Drop-in v5.31.3

This release requires Checkout API v68 or later.

Fixed
  • For PayNow, the QR code that the shopper scans to pay now expires after 3 minutes. Previously, it expired after 15 minutes.
  • For Google Pay, when the shopper cancels the payment, the pop-up that appears is now the same as the one for other payment methods.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.31.3 --save
Improved
  • For cards, the card brand icons that appear under the Card number field now have larger margins.

Copy url
icon
Web Components/Drop-in v5.31.2

This release requires Checkout API v68 or later.

Fixed

For Drop-in, when the shopper selects a payment method from the list, the onSelect callback now gets called only one time. Previously, if the shopper selected a UI element besides the radio button, such as the payment method logo, the callback was called multiple times.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.31.2 --save
Known issues

For PayNow, the QR code expires after 15 minutes. It should expire after 3 minutes. This issue is fixed in v5.31.3.


Copy url
icon
Web Components/Drop-in v5.31.1

This release requires Checkout API v68 or later.

Fixed
  • For 3D Secure 2, when fingerprint authentication times out, the onError callback is no longer triggered. The 3D Secure flow continues for the shopper as usual, because it is not a fatal error.
  • All error icons now have the alt tag Error.
  • For BLIK, input fields now accept only numeric values.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.31.1 --save

Copy url
icon
Web Components/Drop-in v5.31.0

This release requires Checkout API v68 or later.

New
  • For integrations using the /sessions endpoint, you now receive the sessionResult property after the payment flow finishes.
  • For Google Pay, the buttonRootNode property is now supported.
  • For the Card Component on iOS devices in the Safari browser, when an input field is in focus, you can now enable the keyboard arrows for all versions of the browser by setting the new disableIOSArrowKeys to false.
Improved
  • The sorting logic after detecting card brands now happens on Adyen's backend servers.
  • For ACH:
    • The bank account number input field in the payment for no longer shows a placeholder.
    • When the shopper enters a bank account number, it is no longer formatted with a space between every four digits.
  • For the cards, when the billingAddressMode property is set to partial and the country property is set, there's now validation for the postal code that the shopper enters.
Fixed
  • For OXXO, the payment button no longer shows when showPaymentButton is set to false.
  • For payment methods with an additional action, configured properties for the payment method now persist after the handling the action. Previously, configured properties were lost after handling the action.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.31.0 --save
Known issues

For PayNow, the QR code expires after 15 minutes. It should expire after 3 minutes. This issue is fixed in v5.31.3.


Copy url
icon
Web Components/Drop-in v5.30.1

This release requires Checkout API v68 or later.

Fixed
  • For cards, the onBinLookup event now includes the issuingCountryCode property. Previously, the event didn't include information about the issuing country code.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.30.1 --save
Known issues

For PayNow, the QR code expires after 15 minutes. It should expire after 3 minutes. This issue is fixed in v5.31.3.


Copy url
icon
Web Components/Drop-in v5.30.0

This release requires Checkout API v68 or later.

New
  • Payment method: DuitNow.
  • For cards:
    • The Expiry date field now includes an icon showing the location of the expiry date.
    • In the CVC/CVV field, you can now set digits to appear as dot icons by setting the new maskSecurityCode property to true.
Changed
Improved

In the payment methods list, the items in the list now have the radio role for accessibility features.

Fixed
  • For Pix, when showPayButton is set to false, the payment form now appears when the shopper selects Pix from the payment methods list.
  • For Klarna using the /sessions endpoint, you no longer have to implement the onAdditionaDetails callback. Previously, you had to implement the onAdditionalDetails callback to make a request to the correct endpoint.
  • When you create the 3D Secure 2 Component with createFromAction, the component no longer crashes if you make more than one transaction of the same type.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.30.0 --save
Known issues

For PayNow, the QR code expires after 15 minutes. It should expire after 3 minutes. This issue is fixed in v5.31.3.


Copy url
icon
Web Components/Drop-in v5.29.0

This release requires Checkout API v68 or later.

New
  • Payment methods:
    • PayNow
    • PromptPay
Fixed
  • For PayPal, GooglePay, and AmazonPay, payments no longer crash because of Script.
  • When a shopper makes gift card partial payments, and the second payment method fails, the corresponding callback gets triggered with an error. Previously, the callback was not triggered.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.29.0 --save
Known issues

For PayNow, the QR code expires after 15 minutes. It should expire after 3 minutes. This issue is fixed in v5.31.3.


Copy url
icon
Web Components/Drop-in v5.28.3

This release requires Checkout API v68 or later.

Changed

Drop-in and Components now use Preact v10.11.2.

Fixed

The Amazon Pay payment method now loads for the US locale when the shopper is in the US. Previously it loaded the Great Britain locale.

Deprecated

For Amazon Pay, the default property region. Use configuration.region instead.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.28.3 --save

Copy url
icon
Web Components/Drop-in v5.28.2

This release requires Checkout API v68 or later.

Improved
  • Upgraded the version of card input fields.
Fixed
  • For ACH, the new forceCompat property forces browsers to use JSON Web Encryption for the input fields. Set this property to true.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.28.2 --save

Copy url
icon
Web Components/Drop-in v5.28.1

This release requires Checkout API v68 or later.

Fixed

The Preact version you can use is now restricted to the version used by Drop-in and Components. Previously, some installations using a different Preact version were broken.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.28.1 --save

Copy url
icon
Web Components/Drop-in v5.28.0

This release requires Checkout API v68 or later.

New
  • For cards, new error codes and messages specify the types of error that occur in the input fields. Previously, there was one error code and message for different types of errors.
  • For cards, the new forceCompat property forces browsers to use JSON Web Encryption for the card input fields introduced in v5.20.0. Set this property to true.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.28.0 --save

Copy url
icon
Web Components/Drop-in v5.27.0

This release requires Checkout API v68 or later.

New

Payment method: Open banking

Improved

The mount function can now remount a Component after it has been unmounted. Previously, only remount could remount a Component.

Fixed
  • For Google Pay, payment submission errors now trigger the onError callback instead of throwing an exception.
  • On mobile, redirecting the shopper to another app no longer triggers the onError callback with an AdyenCheckoutError.
  • For UPI, changing the payment mode to QR code now triggers the onChange callback. Previously, only changing the payment mode to VPA triggered the callback.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.27.0 --save

Copy url
icon
Web Components/Drop-in v5.26.0

This release requires Checkout API v68 or later.

Fixed
  • Fixed the known issue from v5.25.0 where the Stored Card Component UI showed an error code instead of the error message when there was a validation error.
  • On Drop-in, moving the focus on a payment method no longer automatically expands it. To expand a payment method, the user must slect by clicking, tapping, or pressing a button.
  • Added missing alt text translations for icons used for input field validation feedback.
New
  • The checkoutAttemptId is now stored as part of your browser's sessionStorage for 15 min.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.26.0 --save

Copy url
icon
Web Components/Drop-in v5.25.0

This release requires Checkout API v68 or later.

Improved

For the Card Component, input field errors now include the name of the field where it occurred.

Changed

The UPI Component now shows a selector for Virtual Payment Address and QR code above the input field, instead of a different button for each, so that you can customize the Continue button. Use the new defaultMode configuration parameter to specify if Virtual Payment Address or QR code is selected by default.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.25.0 --save
Fixed

For input fields, the icons that indicate if an input is valid or invalid now include corresponding alt text, which is used by screen readers.

New

Payment method: Online banking Poland.

Known issues

If there's a validation error in the Stored Card Component, the UI shows the error code instead of the error message. Fixed in v5.26.0


Copy url
icon
Web Components/Drop-in v5.24.0

This release requires Checkout API v68 or later.

New

For ACH Direct Debit payments, the shopper can now choose to save their payment details. Set enableStoreDetails to true in the payment method configuration to enable the checkbox.

Improved

Changed the color of some UI elements to increase visual contrast.

Fixed

When the shopper selects a checkbox, the check mark now renders completely. Previously, only a part of the check mark rendered.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.24.0 --save

Copy url
icon
Web Components/Drop-in v5.23.1

This release requires Checkout API v68 or later.

Fixed

For the Card Component, you now get an error message when input fields in the payment form fail to load.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.23.1 --save

Copy url
icon
Web Components/Drop-in v5.23.0

This release requires Checkout API v68 or later.

New

The Pay button can now show the payment amount in two different currencies using the secondaryAmount configuration.

Fixed
  • For cards, the cardholder name field now has an autocomplete attribute that labels its purpose.
  • For SEPA Direct Debit and Boleto, the shopper email field now has validation.
  • Projects that use TypeScript now compile without an error because CoreParameters is now imported from a relative path. This fixes the known issue introduced in v5.22.0.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.23.0 --save

Copy url
icon
Web Components/Drop-in v5.22.0

This release requires Checkout API v68 or later.

New

Payment methods: Online banking for Czech Republic and Online banking for Slovakia.

Improved

Added TypeScript types to the AdyenCheckout object.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.22.0 --save
Known issues

Integrations using TypeScript don't compile because of an error.


Copy url
icon
Web Components/Drop-in v5.21.0

This release requires Checkout API v68 or later.

New
  • For the Gift cards Component, you can now show a custom button when the shopper chooses to pay part of the amount with a gift card and the remaining amount with another payment method.
  • Support for credit card installments.
Fixed
  • If you do not support American Express cards, the shopper can no longer enter a CVC that is more than 3 digits.
  • The UPI Component now handles the timeout error for UPI Collect payments.
  • For the SEPA bank transfers, setting the showPayButton to false now hides only the payment button.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.21.0 --save

Copy url
icon
Web Components/Drop-in v5.20.0

This release requires Checkout API v68 or later.

New

Supported language: Portuguese. Use the shopperLocale: pt-PT.

Improved

For the Card Component, the input fields in the payment form now use JSON Web Encryption for security. To test your Card integration, you now must use either a local or https domain.

Fixed

For Bancontact card payments, when the shopper enters the card number and the brands are detected by the Component, the brands no longer remain detected if you remove the card number.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.20.0 --save

Copy url
icon
Web Components/Drop-in v5.19.0

This release requires Checkout API v68 or later.

New

New supported payment method: UPI.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.19.0 --save
Improved

Added the LICENSE file to the npm package.


Copy url
icon
Web Components/Drop-in v5.18.0

This release requires Checkout API v68 or later.

New
  • When you use Gift card Component with the /sessions endpoint, you can now let the shopper pay part of the amount with a gift card and the remaining amount with another payment method.
Fixed
  • The AmazonPay Component now loads the AmazonPay SDK that corresponds to the region from the paymentMethods response.
  • After the shopper selects the Pay button, the Card Component no longer allows the shopper to interact with the card input fields.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.18.0 --save

Copy url
icon
Web Components/Drop-in v5.17.0

This release requires Checkout API v68 or later.

New

Add your signed JSON Web Token (JWT) to your Google Pay configuration using configuration.authJwt. This allows you to use your Google merchant ID with multiple domains.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.17.0 --save

Copy url
icon
Web Components/Drop-in v5.16.2

This release requires Checkout API v68 or later.

Fixed
  • If an action is rejected in the beforeSubmit callback, the state of the Component no longer remains loading.
  • For donations, amounts are now shown with decimals. Previously, amounts were rounded up to the closest integer.
  • The 3D Secure 2 Component now throws a challenge error when transStatus cannot be retrieved.
  • Fixed an issue where in some situations, if a shopper corrected an invalid card number, it was still marked as invalid.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.16.2 --save

Copy url
icon
Web Components/Drop-in v5.16.1

This release requires Checkout API v68 or later.

Improved
  • Removed alt text from the supported card brand images because it was not providing additional useful information to screen reader users.
  • Changed the color of placeholder text in form fields so the contrast now satisfies WCAG AA requirements.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.16.1 --save

Copy url
icon
Web Components/Drop-in v5.16.0

This release requires Checkout API v68 or later.

New

Analytics feature turned on by default. Find out what we track and how you can configure it.

Improved

For MB WAY, added a country code prefix to the phone number input field.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.16.0 --save
Changed

For wallets India, the payment method type is now: wallet_IN.

Deprecated

Payment method types billdesk_wallet and payu_IN_cashcard for wallets India. Use wallet_IN instead.


Copy url
icon
Web Components/Drop-in v5.15.0

This release requires Checkout API v68 or later.

New

For gift cards on Drop-in, the shopper can now cancel a transaction after making a partial payment with a gift card.

Fixed
  • For the Card Component on iOS devices in the Safari browser, when an input field is in focus, the keyboard arrows are now disabled for all versions of the browser. Previously, the keyboard arrows only functioned correctly for some versions.
  • Integrations using TypeScript now compile without an error. This fixes the known issue introduced in v5.14.0.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.15.0 --save

Copy url
icon
Web Components/Drop-in v5.14.0

This release requires Checkout API v68 or later.

New
  • For the Card Component, if you set billingAddressRequired to true, you can use the new billingAddressMode property to require the shopper's postal code instead of the full address.
Fixed
  • For Atome, the bank details input fields no longer show up in the payment form. This fixes the known issue introduced in v5.13.0.
Known issues

Integrations using TypeScript don't compile because of an error.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.14.0 --save

Copy url
icon
Web Components/Drop-in v5.13.1

This release requires Checkout API v68 or later.

Fixed

In the payment form, focus no longer moves to the first input selector when the shopper clicks on other elements. This fixes the known issue introduced in v5.13.0.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.13.1 --save

Copy url
icon
Web Components/Drop-in v5.13.0

This release requires Checkout API v68 or later.

New
Fixed

When searching for a value in a drop-down field, the drop-down no longer remembers the search term when you click away from it.

Known issues

In the payment form, focus moves to the first input selector when the shopper clicks on other elements.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.13.0 --save

Copy url
icon
Web Components/Drop-in v5.12.0

This release requires Checkout API v68 or later.

New

For the Card Component, the default setting of showBrandsUnderCardNumber is true.

Fixed

For Swish payments, the QR code expires after 3 minutes instead of 15 minutes.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.12.0 --save

Copy url
icon
Web Components/Drop-in v5.11.0

This release requires Checkout API v68 or later.

New

For cards, supported brands are no longer shown above the card number field when the shopper selects to pay by card. You can now show them under the card number field by setting the property showBrandsUnderCardNumber to true. In the Drop-in payment method list, next to the Card payment method, this also shows a maximum of 4 supported brands instead of all.

Starting from v5.12.0, the default value for this property is true.

Fixed

Drop-in and Components no longer crash for some Content Security Policy header values.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.11.0 --save

Copy url
icon
Web Components/Drop-in v5.10.0

This release requires Checkout API v68 or later.

Improved
  • If the environment and type of client key do not match, you now get an error.
  • The error message for when a 3D Secure 2 challenge occurs specifies what went wrong.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.10.0 --save
Deprecated

Payment method types billdesk_online and payu_IN_nb for Online banking India. Use onlinebanking_IN instead.

Changed

For Online banking India, the payment method type is now onlinebanking_IN.

New

For the Card Component, the onFieldValid callback now returns the issuerBin (first 8 digits of the card) prop if the card number is 16 or more digits.


Copy url
icon
Web Components/Drop-in v5.9.0

This release requires Checkout API v68 or later.

New
  • Support for recurring payments through Amazon Pay using the new properties changePermissionType and recurringMetadata. The shopper's details are stored by Amazon Pay.
Fixed
  • Highlighted issuers are now correctly shown with two issuers in each row. When the number of issuers is odd, the last row shows one.
  • For the instant payment button, when you set showPayButton to false, it is now correctly shown.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.9.0 --save

Copy url
icon
Web Components/Drop-in v5.8.0

This release requires Checkout API v68or later.

New

Support for French meal vouchers:

  • Apetiz: mealVoucher_FR_natixis
  • Sodexo: mealVoucher_FR_sodexo
  • Up Dejeuner: mealVoucher_FR_groupeup
Improved
  • For the Card Component, the focus moves to the next field when the entered card number reaches the expected length. This feature is controlled by the autoFocus prop.
  • Added postal code validation for the countries/regions configured in validate.ts.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.8.0 --save
Changed

For card payments in installments, if there's a single installment, Drop-in doesn't return the installments object.


Copy url
icon
Web Components/Drop-in v5.7.0

This release requires Checkout API v68 or later.

Fixed
  • If there's an error during the 3D Secure 2 authentication flow, the Pay button now returns to the default state from the loading state.
New
  • In addition to gift card logos, you can now also configure custom names for gift cards.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.7.0 --save

Copy url
icon
Web Components/Drop-in v5.6.2

This release requires Checkout API v68 or later.

Improved

When you get a network error, error.message now contains the message from the API response instead of a generic one.

Fixed

When setStatusAutomatically is set to true, an overlay now prevents shoppers from interacting with payment method fields after pressing the Pay button.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.6.2 --save

Copy url
icon
Web Components/Drop-in v5.6.1

This release requires Checkout API v68 or later.

Fixed

When using Internet Explorer 11, card input fields now appear and work correctly. This fixes the known issue introduced in v5.2.1.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.6.1 --save

Copy url
icon
Web Components/Drop-in v5.6.0

This release requires Checkout API v68 or later.

Improved
  • The new property, SRConfig, lets you configure screen reader behaviour when there are errors in the Card Component fields. This property doesn't affect how error messages are rendered in the checkout form.
Fixed
  • Fixed the known issue with character input for the card holder field. This issue affected the Card Component when used with web browsers on Android devices and is present in v5.4.0 and v5.5.0.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.6.0 --save
Known issues

When using Internet Explorer 11, card input fields don't appear and work correctly. Fixed in v5.6.1.


Copy url
icon
Web Components/Drop-in v5.5.0

This release requires Checkout API v68 or later.

New

The PayPal Component now renders a PayLater button in countries/regions where it is available. If you do not want the PayLater button to be rendered, you can use blockPayPalPayLaterButton: true.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.5.0 --save
Known issues
  • Shoppers using web browsers on Android devices cannot type into the card holder name field. Fixed in v5.6.0.
  • When using Internet Explorer 11, card input fields do not appear and work correctly. Fixed in v5.6.1.

Copy url
icon
Web Components/Drop-in v5.4.0

This release requires Checkout API v68 or later.

Changed

We changed how Drop-in and Components handle browser compatibility, which means polyfills no longer polute the global scope. This change doesn't affect the browser support of your Drop-in or Components integration.

Fixed
  • Fixed the known issue from v5.2.2 where PayPal didn't load if you integrated using the /sessions endpoint.
  • Fixed an issue where PayPal was not loading when re-mounting with a different type of currency.
  • Fixed issues with entering Japanese characters in text input fields.
  • Drop-in and Components no longer crash when imported on a server-side context, for example if using Angular Universal, Nuxt.js, or Next.js.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.4.0 --save
Known issues
  • Shoppers using web browsers on Android devices cannot type into the card holder name field. Fixed in v5.6.0.
  • When using Internet Explorer 11, card input fields do not appear and work correctly. Fixed in v5.6.1.

Copy url
icon
Web Components/Drop-in v5.3.1

This release requires Checkout API v68 or later.

Fixed

Fixed the issues with cards in the live environment introduced in version 5.3.0.

Known issues

When using Internet Explorer 11, card input fields don't appear and work correctly. Fixed in v5.6.1.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.3.1 --save

Copy url
icon
Web Components/Drop-in v5.3.0

This release requires Checkout API v68 or later.

New

For Drop-in, you can now render the Apple Pay and Google Pay buttons at the top of the payment method list.

Improved
  • For PayPal, we now support zero-auth transactions.
  • The icons in the payment method list UI have more padding in the focus state.
Fixed

Dragonpay vouchers for convenience stores in the Philippines (dragonpay_otc_philippines) now only show the Dragonpay logo. Previously, an issuer logo was also shown beside the Dragonpay logo.

Known issues
  • The Cards Drop-in integration and Card Component are only available in the test environment. They will be available in the live environment on 2 Dec, 2021.
  • When using Internet Explorer 11, card input fields do not appear and work correctly. Fixed in v5.6.1.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.3.0 --save

Copy url
icon
Web Components/Drop-in v5.2.2
Fixed
  • Fixed an issue where if you integrated using the /sessions endpoint and have configured onAdditionalDetails on the front end, the front end was automatically submitting additional payment details. This means that submitting additonal payment details from your server using the /payments/details call no longer fails.
Known issues
  • PayPal doesn't load if you integrated using the /sessions endpoint. Fixed in v5.4.0.
  • When using Internet Explorer 11, card input fields do not appear and work correctly. Fixed in v5.6.1.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.2.2 --save

Copy url
icon
Web Components/Drop-in v5.2.1

This release requires Checkout API v68 or later.

Fixed
  • Accessibility improvements:
    • Screen readers no longer read out card brand logos or the CVC icon, which was exposing unnecesary information about decorative images.
    • Card brand logos are no longer focusable using the keyboard, which was stopping users on unactionable elements.
    • You can remove the iframe title for the Custom Card Component by replacing it with role="presentation".
  • Fixed an issue where on Firefox, users couldn't use the Tab key to move between Card Component fields.
  • Entering card numbers that contain all the same digit, like 0000 0000 0000 0000 0000, now produces an Invalid card brand error on the front end.
Removed

The deprecated Internet Explorer 11 attributes scrolling and frameborder.

Known issues

When using Internet Explorer 11, card input fields don't appear and work correctly. Fixed in v5.6.1.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.2.1 --save

Copy url
icon
Web Components/Drop-in v5.2.0

This release requires Checkout API v68 or later.

New

For PayPal, you can include a cspNonce to add a Content Security Policy (CSP) nonce if you use this on your site.

Improved
  • For Japanese convenience stores (econtext_stores and econtext_seven_eleven) you can now hide the input fields for shopper name, email, and telephone number.
  • For Bancontact card, you can now override the supported brands by including a [brands] array.
  • Drop-in, the Card Component, and the Custom Card Component can now handle cards with an optional expiry date. An optional expiry date is marked as optional in the UI, and is not required for a card to pass the validation checks.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.2.0 --save

Copy url
icon
Web Components/Drop-in v5.1.0

This release requires Checkout API v68 or later.

Fixed
  • Fixed an issue where payments using Apple Pay, Google Pay, or PayPal did not work if you have a Components integration.
Improved
  • For payment methods with issuer lists, like iDEAL or Dotpay, you can choose issuers to show outside of the the dropdown menu using highlightedIssuers.
  • For payments at Japanese convenience stores, you can now hide the fields to collect personal details using personalDetailsRequired.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.1.0 --save

Copy url
icon
Web Components/Drop-in v5.0.0

This release requires Checkout API v68 or later.

If upgrading from v3.23.0 or earlier, have a look at the migration guide.

Known issues
Deprecated

The following props from AdyenCheckout configuration:

  • allowPaymentMethods
  • removePaymentMethods

To customize which payment methods are available for the shopper, include allowedPaymentMethods or blockedPaymentMethods in your /paymentMethods request.

Breaking Changes
  • The onError callback now returns an object for every Component. The object contains more details about the error. For more information, refer to Handle Drop-in errors or Handle Component errors.

  • The creation of AdyenCheckout is now asynchronous:

    Copy code
        const checkout = await AdyenCheckout(configuration); 
New

Using the /sessions endpoint, you can integrate Drop-in and Components with a single API call.

If you already integrated using the /paymentMethods, /payments, and /payments/details endpoints, you can continue using this back end setup in version 5.0.0.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@5.0.0 --save

Copy url
icon
Web Components/Drop-in v4.9.0

This release requires Checkout API v67 or later.

Improved
  • We added several accessibility improvements for Drop-in and Components.
  • For payment methods with multiple payment method variants, such as Klarna or Dragonpay, we fixed an issue where the Component could be created with incorrect payment method data. This issue only occurred when using Components, not when using Drop-in.
New

For Pix, you can configure the Drop-in or the Component to collect shopper's name and the CPF/CNPJ (a unique identifier similar to a social security number), by including personalDetailsRequired.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@4.9.0 --save

Copy url
icon
Web Components/Drop-in v4.8.0

This release requires Checkout API v67 or later.

Fixed
  • For payment methods with multiple payment method variants, such as Klarna or Dragonpay, we fixed an issue where the Component could be created for the incorrect variant. This issue only occurred when using Components, not when using Drop-in.
  • Fixed an issue where the Card Component state was not correctly updated in case you entered correct card details, and then pasted a full unsupported card number.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@4.8.0 --save
Improved

Accessibility improvement: All shopper input fields now have a name property. This makes sure their <label> elements get a for attribute, and that the shopper input is given an id that matches the value of the for attribute.


Copy url
icon
Web Components/Drop-in v4.7.5

This release requires Checkout API v67 or later.

Fixed

If you're using native web components, we fixed an issue where opening a dropdown list in Adyen's Web Components or Drop-in would cause it to close it back again immediately.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@4.7.5 --save

Copy url
icon
Web Components/Drop-in v4.7.4

This release requires Checkout API v67 or later.

Fixed
  • The isAvailable method for Apple Pay has a shorter execution time, since it no longer invokes canMakePayments twice.
  • We fixed an issue where an input in an error state was not properly validated in case it lost focus.
Improved
  • If it is not possible to fetch the language of the browser, we now populate the browserInfo.language field with a default value of en.
  • When showing that input is valid or invalid, address input fields now behave in the same way as all other input fields.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@4.7.4 --save

Copy url
icon
Web Components/Drop-in v4.7.3

This release requires Checkout API v67 or later.

Improved

The Amazon Pay Component now supports Amazon Pay multi-currency. This feature will be automatically available to you if your Amazon Pay merchant account is in the EU or UK region.

Fixed
  • For card payments, the holderName field no longer shows a validation error if empty and configured as optional.
  • Fixed an issue with the white Apple Pay button styling.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@4.7.3 --save

Copy url
icon
Web Components/Drop-in v4.7.2

This release requires Checkout API v67 or later.

Improved

The Cardholder field now accepts all characters, including digits.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@4.7.2 --save

Copy url
icon
Web Components/Drop-in v4.7.1

This release requires Checkout API v67 or later.

Improved
  • The Cardholder field now accepts all characters, except digits.
  • We improved accessibility for dropdown menus:
    • You can now close a dropdown menu using the Esc key.
    • Pressing Tab on a open dropdown moves the focus to the next element after closing the dropdown.
Fixed

For Google Pay, canceling a payment no longer logs an unhandled promise error in the console.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@4.7.1 --save

Copy url
icon
Web Components/Drop-in v4.7.0

This release requires Checkout API v67 or later.

Changed

When onSubmit is triggered, Component/Drop-in status is now automatically set to 'loading'. If you want to overwrite the default behavior, set the setStatusAutomatically prop to false.

Improved
  • Added support for Cartes Bancaires in the Apple Pay Component.
  • We optimized the address form layout for addresses in Australia.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@4.7.0 --save

Copy url
icon
Web Components/Drop-in v4.6.0

This release requires Checkout API v67 or later.

New
Improved
  • The Apple Pay Component now supports Girocard.
  • You can now mount more than one PayPal component on the same page.
Fixed
  • For Drop-in, onSubmit is no longer called twice if using Apple Pay with a custom button.
  • Updated the Google Pay icon to match the brand guidelines.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@4.6.0 --save

Copy url
icon
Web Components/Drop-in v4.5.0

This release requires Checkout API v67 or later.

New
  • You can now customize the icon for each payment method, by including the icon property in the Component configuration. For example, this is how you can customize the Google Pay icon on Drop-in:
Copy code
{
paymentMethodsConfiguration: {
paywithgoogle: {
icon: 'https://...'
}
}
  • For cards, you can now customize the icon of the card brand, by including the icon property in brandsConfiguration. For example, this is how you can customize the icon for Visa on Drop-in:
Copy code
{
paymentMethodsConfiguration: {
card: {
brandsConfiguration: {
visa: {
icon: 'https://...'
}
}
}
}
Changed

The maximum length of a gift card number is now 32 digits, instead of 22 digits as before.

Fixed

For Amex, the hint for where the shopper can find the CVC no longer shows two locations.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@4.5.0 --save

Copy url
icon
Web Components/Drop-in v4.4.0

This release requires Checkout API v67 or later.

New
  • Support for right-to-left languages though the HTML dir attribute.
  • Added Arabic (international) to our supported languages.
Fixed
  • For Google Pay, onSubmit now correctly calls Drop-in or the Google Pay Component, depending on your integration.
  • For payments partially covered using a gift card, the shopper can now see a message about the amount they need to pay in addition to the gift card amount.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@4.4.0 --save

Copy url
icon
Web Components/Drop-in v4.3.1

This release requires Checkout API v67 or later.

Fixed

Fixed an issue where the Card Component did not work on Internet Explorer 11.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@4.3.1 --save

Copy url
icon
Web Components/Drop-in v4.3.0

This release requires Checkout API v67 or later.

Known issues

The Card Component does not work on Internet Explorer 11. This is fixed in Web Components 4.3.1.

New

For cards, you can now include minimumExpiryDate in the Component configuration. This will prevent shoppers from paying with a card that expires before the specified date.

Improved

We've animated the final status shown by Drop-in (success or error).

Fixed
  • When using Google Pay Drop-in integration with your own custom button, the onSubmit event no longer triggers twice.
  • For Amazon Pay, we fixed an issue where the Component did not pass the publicKeyId to the call that updates the checkout session state.
  • When changing the country/region in the address form, the optional and required fields are now being reset based on the new country.
  • For the Bank Transfer Component, the showEmailAddress parameter is now working as expected.
  • Fields that are prefilled (by including a data object in the Component configuration) are now validated as expected.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@4.3.0 --save

Copy url
icon
Web Components/Drop-in v4.2.3

This release requires Checkout API v67 or later.

Fixed

We fixed an issue with the promise polyfill that could lead to errors on Internet Explorer 11. This issue was introduced in Web Components 4.0.0.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@4.2.3 --save

Copy url
icon
Web Components/Drop-in v4.2.2

This release requires Checkout API v67 or later.

Fixed
  • For Boleto Bancário, the payment form now shows the Country field (as read-only). This fixes an issue where payments would fail because state.data was missing a billingAddress.country.
  • We fixed an issue where AdressSchema types were not correctly exported, leading to compilation errors when using our npm package together with TypeScript.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@4.2.2 --save

Copy url
icon
Web Components/Drop-in v4.2.1

This release requires Checkout API v67 or later.

Known issues

For Boleto Bancário, the state.data is missing the billingAddress.country, causing the payment to fail. This issue is fixed in Web Components 4.2.2.

Fixed
  • The cardholder name field no longer loses focus when the shopper typing in the field.
  • The Pay button is now also disabled for keyboard navigation when the Component is in the loading state. This prevents accidental double payments if the shopper uses the keyboard to submit the payment form.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@4.2.1 --save

Copy url
icon
Web Components/Drop-in v4.2.0

This release requires Checkout API v67 or later.

Known issues
New
  • For Google Pay, Drop-in and Components now return a browserInfo object. If you need to handle 3D Secure through Google Pay, pass this object inside browserInfo when making the /payments request.
  • You can now render the cardholder name before the card number using positionHolderNameOnTop: true.
  • To make card payments in Brazil, the social security number is often required. You can use socialSecurityNumberMode to render a social security number field in your payment form.
Improved

We improved the accuracy of card brand detection.

Fixed

Calling component.data no longer fails if the component is not fully rendered. This issue came up for components that have a list of issuers, for example iDEAL or Dotpay.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@4.2.0 --save

Copy url
icon
Web Components/Drop-in v4.1.0

This release requires Checkout API v67 or later.

Known issues

For Boleto Bancário, the state.data is missing the billingAddress.country, causing the payment to fail. This issue is fixed in Web Components 4.2.2.

New
  • We added new Apple Pay button types. For a full list of supported Apple Pay button types, refer to Button configuration.
  • For Google Pay, you can now use the buttonSizeMode and buttonLocale configuration properties. For more information, refer to Button options.
  • Stored cards can now be configured separately from other cards, by including a storedCard object in the paymentMethodsConfiguration object.
Changed

The placeholder values for card fields are now only read from translation fields. Configuring placeholder values inside the Card Component is no longer supported.

Fixed
  • We added a missing CSS file export in the npm package.
  • We fixed an issue where the promise dependency could be missing when using the ES format bundle.
  • When pasting a dual-branded card number over a previously entered card number, the detected card brand is now being rendered correctly.
  • When paying in IQR (Iraqi Dinar), the amount on the Pay button is now rendered correctly.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@4.1.0 --save

Copy url
icon
Web Components/Drop-in v4.0.0

This release requires Checkout API v67 or later.

For more guidance on upgrading to this version, have a look at the migration guide.

Breaking Changes
Known issues

For Boleto Bancário, the state.data is missing the billingAddress.country, causing the payment to fail. This issue is fixed in Web Components 4.2.2.

New
  • For npm installations, we now also release ES and CommonJS (CJS) format bundles. This is in addition to the Universal Module Definition (UMD) format bundle released with previous versions.
  • For Google Pay, the payment method type is now googlepay.
  • You can now configure action components by action type inside paymentMethodsConfiguration. For example, to change the default window size for a 3D Secure challenge:

    Copy code
    const checkout = new AdyenCheckout({
    paymentMethodsConfiguration: {
    threeDS2: {
    challengeWindowSize: '05' // '02' is the default size
    }
    }
    });
Improved
  • The onChange event now also returns error and validation information. The state.valid object returns a boolean for each field, and state.errors can be used to log the state of your form. You should only use the onError event for non-validaton errors, for example network errors.
  • Drop-down menus now have search functionality which filters results as you type. This applies, for example, for the list of issuers for iDEAL payments, or the lists of countries, states, or provinces for payment methods that require these.
  • If an issuing bank is offline, it appears greyed out to the shopper and they cannot select it from the dropdown menu. This applies, for example, to Dotpay.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@4.0.0 --save

Copy url
icon
Web Components/Drop-in v3.23.0

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

Improved

Amazon Pay now supports the cancelUrl configuration property and the submit() method.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@3.23.0 --save

Copy url
icon
Web Components/Drop-in v3.22.2

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

Fixed

We fixed the issue with the native 3D Secure 2 integration introduced in version 3.22.0.

Improved

For QIWI and MB WAY, we changed the translation labels from telephoneNumber to mobileNumnber. If you have a custom translation, make sure you update the translation keys.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@3.22.2 --save

Copy url
icon
Web Components/Drop-in v3.22.1

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

Known issues

Do not update to this version if you are using the 3D Secure 2 native integration.

In preparation for a future release, we've made some updates that lead to issues with the current 3D Secure 2 integration.

Fixed
  • Fixed an issue where Ratepay wasn't available for payments in the Netherlands.
  • Showing a loading state using setStatus('loading') is now also available for QR code payment methods.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@3.22.1 --save

Copy url
icon
Web Components/Drop-in v3.22.0

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

Known issues

Do not update to this version if you are using the 3D Secure 2 native integration.

In preparation for a future release, we've made some updates that lead to issues with the current 3D Secure 2 integration.

Fixed

Drop-in no longer tries to render Amazon Pay, as this is only supported on Components and not on Drop-in.

Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@3.22.0 --save

Copy url
icon
Web Components/Drop-in v3.21.1

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

Fixed

The default sizing of the 3D Secure challenge window in previous versions could sometimes lead to issues such as the shopper not being able to scroll down the 3D Secure 2 challenge page. This has now been fixed:

  • The default size of the 3D Secure 2 challenge window is now 02 (390px x 400px) instead of 05.
  • If you configure the challenge window size to be 05, we no longer force a 16:9 aspect ratio, so that the window size is now 100% x 100% as expected.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@3.21.1 --save

Copy url
icon
Web Components/Drop-in v3.21.0

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

New
  • New payment method: Pix.
  • Support for the onShippingChange callback for the PayPal Component. This allows you to listen for changes in shipping address, which you can accept or reject. The PayPal Component doesn't support order updates based on the shipping address.
Improved
  • For card payments, the object returned in the onBinLookup callback now includes a brands array which contains all the card brands your integration supports.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@3.21.0 --save

Copy url
icon
Web Components/Drop-in v3.20.0

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

New
  • New supported payment method: Amazon Pay. This payment method is only available on Components, not on Drop-in.
  • For cards, you can now use the onBinLookup callback. This is only available on Drop-in and Components, not on the Custom Card Component.

    The onBinLookup callback was improved in version 3.21.0. We recommend updating to this version if you want to use it.

Improved
  • The supported brands for Apple Pay and Google Pay are now automatically configured based on your account settings, so you no longer need to specify these in the supportedNetworks (for Apple Pay) or in allowedCardNetworks (for Google Pay).
  • We added support for new BINs on the Bancontact card Component.
  • Accessibility improvement: we've added translations for the aria attributes on the Card Component and the Custom Card Component.
Fixed
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@3.20.0 --save

Copy url
icon
Web Components/Drop-in v3.19.0

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

New
  • Support for Boleto Bancário through PrimeiroPay using a redirect payment flow. If using PrimeiroPay, you need to handle action.type: redirect.
  • Support for bank transfers through an additional action payment flow. The /payments request returns action.type: bankTransfer.
Changed
Improved
  • The Gift Card Component flow introduced in Web Components 3.17.0 now has more specific error messages.
  • If you do not specify the countryCode for buy now, pay later payment methods, the Component will show a drop-down menu where the shopper chooses the country/region.
  • The Apple Pay Component now has an onClick event, making it consistent with Google Pay and PayPal.
Fixed
  • Fixed an issue where state.data had values for holder.name filled automatically when holder.name was disabled.
  • For Java library users, we fixed an issue where initialization would fail if paymentMethodsResponse contained any null values.
  • The onDisableStoredPaymentMethod Drop-in event now passes the correct storedPaymentMethodId parameter.
  • If you are using the Custom Card Component with separate date fields without providing translations for placeholder values, the Component will use the default translations for the placeholders.
  • For dual branded cards, we fixed the error where brand selection didn't work, meaning the shopper could only pay with the default card brand.
  • Fixed an issue with the PayPal Component, where setting a invalid color on PayPal Credit would cause an error. The Component now defaults to valid PayPal colors.
  • Fixed minor styling issues for the QiwiWallet Component.
Updating to this version

Install this version of the Adyen Web Node package:

Copy code
npm install @adyen/adyen-web@3.19.0 --save

Copy url
icon
Web Components/Drop-in v3.18.2

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

New

For dual-branded cards, the Card Component now renders both brands, and allows the cardholder to choose the brand they want to pay with.
This makes the Component compliant with European regulatory guidelines for accepting dual-branded cards (EU IFR Regulation 2015/751 article 8).

Fixed

The BIN lookup will no longer fail if no brands have been provided in the Card Component configuration.

Updating to this version

If you implemented SRI in test or with live region-specific URLs, you can now use the same SRI hashes below.

Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.18.2/adyen.js"
integrity="sha384-/5SuEQKK7mLmDWB+eUPAur02KPkNC7pwAqyPez1TuNjeqRjsNDJdAnrbSxrzua2P"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.18.2/adyen.css"
integrity="sha384-5K4T5NNVv7ZBvNypROEUSjvOL45HszUg/eYfYadY82UF4b+hc+TPQ4SsfTGXufJp"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.18.1

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

Improved
  • In the Google Pay Component, we added an onClick event that is triggered when the shopper selects the payment button. This allows you to perform a validation.
Fixed
  • With Google Pay, the payment form shows the amount correctly again.
Known issues
  • Dual branded cards cause a validation issue in the card component.
  • The BIN lookup will fail if no brands have been provided in the Card Component configuration. To avoid this, specify at least one supported card type in the brands field.
  • Both these issues are fixed in 3.18.2.
Updating to this version

If you implemented SRI in test or with live region-specific URLs, you can now use the same SRI hashes below.

Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.18.1/adyen.js"
integrity="sha384-CJ8FSR4EmldZPoNUHfpHrZ7CSOsP2lxp8xzSNIE92icrx46CmCoSxucO4IRE8h7V"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.18.1/adyen.css"
integrity="sha384-5K4T5NNVv7ZBvNypROEUSjvOL45HszUg/eYfYadY82UF4b+hc+TPQ4SsfTGXufJp"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.18.0

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

New
  • We added the following languages:

    Language locale
    Croatian hr-HR
    Czech cs-CZ
    Greek el-GR
    Hungarian hu-HU
    Romanian ro-RO
    Slovak sk-SK
    Slovenian sl-SI
Fixed
  • For buy now, pay later payment methods, we optimized how a delivery address is shown when it is pre-filled.
Known issues
  • Dual branded cards cause a validation issue in the card component.
  • The BIN lookup will fail if no brands have been provided in the Card Component configuration. To avoid this, specify at least one supported card type in the brands field.
  • Both these issues are fixed in 3.18.2.
Updating to this version

If you implemented SRI in test or with live region-specific URLs, you can now use the same SRI hashes below.

Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.18.0/adyen.js"
integrity="sha384-Ocy41f4hyu9o/iyAfs8EnK/3ykYlYfBh/8M+gr/slw4Ymmpw3Hqe5fsIqmkj1rrA"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.18.0/adyen.css"
integrity="sha384-cZIV5piH3KzCM9VwntcX2yQ9zLS8xvo9f0pld8RJe7mUBO2GcsgEmXkc78rH/UA3"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.17.2

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

Changed

The are some changes in how the payment method details for SEPA Direct Debit and Apple Pay are passed by Drop-in/Components in the state.data.paymentMethod object:

  • Apple Pay now outputs applePayToken instead of applepay.token
  • SEPA Direct Debit now outputs iban and ownerName instead of sepa.ibanNumber and sepa.ownerName
Improved
  • For the Gift Card Component, we made some improvements to the flow.
Known issues
  • Dual branded cards cause a validation issue in the card component.
  • The BIN lookup will fail if no brands have been provided in the Card Component configuration. To avoid this, specify at least one supported card type in the brands field.
  • Both these issues are fixed in 3.18.2.
Updating to this version

If you implemented SRI in test or with live region-specific URLs, you can now use the same SRI hashes below.

Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.17.2/adyen.js"
integrity="sha384-9+nLpCVhoDOcPA/0Ebl0pTB55CIWp+XEMxjyivaRhvFc/Unajqo+Q/7+8I6+MtEO"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.17.2/adyen.css"
integrity="sha384-cZIV5piH3KzCM9VwntcX2yQ9zLS8xvo9f0pld8RJe7mUBO2GcsgEmXkc78rH/UA3"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.17.1

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

Fixed
  • The Apple Pay Drop-in and Component can now use the configuration object from the /paymentMethods response, so you no longer need to specify merchantName or merchantIdentifier when you configure Drop-in or the Apple Pay Component.
  • For giropay, the showPayButton configuration is now used as expected.
Updating to this version

If you implemented SRI in test or with live region-specific URLs, you can now use the same SRI hashes below.

Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.17.1/adyen.js"
integrity="sha384-g2XbIbtGW37gzNsvYJCzK0sjzvxuwdFTzRdAwspE9of5k+jU8ny5Pq5Dw96regYV"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.17.1/adyen.css"
integrity="sha384-gbQyzqV1xX+snFEMrubEm0IpmYSufBjUnHzTaJZ+dcWCyxl0j94IZhnfC2gbxgeu"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.17.0

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

New

We have redesigned the flow for gift cards.

  • The Gift Card Component now calls an onBalanceCheck event when the shopper selects the Redeem button in the Component. You can use this event to trigger making the /paymentMethods/balance request from your server. Pass the response to the Component so that it can present the gift card balance in the UI.
  • The Gift Card Component now also calls an onOrderRequest event when the gift card balance is not enough to complete the payment. You'll need to use this event to make an /orders request from your server. The /orders endpoint allows you to combine the gift card with other payment methods to make partial payments.

Known issues

The new gift card flow does not show errors when a balance check fails. In scenarios where the payment amount is lower than the gift card's balance, the Component is unable to call the submit() function. These behaviors are improved in version 3.17.2.

Updating to this version

If you implemented SRI in test or with live region-specific URLs, you can now use the same SRI hashes below.

Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.17.0/adyen.js"
integrity="sha384-G9jkTAyCOIVdksXbtrNgdur2DyRi85ujYLXbqe5AvvH23rN21d7xiU7cRIqvsEaH"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.17.0/adyen.css"
integrity="sha384-gbQyzqV1xX+snFEMrubEm0IpmYSufBjUnHzTaJZ+dcWCyxl0j94IZhnfC2gbxgeu"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.16.0

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

Improved
  • When configuring the Google Pay Component, you can now include include the transactionInfo parameter.
  • The Apple Pay Component now uses the configuration object from the /paymentMethods response, so you no longer need to specify merchantName or merchantIdentifier when you configure the Component.
  • We now make the onValidateMerchant call by default for the Apple Pay Component. However, you can also choose to make the call manually, in which case your onValidateMerchant call overrides the default.
  • We improved the sourcemaps for the adyen.js files.
Fixed
  • The warning: paymentMethodsResponse was provided but no payment methods were found. will now only be shown if you provide a paymentMethodsResponse object without any valid payment methods.
Known issues
  • The Apple Pay Component was not getting the expected configuration values from the /paymentMethods response, so you still have to specify the values in the configuration object. This issue is fixed in version 3.17.1.
Updating to this version

If you implemented SRI in test or with live region-specific URLs, you can now use the same SRI hashes below.

Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.16.0/adyen.js"
integrity="sha384-CRV5O2tkmxc/chbXyRgG8vsJzVfFulg8F9LXsqAbcavAZKFJzNXRk5fbHBPI9IlW"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.16.0/adyen.css"
integrity="sha384-4ppagynsoxB4LNdDTdpX1No72EGOMm13+Y89hg+nz+dAIAWchOBTEnLL7u/hi6eM"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.16.1

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

Improved

This release improves build issues in version 3.16.0.

Fixed
  • We fixed an issue with selecting the gender drop-down for buy now, pay later payment methods.
  • Components for buy now, pay later payment methods no longer return undefined if the billingAddress and deliveryAddress are set as hidden.
Updating to this version

If you implemented SRI in test or with live region-specific URLs, you can now use the same SRI hashes below.

Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.16.1/adyen.js"
integrity="sha384-IOreZUn3JSJSXeX/xV17p9zCpXLjIwyB1jVdn1xXVJhhLsrBtC0N4EGmVbILt7eF"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.16.1/adyen.css"
integrity="sha384-Ivs7XmKB7ICQBw/FnU9DEmcIqOki5gTiT4M8J5JasU3DjBixkqSBH4QWSBkKPTnr"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.15.1

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

New
  • Added translation strings for installmentOptionMonths, installments.oneTime, installments.installments, and installments.revolving.
Improved
  • The BIN lookup functionality is now more reliable because it validates the card number after a new card brand is detected. This means the Card component gets the correct value even if the shopper pastes in a second valid card number.
Fixed
  • The MB WAY component now only shows validation errors on blur, that is when it's no longer in focus.
Updating to this version

If you implemented SRI in test or with live region-specific URLs, you can now use the same SRI hashes below.

Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.15.1/adyen.js"
integrity="sha384-18bB9irNIu0hQBFN+kxYgjeiMARTx7ukMoeFWLw/Autuyi+w0S9nXsf5Fn/VwmI+"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.15.1/adyen.css"
integrity="sha384-4ppagynsoxB4LNdDTdpX1No72EGOMm13+Y89hg+nz+dAIAWchOBTEnLL7u/hi6eM"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.15.0

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

New
  • We introduced a new method for Web Drop-in, closeActivePaymentMethod. This lets you close a selected payment method, for example if you want to reset Drop-in.
  • Support for installment options for card payments in Japan.
Improved
  • We improved the Google Pay Component:
    • existingPaymentMethodRequired is now set to false by default.
    • Increased the isAvailable timeout to accommodate higher latencies.
    • Removed the timeout for loading the Google Pay Web SDK file automatically so the Google Pay script can load properly.
  • Swapped the order for the shopperEmail and telephoneNumber input fields in the personal details component. The email appears first, followed by the telepohone number.
Changed
  • Removed the shopperEmail field from the MB WAY Component because it is no longer required by the payment method.
Fixed
  • The formatData field for the ACH payment method is now properly checking the format, and the margin is fixed when no holder name is shown.
  • When a shopper pastes a value into the card number field, we now correctly trigger the BIN lookup, clear the error and allow the shopper to make the payment.
Updating to this version

If you implemented SRI in test or with live region-specific URLs, you can now use the same SRI hashes below.

Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.15.0/adyen.js"
integrity="sha384-wRJEmCkwtDr3QqIA1UqInI8kmB6XerK8zxfIhP0bSk34lK/kyvE9bSewbrleIQwo"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.15.0/adyen.css"
integrity="sha384-4ppagynsoxB4LNdDTdpX1No72EGOMm13+Y89hg+nz+dAIAWchOBTEnLL7u/hi6eM"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.13.1

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

Fixed
  • Fixed issues with Google Pay and Drop-in:
    • Google Pay can no longer trigger the submit flow twice on the Drop-in.
    • Safari now correctly resolves the initial isReadyToPay promise on Drop-in when automatically loading the Google Pay API JavaScript library.
Updating to this version

If you implemented SRI in test or with live region-specific URLs, use the same SRI hashes below.

Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.13.1/adyen.js"
integrity="sha384-43SJm/Fc8D/N/UL7GYd+lUawkh0xQgdepGgkMMaoWKl0shiuU4yQrz6xYRMJvVI1"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.13.1/adyen.css"
integrity="sha384-AtxcD/Ax9ZRBLJ63s/bwCMrfe/mXWt4TF7F+Vltoxo0WgAwWjVNDsfyMAgY+9nBi"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.14.1

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

Improved

This release improves build issues in version 3.14.0.

Updating to this version

If you implemented SRI in test or with live region-specific URLs, use the same SRI hashes below.

Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.14.1/adyen.js"
integrity="sha384-6CKCjdBJ5e8ODBkoPb8aS4NUVZUT84+EwcOq/EdHIQJsHXZyRy4Hzmlo3Cm/3VX3"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.14.1/adyen.css"
integrity="sha384-dNVP3hcwQ/DJnbhWtKjt/xpYSDyS1Ch8m8tnxNehvZoGzcrjeGuKk9/dGstY+vxu"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.14.0

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

Improved
  • It is now possible to set the aria-label iframeTitle on the card fields.
Fixed
  • Full-width characters such as Japanese Katakana characters are now validated correctly.
  • We increased the time-out for loading device fingerprinting files, to prevent df-timeout errors from the onChange event when loading large device fingerprinting files.
  • Fixed an issue that occurred in some situations with prefilled data when redirecting.
  • Fixed an issue where the PayPal Component was not passing the correct component reference to the onCancel and onError events.
  • Clicking on the icon for a dual-branded card to select the card brand is working as expected again.
Updating to this version

If you implemented SRI in test or with live region-specific URLs, use the same SRI hashes below.

Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.14.0/adyen.js"
integrity="sha384-r16x+HZ6vkyWhMem7f3BaKcu23f64fnhpxflGasRv04Ii4ucIHagihmZj0Q5QSvA"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.14.0/adyen.css"
integrity="sha384-dNVP3hcwQ/DJnbhWtKjt/xpYSDyS1Ch8m8tnxNehvZoGzcrjeGuKk9/dGstY+vxu"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.13.0

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

Improved
  • Added field validation for:
  • For SEPA Direct Debit payments, the IBAN and name fields can now be filled in automatically. To do this, pass ibanNumber and ownerName to paymentMethodsConfiguration.
  • Apple Pay now uses the highest version supported by the shopper's device by default. You can override this setting in your Apple Pay configuration.
  • The Google Pay Component now uses the configuration object from the /paymentMethods response, so you no longer need to specify merchantIdentifier when configuring the Component.
  • Accessibility improvements:
    • If there is no aria configuration object, the component creates one with the default iframeTitle and error properties.
    • If an iframeTitle or error property is missing from the configuration object you defined, they are added automatically.
    • If no placeholder configuration object exists, one is created with a default and translated value.
    • For errors, the components use aria-live="polite". For example, if an error comes up when filling in the form, the screen reader will read the error text after it finishes reading the current text.
    • Screen readers no longer read a description for the payment method icons which are decorative. Instead, they read the text announcing the payment method.
  • The Web Drop-in integration now has a 1 second timeout for the isAvailable filter. This means that if a payment method fails to load, Web Drop-in continues to load the form for all other payment methods. The end result will not contain an error, it will be the Drop-in form without the payment method that failed to load.
Fixed
  • The PayPal Component no longer returns an error when calling unmount().
  • The aria label iframeTitle works correctly for the card and custom card integrations.
Updating to this version

If you implemented SRI in test or with live region-specific URLs, you can now use the same SRI hashes below.

Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.13.0/adyen.js"
integrity="sha384-cMH19I9HPj31iL3b/lcBcpsqbieCGSLyNef+RzjS7g3h5DhP2BI6j68/ogKSQCAh"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.13.0/adyen.css"
integrity="sha384-AtxcD/Ax9ZRBLJ63s/bwCMrfe/mXWt4TF7F+Vltoxo0WgAwWjVNDsfyMAgY+9nBi"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.12.1

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

Fixed
  • For giropay, setting the showPayButton: false now hides the Pay button.
Updating to this version

If you implemented SRI in test or with live region-specific URLs, you can now use the same SRI hashes below.

Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.12.1/adyen.js"
integrity="sha384-Z40LrT7R1YX9m5TJsqwQA5H3YqKvPA/DKBnPwXa4SwaDEs/feQSThsSph6PjbCQ1"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.12.1/adyen.css"
integrity="sha384-GYuZ2hTudNw7WyFFpYgZ2+Dd1a1QqD0d0u7p6RE9F6q2yNnIEe6gPNs+Ml0QI5Mt"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.12.0

Deprecated

This version will be [End-of-Life](/online-payments/upgrade-your-integration#lifecycle) on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

New
  • New supported payment method: Affirm.
Improved
  • The Swish Component now shows a pending message, warning shoppers about multiple charges if they try to pay again while the status is pending.
  • We improved the translation strings:
    • confirmPurchase is now Confirm purchase instead of Confirm Purchase.
    • voucher.collectionInstitutionNumber and installmentOption are now available for all supported languages.
  • PayEasy (econtext_atm) vouchers now show the Collection Institutions Number.
Fixed
Updating to this version

If you implemented SRI in test or with live region-specific URLs, you can now use the same SRI hashes below.

Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.12.0/adyen.js"
integrity="sha384-jH1pzFwMGYFHB6rut7oqTmHBMBdFhO+8vkYRhoX93CJePN7Ulx+US7H8lUkz/NP1"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.12.0/adyen.css"
integrity="sha384-GYuZ2hTudNw7WyFFpYgZ2+Dd1a1QqD0d0u7p6RE9F6q2yNnIEe6gPNs+Ml0QI5Mt"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.11.4

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

Fixed
  • If you're using a client key with wildcards in the allowed origins, the card fields now load even after changing domains, for example when the shopper switches country/region. The browser no longer caches the origin so you can use more than one origin in a browser session.
Updating to this version

If you implemented SRI in test or with live region-specific URLs, use the same SRI hashes below.

Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.11.4/adyen.js"
integrity="sha384-r6VzatKWD1SDwT5pfnl6sfkNJYAsTAUlUOO6PEbIhMwWFkPrE28R/8cjAKBp9yCd"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.11.4/adyen.css"
integrity="sha384-gTrHdtmLDTaHuDUKM1okZAVgBTwjiI+E66Tz3K71+10Lhd7zxvtUF5lrHc35cNIR"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.11.3

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

Improved
  • Added support for auto-completing the card expiry date in different formats. All non-numerical characters in date strings, such as ., -, and / are supported.
Updating to this version

If you implemented SRI in test or with live region-specific URLs, use the same SRI hashes below.

Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.11.3/adyen.js"
integrity="sha384-2t2P/ImpM1vBj1hfrMp6pHPcNk7U4OSZMADKPINi7Y9JEt5m2ul3COhwTMsrA3ab"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.11.3/adyen.css"
integrity="sha384-gTrHdtmLDTaHuDUKM1okZAVgBTwjiI+E66Tz3K71+10Lhd7zxvtUF5lrHc35cNIR"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.11.1

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

New
  • The Google Pay Component now automatically loads the Google Pay script if the Component doesn't detect the script in your front end. In previous versions, you had to handle this in your front end, making sure that you load the Google Pay API JavaScript library before the Adyen JS script.
Improved
  • Components for payment methods that use QR codes (such as Swish or WeChat Pay) now also calls onAdditionalDetails when the Component receives an error.
  • When using the Swish Component, the timeout for status checks is now increased to 15 minutes. The timeout used to be 3 minutes.
Fixed
  • We fixed the loading state for multiple Components (such as BLIK and Multibanco). In earlier versions, some Components didn't have a loading state so the Components weren't displaying the spinner while initializing.
  • We made the following fixes for the Card Component:
    • The Card Component now allows focus on optional security code fields.
    • We fixed the logic when validating extra fields required for AVS.
    • We fixed the valid state of ExpirationDate.
Updating to this version

If you implemented SRI in test or with live region-specific URLs, use the same SRI hashes below.

Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.11.1/adyen.js"
integrity="sha384-Br76hCQAZTck3C/I3hObqUc/2xXMC48wJfBURX/e25bpuI2wV4wHYPqbXXovHQ0D"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.11.1/adyen.css"
integrity="sha384-gTrHdtmLDTaHuDUKM1okZAVgBTwjiI+E66Tz3K71+10Lhd7zxvtUF5lrHc35cNIR"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.11.0

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

New

You can only use this new feature if you are using clientKey for your client-side authentication. If you are still using originKey, refer to our migration guide.

Unsupported cards are now blocked on the frontend. When a shopper provides an unsupported card type, the Component disables the payment form, and shows an Unsupported card error message.

In previous versions, you'd only find out if a shopper provided an unsupported card type when you receive an errorCode: 905 in the /payments response. In this version, the Component triggers an onError callback after it detects that the card type is unsupported. The callback also returns a detectedBrands array that indicates what type of card the shopper used.

Improved
Fixed
  • Apple Pay now uses the configuration.merchantName property as the default label for the total line item if the totalPriceLabel is not provided.
Updating to this version

If you implemented SRI in test or with live region-specific URLs, use the same SRI hashes below.

Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.11.0/adyen.js"
integrity="sha384-sR3tFyFWM09aya/mpkzB0fV4t+g6b4i64izXXy+lSSTmrgL/9/cdNFURV5T9gUbI"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.11.0/adyen.css"
integrity="sha384-8ofgICZZ/k5cC5N7xegqFZOA73H9RQ7H13439JfAZW8Gj3qjuKL2isaTD3GMIhDE"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.10.1

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

Fixed
  • Setting only the clientKey property in the configuration object, without the originKey, now works as expected.
Updating to this version

If you implemented SRI in test or with live region-specific URLs, use the same SRI hashes below.

Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.10.1/adyen.js"
integrity="sha384-wG2z9zSQo61EIvyXmiFCo+zB3y0ZB4hsrXVcANmpP8HLthjoQJQPBh7tZKJSV8jA"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.10.1/adyen.css"
integrity="sha384-8ofgICZZ/k5cC5N7xegqFZOA73H9RQ7H13439JfAZW8Gj3qjuKL2isaTD3GMIhDE"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.10.0

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

New
  • Added support for callbackIntents on the Google Pay component. This allows for updating the price dynamically when certain information changes. Refer to PaymentDataCallbacks.
Improved
  • Added support for plurals and string interpolation on translations.
  • We now generate one set of SRI hashes, so now you can use the same SRI hash regardless of where you are loading Adyen JS and CSS files from—test or live, including from live region-specific URLs.
Fixed
  • With Web Drop-in the dropin.submit() is once again working with Google Pay.
  • Fixed an issue in Web Drop-in where selecting "Pay" on stored cards didn't trigger the onSubmit() callback due to the billingAddressRequired property.
  • Chrome autofill on iOS now works as expected, and setting the value of placeholder to null no longer throws an error.
Updating to this version

If you implemented SRI in test or with live region-specific URLs, you can now use the same SRI hashes below.

Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.10.0/adyen.js"
integrity="sha384-ghytckjc6RtqM4eKYE4LBJRtqZWcxPv/sGamiebH2dY3tyiQYUOZnPJ0s27de7vB"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.10.0/adyen.css"
integrity="sha384-8ofgICZZ/k5cC5N7xegqFZOA73H9RQ7H13439JfAZW8Gj3qjuKL2isaTD3GMIhDE"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.9.5

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

Fixed
  • When using the Component to collect billing address, countries/regions with state datasets now get correctly validated when the state field value changes.
Improved
  • Components for payment methods where you receive an await action type (such as MBWAY and BLIK) now always calls onAdditionalDetails when the Component receives an error.

  • The storePaymentMethod field is now sent in the state.data object as long as enableStoreDetails is set to true (the Save details for next time checkbox is shown in the UI). If the shopper doesn't select the checkbox, the state.data.storePaymentMethod field will have a value of false.

Updating to this version
Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.9.5/adyen.js"
integrity="sha384-uOrvYLSC+gNG9rRi6gKnzTwPsO7Hi5KHOlZGl8CR3tA0s/0HLOvU9ViyJTWEcNk1"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.9.5/adyen.css"
integrity="sha384-6qrXvoxlnBlrflZQ9g5Yf5oZapUSSXctPxacP9oRcEukbEO7lXisuSyMKG8pDX8V"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.9.4

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

Fixed
  • Fixed an issue regarding validation of the billing address in the Card Component where a pre-filled country/region with no states available still waits for a state or province field to be provided.
  • Fixed an issue where the Card Component state does not update the address data until the country/region is changed.
  • Fixed an issue where MBWay Component accepted different names for shopperEmail and telephoneNumber parameters in the request.
  • Fixed an issue regarding validation when a namePrefix is passed to the personalDetails shopper input fields.
Updating to this version
Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.9.4/adyen.js"
integrity="sha384-/rpftrZptnl7EIuIvqz4PAEehQoysKXmwqUAGyH9lK3WHgcvY0lWj/S5LH7xrbf+"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.9.4/adyen.css"
integrity="sha384-6qrXvoxlnBlrflZQ9g5Yf5oZapUSSXctPxacP9oRcEukbEO7lXisuSyMKG8pDX8V"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.9.1

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

Fixed
  • The state.data.paymentMethod.brand field now shows the brand of the stored cards again.
  • We fixed the translation strings for da-DK and added the missing translation strings for ko-KR.
  • If an invalid blikCode is entered on the front-end, the error message is now correctly reflected.
Updating to this version
Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.9.1/adyen.js"
integrity="sha384-5RGbm/PP27SIGIeNaNn7l1S152uTFxajye1u1O7iVhQDPo5+uJ9uzT+D01cWFT1k"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.9.1/adyen.css"
integrity="sha384-6qrXvoxlnBlrflZQ9g5Yf5oZapUSSXctPxacP9oRcEukbEO7lXisuSyMKG8pDX8V"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.9.2

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

Updating to this version
Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.9.2/adyen.js"
integrity="sha384-0CZVjqVYBiMd+93KP09SDniCpCV0cP2g40JBhpN0+7Oq5hzI+JqdzJu9S1+B5tDn"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.9.2/adyen.css"
integrity="sha384-6qrXvoxlnBlrflZQ9g5Yf5oZapUSSXctPxacP9oRcEukbEO7lXisuSyMKG8pDX8V"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.9.3

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

Updating to this version
Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.9.3/adyen.js"
integrity="sha384-q0+/vVCY8/PdVap8fjVJm5zYIy08aNdQuBhvk6pnocoDW3IqqdeyCMQH1i+M1EEt"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.9.3/adyen.css"
integrity="sha384-6qrXvoxlnBlrflZQ9g5Yf5oZapUSSXctPxacP9oRcEukbEO7lXisuSyMKG8pDX8V"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.9.0

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

New
Improved
Fixed
  • Double-clicking a Google Pay button started a session twice, resulting in an error. We fixed this so you can now double-click a Google Pay button without initiating a new session.
  • The 3D Secure 2 Component no longer tries to parse invalid postMessages.
  • We fixed an issue where the CVC field for saved Maestro cards was required even when it is optional.
  • When a shopper entered a credit card number using copy and paste or auto-fill, the onBinValue callback triggered by the Custom Card Component provided an encrypted BIN number. Now, the onBinValue callback provides the actual BIN number, no matter how the card number is filled in.
Updating to this version
Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.9.0/adyen.js"
integrity="sha384-3aCAMK3oy4UGDOFOxcOniJ10zapprDSOh8hhrBgZ4wkDiw2bVy6MvABAE8UKvhS5"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.9.0/adyen.css"
integrity="sha384-ECaUNUNaCM7I7c5adYdR56IIBUZtY3ax03DAYSyGIFls9wP7+6ZyHxlBNzAG5qT7"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.8.1

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

Updating to this version
Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.8.1/adyen.js"
integrity="sha384-pLfJ6XKllmblOK86IVevGarh2cfeBr6lWAEkumlMA3hgTqKpEgNn8ID7zq4HsC6H"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.8.1/adyen.css"
integrity="sha384-y1lKqffK5z+ENzddmGIfP3bcMRobxkjDt/9lyPAvV9H3JXbJYxCSD6L8TdyRMCGM"
crossorigin="anonymous">
Improved
  • Masking on date inputs is now supported on browsers that do not have native support for date inputs (such as Safari and Internet Explorer).
  • Age validation is now supported in the Date of birth field on the Oney3x4x Component.
  • Installment options for credit cards are now hidden when the amount is set to 0.
Fixed
  • Resolved a Google Pay issue where double-clicking the Google Pay button would initiate two separate payments.
  • Resolved a Google Pay issue where Drop-in would, in some cases, open up a new payment sheet when selecting Continue on the Google Pay sheet.

Copy url
icon
Web Components/Drop-in v3.8.0

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

New
Improved
  • allowCreditCards configuration is now available on the Google Pay Component and Drop-in.
  • The PayU NetBanking Component and the PayU CashCard Component now provide drop-down issuer lists.
Updating to this version
Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.8.0/adyen.js"
integrity="sha384-rwJ33r9d5uXn5L8KSr4UqcaSaAHs2NQNjtNCvclBkZ8P36yDAXQq65YPX+q1LiEr"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.8.0/adyen.css"
integrity="sha384-y1lKqffK5z+ENzddmGIfP3bcMRobxkjDt/9lyPAvV9H3JXbJYxCSD6L8TdyRMCGM"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.7.0

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

Changed
  • Drop-in/Components no longer support the native Klarna integration. Klarna is now only supported through the redirect integration.
New
Improved
  • The Card Component/Drop-in now show a visual hint for the location of the CVC/CVV on the card.
  • We added VPay to the card brands recognized by the Card Component/Drop-in.
Fixed
  • A saved card is no longer breaking if the card type is not recognized.
  • When using Internet Explorer 11, the card number can no longer cause the browser to freeze.
Updating to this version
Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.7.0/adyen.js"
integrity="sha384-QCQYNjVhSRlEZczHTuiZWQuyFi5btsJ/c2otY6apbNM32EdkEDC6rdlJXeubWs9V"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.7.0/adyen.css"
integrity="sha384-y1lKqffK5z+ENzddmGIfP3bcMRobxkjDt/9lyPAvV9H3JXbJYxCSD6L8TdyRMCGM"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.6.3

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

New

Added support for the Gift Card Component.

Fixed
  • We fixed an issue where the Custom Card Component would not auto-complete the date when using separate date fields.
  • We fixed an issue where Elo and Hipercard cards were not validating correctly in the Card and Custom Card Components.
Updating to this version
Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.6.3/adyen.js"
integrity="sha384-sW7LTx7Q+1PgLUEUyxTGnmFsfMuZHDpIoIz2Tds1KroBZiT29OnTXZmV+nGhRxvO"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.6.3/adyen.css"
integrity="sha384-l5/gSrWMFWCKnEqoG1F21fvhDesLnZt/JlXjkA0FWp6E68Pc/9mxg+nPvvx+uB4G"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.6.2

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

New

Added a new Component for making donations, using Adyen Giving.

Fixed
Updating to this version
Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.6.2/adyen.js"
integrity="sha384-xSgkLL5lvMeIIIngOV++b3U0H89TafFDytrHgPVydPopZ/WuAw1Ry8xbGeeLMqQM"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.6.2/adyen.css"
integrity="sha384-l5/gSrWMFWCKnEqoG1F21fvhDesLnZt/JlXjkA0FWp6E68Pc/9mxg+nPvvx+uB4G"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.6.1

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

Fixed
Updating to this version
Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.6.1/adyen.js"
integrity="sha384-hUb/CFxzLJZWUbDBmQfccbVjE3LFxAx3Wt4O37edYVLZmNhcmVUyYLgn6kWk3Hz+"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.6.1/adyen.css"
integrity="sha384-l5/gSrWMFWCKnEqoG1F21fvhDesLnZt/JlXjkA0FWp6E68Pc/9mxg+nPvvx+uB4G"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.6.0

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

New
  • New supported payment method: Automated Clearing House (ACH). We also support sending in encrypted ACH details.
  • Added support for handleAction in Components integrations.
Fixed
  • The Custom Card Component now supports brands configuration.
  • We fixed an issue with card holder name validation when auto-completing card details in Chrome.
Updating to this version
Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.6.0/adyen.js"
integrity="sha384-Ae3bpVd/uyREJxla2lRiuEXoYQA/WReCh/h1+sek9TFeq6iwAVBu9tDyMJNzpZHc"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.6.0/adyen.css"
integrity="sha384-NzXIrom1g7+1OMBJWAyapJ4yYXLFHdsE1ZxOVstMQVwURFl3RXldhYENYkBaBjL8"
crossorigin="anonymous">

Copy url
icon
Web Components/Drop-in v3.5.0

Deprecated

This version will be End-of-Life on October 1, 2025.
We recommend that you upgrade to v6.0.0 or later.

New
  • Support for Subresource Integrity (SRI) hashes

    You can now use SRI hashes to ensure that the files you are loading from Adyen have not been manipulated or tampered with by malicious actors.

    To use the SRI hash, you need to add an integrity attribute when specifying <script> or <link> elements. Browsers will also check for the crossorigin attribute to ensure that the origin allows Cross-Origin Resource Sharing (CORS). If a browser detects that the file's hash does not match the specified hash, the browser will not load the resource. To know which browsers support SRI, refer to this browser compatibility list.

    For example, here is how you specify version 3.5.0 adyen.js and adyen.css resources:

    Copy code
    <script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.5.0/adyen.js"
    integrity="sha384-MpcW2OFcC1/y5nwF6UmvRfDXGISpg1rowHVybiS+wJObkUwgFpvbdpJxR2/bwmeA"
    crossorigin="anonymous"></script>
    Copy code
    <link rel="stylesheet"
    href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.5.0/adyen.css"
    integrity="sha384-aWycvW8Dygg+6QHTq56FJMi4CJBjQt4LbRO3zWUuyfbv0A8g3rb5FR/vHyHKfiY0"
    crossorigin="anonymous">

    You can find the SRI hashes for all previous versions of our JavaScript and CSS files added in their corresponding release notes.

  • You can now render billing address fields in Drop-in and Card Component to collect the shopper's billing address for Address Verification System (AVS) implementation.

  • Drop-in and Components for payment methods that support saving payment details for recurring transactions can now show a preauthorization button. Instead of a Pay button, the button prompts the shopper to confirm the preauthorization. The preauthorization button is shown when you send a zero value amount (zero-auth transaction).

Improved

shippingOptionRequired and shippingOptionParameters configuration are now available on Google Pay Component and in Drop-in.

Fixed
Updating to this version
Copy code
<script src="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.5.0/adyen.js"
integrity="sha384-MpcW2OFcC1/y5nwF6UmvRfDXGISpg1rowHVybiS+wJObkUwgFpvbdpJxR2/bwmeA"
crossorigin="anonymous"></script>
<link rel="stylesheet"
href="https://checkoutshopper-live.adyen.com/checkoutshopper/sdk/3.5.0/adyen.css"
integrity="sha384-aWycvW8Dygg+6QHTq56FJMi4CJBjQt4LbRO3zWUuyfbv0A8g3rb5FR/vHyHKfiY0"
crossorigin="anonymous">