Release notes

• You can now offer Apple Pay on third-party browsers. See offering Apple Pay on the web to learn more.

• 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.

• 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.

• Supported payment method: PayTo. Payment method type: payto.

• 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.

• 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.

• For the address lookup feature:
  • The input is now retained when changing countries.
  • The loading spinner moved to the search bar to prevent "jumping" of the view.
  • The keyboard is now hidden when:
  • An address is selected.
  • A search query is submitted
  • The manual entry button is selected.

• For the address lookup feature, the address format is now two lines.

• For Google Pay, when a user cancels the flow, you now get GooglePayCancellationException in onError.

• The minimum supported SDK versions:

  Name	Version
  Compile SDK version	35
  Target SDK version	35

• Dependency versions:

  Name	Version
  AndroidX Activity	1.10.0
  AndroidX RecyclerView	1.4.0
  AndroidX Activity Compose	`1.10.0
  Android Gradle Plugin	8.8.0

• For Twint with Sessions flow, setting storePaymentMethodMode: enabled now correctly stores the payment method.
• For the address lookup feature, when selecting a different address, it now correctly updates the input fields on the payment form.

• The payment page now contains a country selector. When a payment link does not contain country information, shoppers are now prompted to select their country.

• The payment page now contains a country selector. When a payment link does not contain country information, shoppers are now prompted to select their country.

• For custom card with API only integration, added validators for the following.
  • Card number.
  • Card expiry date.
  • Card security code.
• iOS Components/Drop-in version: 5.15.0.

• For the Card Component, on Android 8 (API level 26) or earlier, the pay button no longer has ripple animations to prevent an animation crash.

• For native 3D Secure 2, when a shopper cancels the payment during the payment flow, the didProvide() delegate method is now triggered. What this means for your integration depends on whether you already make a /payments/details call to handle 3D Secure 2 errors:
  • If yes, you do not need to make any changes to your integration.
  • If not, update your integration to make a /payments/details request to get the details of the canceled transaction.

• Support to distinguish between the regular redirect flow where you redirect the shopper through the browser and native redirects to improve the handling of failed native redirects.

For iDEAL, the shopper now gets redirected to an iDEAL-hosted page to select their issuer and finish the payment.

• For iDEAL, the shopper now gets redirected to an iDEAL-hosted page to select their issuer and finish the payment.

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

• Simplified integration for Google Pay:
  • The Component now includes the Google Pay button, and you no longer have to display the button with your own configuration.
  • The Component now does the availability check on initialization.
  • The deprecated onActivityResult is no longer needed.
    See the migration guide to learn about the changes you have to make to your integration to support Google Pay on this version.
• Drop-in now shows a toolbar on more intermediary screens to let shoppers navigate back easily.

• For native 3D Secure 2, when a shopper cancels the payment during the payment flow, the onAdditionalDetails() event is now triggered. What this means for your integration depends on whether you already make a /payments/details call to handle 3D Secure 2 errors:

  • If yes, you do not need to make any changes to your integration. You can remove the Cancelled3DS2Exception handler.
  • If not, update your integration to make a /payments/details request to get the details of the canceled transaction.

• Dependency versions:

  Name	Version
  Android Gradle Plugin	8.7.3
  AndroidX Compose BoM	2024.12.01
  AndroidX ConstraintLayout	2.2.0
  AndroidX Lifecycle	2.8.7
  AndroidX Lifecycle ViewModel Compose	2.8.7
  KotlinX Coroutines Play Services	1.9.0

• We are changing the default branch of our SDK repository from develop to main. If you use our SDK repository and work with the develop branch, we recommend to switch to main. The develop branch will be removed within the next few weeks.

• The styles and strings for the Cash App Pay loading indicator. use the new styles and strings instead.

  Previous	Now
  AdyenCheckout.CashAppPay.ProgressBar	AdyenCheckout.ProcessingPaymentView.ProgressBar
  AdyenCheckout.CashAppPay.WaitingDescriptionTextView	AdyenCheckout.ProcessingPaymentView.WaitingDescriptionTextView
  cash_app_pay_waiting_text	checkout_processing_payment

• For Trustly, missing translations have been added.

• 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.

• 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.

• When using Drop-In: the maxIssuerNumber for Twint can now be set.

• You can now highlight a list item by changing its background color when the shopper selects it. To do this, use the new optional ListItemStyle.highlightedBackgroundColor property. Contribution by Github user.

• For Drop-in, some components that are used in the same Drop-in session no longer have stale parts such as the following:
  • For gift cards, error messages.
  • For cards, brand logos.
• If your app uses more than one payment service provider SDK that uses the TwintSDK, a potential runtime crash no longer occurs.

• iOS Components/Drop-in version: 5.14.0.
• Android Components/Drop-in version: 5.8.0. Gradle v8 is now required.
• iDEAL is now available through the Instant Component.
• For the Google Pay Component on Advanced flow, added loading bottom sheet.
• The paymentSessionFinished payment result now contains sessionResult.
• You can now make partial payments with Drop-in also on the Advanced flow.

• For the Card Component, improved the dynamic viewport.

• Removed the alert message that appeared when deleting a stored payment method fails.

• The Klarna Component encounters an error when initializing the Klarna Widget SDK. Fixed in v6.7.0.

• For the online banking payment methods in Slovakia and the Czech Republic, bank logo icons now appear in the list of banks.

• 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.

• 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.

• Payment method: Pay by Bank US. Payment method type: paybybank_AIS_DD.

• Dependency versions:

  Name	Version
  Android Gradle Plugin	8.7.1
  AndroidX Fragment	1.8.5
  AndroidX Activity	1.9.3
  AndroidX Autofill.	1.3.0-beta01
  AndroidX Annotation.	1.9.1.
  AndroidX Compose Activity	1.9.3
  AndroidX Compose BOM	2024.10.00
  AndroidX Lifecycle	2.8.6
  AndroidX Lifecycle ViewModel Compose	2.8.6

• For cards, the address lookup functionality no longer crashes if the shopper presses back when the postal code field is in focus.
• For Drop-in, fixed an issue where the error dialog showed loading state in some edge cases.

• For Component integrations, you can now implement a custom pay button. Use the following:

  	Description
  showsSubmitButton	Set to false to hide the default pay button. Default: true.
  validate()	Validates the payment data.
  submit()	Submits the payment data.

• For Twint, you can now reduce the required number of LSApplicationQueriesSchemes values. In TwintActionComponent.Configuration, set the new maxIssuerNumber property.
• For Boleto Bancario, support for the following payment method types:
  • Boleto Bancario Itaú: boletoBancarioItau
  • PrimeiroPay Boleto: primeiroPayBoleto
  • Boleto Bancario: boletoBancario
• For Pay by Bank in the US, support for stored payment methods.

• For Pay by Bank payments in the US (payment method type:paybybank_AIS_DD): Drop-in now shows supported bank logos and a confirmation screen, before redirecting the shopper to the issuer.
• For Delegated Authentication: during Secure Checkout, you can now optionally reset credentials on the error screen.
• Twint SDK version: v8.0.2.

• For Titres-Restaurant meal vouchers, the correct type and brand values are now included in the payment details.

• For cards, when the expiryDate is only one digit, the onBlur validation now gets triggered.

• For the address lookup functionality:
  • Address data is now correctly saved to PaymentComponentData.
  • Address fields that were edited manually no longer lose their state when starting lookup mode.

• Support for tokenization in Twint payments, allowing shoppers to securely save their Twint payment details for future transactions.

• For testing during development, the UISwitch testability is now enabled for external tools like Appium.
• For delegated authentication, payment information is consumed so that the UI shows the card number, brand logo, and payment amount.

• CashAppPay SDK Version: 0.6.2

• For cards:
  • In the Expiry date field, when the shopper tries to enter additional characters to the field after having already entered characters, the field no longer ends up in an invalid state.
  • In the Card number field, the shopper can now move the cursor and edit the number where the cursor is positioned.

• If you use Call Center for Mail Order/Telephone Order (MOTO) transactions: when you go to the Call Center URL, you are now redirected to the Virtual Terminal URL.

• 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.

  

• 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.

• 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.

• The /cardDetails response now includes:
  • fundingSource: the funding source of the card, for example DEBIT, CREDIT, or PREPAID.
  • isCardCommercial: indicates if the card is a commercial card or a consumer card.

• 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.

• For improved developer experience, we now export the CustomTranslations type.
• document.querySelector is now called only once, instead of three times.

• 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.

• For ACH, the shopper can now select the Savings or Checking account type.

• get-process-message.handler.js no longer causes exceptions. The new optional chaining operator for the postMessage handler function now prevents improperly formed events.

• You can now use Adyen Test Cards Android to autofill test payment method information, to test your integration more quickly.

• For Twint:

  • For Components integrations, you must now use TwintComponent instead of InstantPaymentComponent.
  • You can now store payment details and pay with stored payment details.

• For French meal vouchers, the following payment method types are now available:

  • Up. Payment method type: mealVoucher_FR_groupeup.
  • Natixis. Payment method type: mealVoucher_FR_natixis.
  • Sodexo. Payment method type: mealVoucher_FR_sodexo.
    Learn to configure French meal vouchers.

• For API-only integrations with encrypted card details, you can now use the following classes to validate corresponding fields:

  Class	Description
  CardNumberValidator	Validates the card number field.
  CardExpiryDateValidator	Validates the expiry date field.
  CardSecurityCodeValidator	Validates the security code field.

• Support for the following locales:

  Locale	Values
  Catalan	ca-ES
  Icelandic	is-IS
  Bulgarian	bg-BG
  Estonian	et-EE
  Latvian	lv-LV
  Lithuanian	lt-lT

• For UPI Intent, if the shopper selects the Continue button without selecting an UPI option, an error message now shows.
• For Drop-in, in the navigation bar, the accessibility of the Back/Close button is improved.

• For Drop-in, headers of preselected stored payment screen and payment methods list screen are updated.

• Dependency versions:

  Name	Version
  Adyen 3DS2	2.2.21
  Cash App Pay	2.5.0
  Android Gradle Plugin	8.5.1
  AndroidX Fragment	1.8.3
  AndroidX Activity	1.9.2
  AndroidX Compose Activity	1.9.2
  AndroidX Compose BOM	2024.06.00
  AndroidX Lifecycle	2.8.3
  AndroidX Lifecycle ViewModel Compose	2.8.3
  AndroidX AppCompat	1.7.0

• When parsing JSON objects with explicit null values, JSON deserialization no longer returns the coerced null string.

• The style for payment method list headers. Use the new style instead.

  Previous	Now
  AdyenCheckout.TextAppearance.HeaderTitle	AdyenCheckout.TextAppearance.HeaderLabel

• The com.adyen.checkout.instant.ActionHandlingMethod method. Use the new method instead.

  Previous	Now
  com.adyen.checkout.instant.ActionHandlingMethod	com.adyen.checkout.components.core.ActionHandlingMethod

• For Drop-in, you can now display custom names for the payment methods in your checkout. Use the paymentMethodNames object to set the name for each payment method.
• When a shopper cancels the payment during the 3D Secure 2 flow, the payment result is now PaymentCancelledByUser.

• For Apple Pay, improved the instantiation of the payment method component.
• For Google Pay, improved configuration parsing.

• On iOS 18, if the shopper has two identical stored payment methods, Drop-in/Component no longer crashes when the shopper selects a payment method that's not the default stored one.

• On iOS 18, if the shopper has two identical stored payment methods, Drop-in/Component no longer crashes when the shopper selects a payment method that's not the default stored one.

• You can now use the AdyenEncryption module independently with a reduced size, because it no longer depends on AdyenCore.

• Support for Library Evolution in Swift.

• When you set isEnabled = false, only Drop-in/Components analytics are not sent to Adyen.

• Removed the unused getReturnURL declaration from the SessionHelper module to compile the library correctly when React Native New Architecture is enabled.

• Bumped serve-static version to 1.16.2 to address security vulnerability.

• 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.

• For Click to Pay with Visa, when the shopper selects Enter, the event no longer propagates to other views.

• 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.

• Reverted the new iDeal payment flow that was released in 2 September, 2024.

• Fixed an issue where payments with the following paymentMethod.type would break in some cases:
  • klarna
  • klarna_account
  • klarna_paynow
  • klarna_b2b
  • walley
  • walley_b2b
  • ebanking_FI
• When blockedPaymentMethods is set to scheme, Bancontact is no longer blocked.

• 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.

• When you set analytics.enabled = false, only Drop-in/Components analytics are not sent to Adyen.

• 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.

• 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.

• When you set analytics.enabled = false, only Drop-in/Components analytics are not sent to Adyen.

• iOS Components/Drop-in version: 5.11.0.

• For Android, improved component bottom sheet behavior.
• For cards, improved the component for shopper devices that use large font and display sizes.
• Migrated the Android example to use Flutter Gradle plugins through the Plugin DSL.

• Support for Apple Pay recurring payments.
• For Drop-in, you can now set showRemovePaymentMethodButton to true to allow your shoppers to remove their stored payment details.
• iOS Components/Drop-in version: 5.11.0.

• AdyenAction is now exported correctly.
• Fixed an issue where AdyenInstant and other components were not loading correctly on React Native versions earlier than 73. This fixes the known issue in v2.3.0.

• The following protocol and classes that were recently made internal (@_spi(AdyenInternal)) are now public again:
  • Validator
  • CardNumberValidator
  • CardExpiryDateValidator
  • CardSecurityCodeValidator
  • LengthValidator
  • NumericStringValidator
• TWINT SDK version: 8.0.1

• The privacy manifest path in Package.swift now ensures correct Swift Package Manager (SPM) integration.

• Removed the unused region role from the payment method item to follow a11y guidelines.

• Fixed validation for Lithuanian postal codes to support inputs with 4 digits, 5 digits, and the LT prefix.

• Removed the unused region role from the payment method item to follow a11y guidelines.

• Fixed validation for Lithuanian postal codes to support inputs with 4 digits, 5 digits, and the LT prefix.

• The new iDEAL payment flow where the shopper is redirected to the iDEAL payment page to select their bank and authorize the payment.
  This change is reverted in a later release.

• 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.

• Updated currency information for the following locales:
  • Iceland (ISK)
  • Bulgaria (BGN)

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

• 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.

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

• iOS Components/Drop-in version: 5.10.0.
• For cards, you can now set addressVisibility: lookup to suggest addresses to the shopper when they are inputing their address.

• For React Native v73 and earlier, AdyenInstant and other components do not load correctly. This issue is fixed in v2.4.0

• The example app now uses React Native v74.

• For Riverty, the consent checkbox now includes a link to the Riverty privacy policy.

• For Riverty, the consent checkbox now includes a link to the Riverty privacy policy.

• Support for the UPI Intent flow, where the shopper can choose a UPI app to pay through. They are redirected to and complete the payment on the selected app.
• For Drop-in with Sessions flow, the shopper can now remove their stored payment methods. To do so:
  • In the /sessions request, include showRemovePaymentMethodButton: true.
  • Set the StoredPaymentMethodsDelegate to session:

    Copy code
    dropInComponent.StoredPaymentMethodDelegate = self.session

• Support for the following locales: bg-BG,ca-ES, et-EE,is-IS,lt-LT,lv-LV.

• For cards, when the shopper selects Cancel to exit the address input screen, the address fields no longer gets reset.

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

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

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

• The onOrderCreated() event is renamed to onOrderUpdated().

• 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.

• 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.

• 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.

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

• Starting August 31 2024, Google introduces Target API level requirements for Google Play apps. If you use:
  • React Native v73 or later, you do not need to take any action.
  • React Native v72, you have to:
  • • In android/build.gradle, update compileTarget to 34, and set classpath("com.android.tools.build:gradle:8.1.4”).
  • • In android/app/build.gradle, add android.buildFeatures.buildConfig = true to enable buildConfig.
  • React Native v71 or earlier:
  • • In android/build.gradle, update compileTarget to 34.

• Android Components/Drop-in version: 5.6.0.

• Updated the gradle.build to fix potential compatibility issues with old and new versions of React Native.

• On Android API versions 21 to 25, the NoSuchMethodError no longer occurs during the 3D Secure 2 challenge flow.

• Dependency versions:

  Name	Version
  Adyen 3DS2	2.2.19

• For Google Pay on Advanced flow, onSubmit now returns threeDS2SdkVersion in the paymentMethod object that you must pass in your /payments request to correctly trigger the 3D Secure 2 flow.

• On Android API versions 21 to 25, the NoSuchMethodError no longer occurs during the 3D Secure 2 challenge flow.
• When using R8 to shrink your code, CIRCULAR REFERENCE: com.android.tools.r8.utils.b: Missing class... errors no longer occur.

• Dependency versions:

  Name	Version
  Adyen 3DS2	2.2.19
  Android Gradle plugin	8.4.1
  AndroidX Fragment	1.7.1
  AndroidX Compose Compiler	1.5.14
  Kotlin	1.9.24
  Kotlin coroutines	1.8.1

• For Google Pay, configurations related to the billing and shipping addresses now work correctly.
• On Android, the Inconsistent JVM-target compatibility build issue no longer occurs.

• iOS Components/Drop-in version: 5.9.0.
• Android Components/Drop-in version: 5.5.0.
• The new iDEAL payment flow where the shopper is redirected to the iDEAL payment page to select their bank and authorize the payment.

• Support for the UPI Intent flow, where the shopper can choose a UPI app to pay through. They are redirected to and complete the payment on the selected app.
• The new iDEAL payment flow where the shopper is redirected to the iDEAL payment page to select their bank and authorize the payment.

• Autofill support for the following:
  • For gift cards, the gift card number and PIN fields.
  • For UPI Virtual Payments, the address field.
  • For payment methods that use them, the address input fields.
• Drop-in navigation:
  • Added the top navigation bar.
  • Disabled the dragging gesture that caused Drop-in to be dismissed.
  • When the shopper navigates from an additional action screen (for example 3D Secure), Drop-in is dismissed.

Dependency versions:

We recommend that you remove the following from your integration, because they no longer have an effect on the iDEAL payment method.

• For IdealComponent:
  • isConfirmationRequired()
  • submit()
• For iDEAL configuration:
  • setViewType()
  • setHideIssuerLogos()
  • setSubmitButtonVisible()

• For Expo v47 and later, version conflicts no longer occur.

• 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.

• 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.

• For Click to Pay, previously used cards now shown above newly created cards.
• For ACH, the showPayButton configuration is no longer ignored.

• Drop-in now supports the Sessions flow, where you make a single /sessions request.
• You can now specify a locale instead of using the shopper device locale.
• Support for Expo.
• You can now use the AdyenAction.handle() method to handle additional actions.
• For Native 3D Secure 2, you can now configure the requestorAppUrl.
• For Drop-in on iOS, you can now configure a custom title for the pre-selected stored payment method view. 

• For Apple Pay, you can now configure shippingContact, shippingType, shippingMethods, and supportedCountries.
• The AdyenCheckout theme is now separated from the AppTheme, which makes it easier to integrate with Drop-in.

• For Android, you no longer need to have <service android:name="com.adyenreactnativesdk.component.dropin.AdyenCheckoutService" android:exported="false" /> in your app's manifest file.

• For Android, adyenReactNativeRedirectScheme is deprecated, you can use any intent filter. When it is required, you get a returnUrl in onSubmit.data. To get the returnUrl, you can also use the await AdyenDropIn.getReturnURL() function.

• For Android, your app theme must have Material Components as parent to work with payment methods that use the InstantPaymentComponent, for example:

  Copy code
  <style name="AppTheme" parent="Theme.MaterialComponents.DayNight.NoActionBar"> 

• For external redirects, you can now customize the colors of the toolbar and navigation bar shown in Custom Tabs.

• TWINT is now supported with a native flow, and you no longer need to redirect shoppers through the browser. To use the redirect flow, set the following configuration:

  Copy code
  CheckoutConfiguration(
      environment = environment,
      clientKey = clientKey,
      ..
  ) {
      // Optionally pass the payment method type to configure it for the specific payment method.
     instantPayment(PaymentMethodTypes.TWINT) {
         setActionHandlingMethod(ActionHandlingMethod.PREFER_WEB)
     }
  }

• Fixed some memory leaks.
• In case of a debug build, Drop-in no longer overrides the log level.
• For cards, when a shopper does not select an address, the address lookup function now shows a validation error.
• Actions no longer crash when your app uses obfuscation.
• When handling a 3D Secure 2 challenge using Checkout API v66 or earlier, Drop-in no longer throws an error.
• If the app process unexpectedly terminates when handling actions, the state is now restored and you can proceed with the payment flow.
• For /sessions, fixed an issue where the setEnableRemovingStoredPaymentMethods flag in the Drop-in configuration was ignored.

• The phone number input field in the payment form now shows ISO codes instead of flags.
• The UI elements that were previously labelled Country are now Country/Region.

• Dependency versions:

  Name	Version
  Adyen 3DS2	2.2.18
  Android Gradle plugin	8.3.2
  AndroidX Browser	1.8.0
  AndroidX Compose Activity	1.9.0
  AndroidX Compose BoM	2024.04.01
  AndroidX Compose Compiler	1.5.12
  AndroidX Lifecycle	2.7.0
  Google Pay	19.3.0
  Google Pay Compose Button	1.0.0
  Kotlin	1.9.23
  Kotlin coroutines	1.8.0

• For payment links with only one payment method that does not require additional shopper input, the shopper no longer needs to select an additional button to pay.

• The new iDEAL payment flow where the shopper is redirected to the iDEAL payment page to select their bank and authorize the payment.

• 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.

• The new iDEAL payment flow where the shopper is redirected to the iDEAL payment page to select their bank and authorize the payment.
  You must now use InstantPaymentComponent for iDEAL:

  Copy code
  let paymentMethods = session.sessionContext.paymentMethods
  // Check that the payment method is supported before showing the Component.
  guard let paymentMethod = paymentMethods.paymentMethod(ofType: .ideal) else { return }
  let component = InstantPaymentComponent(paymentMethod: paymentMethod,
                                        context: context,
                                        order: nil)
  self.currentComponent = component
  // Set the session as the delegate.
  component.delegate = session
  component.initiatePayment() 

• When shoppers select the prefix picker in the phone number input field, they can now search through the prefix list using their ISO code, prefix, or country/region name.

iDEAL does not work in the test environment if your test Adyen merchant account is not configured to use the new payment flow. You must first contact our Support Team to configure your test merchant account.

• IdealComponent is no longer available. Use InstantPaymentComponent instead.

• The new iDEAL payment flow where the shopper is redirected to the iDEAL payment page to select their bank and authorize the payment.

iDEAL does not work in the test environment if your test Adyen merchant account is not configured to use the new payment flow. You must first contact our Support Team to configure your test merchant account.

Support for Twint SDK integration through the TwintComponent module.

• Flag icons are removed from the UI.
• The text Country is now replaced with Country/Region.

Fixed an issue that incorrectly cancelled successful redirect payments in some cases.

Dependency versions:

• 3D Secure 2 SDK version: 2.4.2.

• The privacy manifest file issue that blocked the App Store upload process has been fixed by upgrading the 3D Secure 2 SDK version to 2.4.2.

• 3D Secure 2 SDK version: 2.4.2.

• The privacy manifest file issue that blocked the App Store upload process has been fixed by upgrading the 3D Secure 2 SDK version to 2.4.2.

• 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.

• 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.

• 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.

• 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.

Upgrading to this version

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

• For Drop-in and Components, when ?android:attr/textColor is not defined in your own theme, the Card Component no longer crashes.
• The onAdditionalDetails event is now triggered only once. Previously, the event was triggered multiple times in some edge cases.
• The build output no longer contains warnings about multiple substitutions specified in non-positional format in string resources.
• For the Card Component, we fixed localization issues that occurred when using the Address Lookup functionality.
• Overriding some of the XML styles without specifying a parent style no longer causes a build error.

• You can no longer use functions like CheckoutConfiguration.getCardConfiguration() or CheckoutConfiguration.getDropInConfiguration() to get configurations from the CheckoutConfiguration object. When starting Drop-in or Components, pass the full CheckoutConfiguration object.

• Dependency versions:

  Name	Version
  Android Gradle Plugin	8.3.1

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

• For analytics and data tracking, the information collected now includes data about whether wallet payment methods are used as express payment methods.

• For the address fields of the payment form, the forward slash character (/) is now allowed.

• 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.

• PrivacyInfo.xcprivacy lists all the data collected by Drop-in and Components.

• In the country/region picker for the payment form, you can now choose if the images of flags are shown using showCountryFlags.

  For Drop-in:

  Copy code
  var style = DropInComponent.Style()
  style.formComponent.addressStyle.showCountryFlags = cardSettings.showsCountryFlags
  let dropInConfiguration = DropInComponent.Configuration(style: style)
  let dropInComponent = DropInComponent(paymentMethods: paymentMethods,
                                       context: context,
                                       configuration: dropInConfiguration)

  For Components (the Card Component, for example):

  Copy code
  let cardConfiguration = CardComponent.Configuration()
  cardConfiguration.style.addressStyle.showCountryFlags = true/false
  let cardComponent = CardComponent(paymentMethod: paymentMethod,
                                   context: context,
                                   configuration: cardConfiguration)

• 3D Secure 2 SDK version: 2.4.1.

• When clientKey is invalid or mismatched with the environment, PublicKeyProvider now returns a corresponding error message.

PrivacyInfo.xcprivacy lists all the data collected by Drop-in and Components.

3D Secure 2 SDK version: 2.4.1

• A new way to create a configuration using DSL to be more declarative and concise:

  Copy code
  CheckoutConfiguration(
      environment = environment,
      clientKey = clientKey,
      shopperLocale = shopperLocale,
      amount = amount,
  ) {
      dropIn {
          setEnableRemovingStoredPaymentMethods(true)
      }
   
      card {
          setHolderNameRequired(true)
          setShopperReference("...")
      }
   
      adyen3DS2 {
          setThreeDSRequestorAppURL("...")
      }
  }

• For the Card Component, you can use the new Address Lookup functionality.

• For voucher actions: when the url or downloadUrl is not included, the shopper has the option to select Save as image and save the voucher to the device's Downloads folder.

• You can now set your own AdyenLogger instance with AdyenLogger.setLogger. This gives the ability to intercept logs and handle them in your own way.

• Payment methods:

  • Multibanco. Payment method type: multibanco.
  • Pay Easy. Payment method type: econtext_atm.
  • Convenience Stores Japan. Payment method type: econtext_stores
  • Online Banking Japan. Payment method type: econtext_online.
  • Seven-Eleven: Payment method type: econtext_seven_eleven

• When building minifyEnabled without the kotlin-parcelize plugin in your project, the build should no longer crash.
• When handling actions, you no longer get the IllegalArgumentException: Unsupported delegate type error that causes a crash.

• When creating a configuration, the Builder constructors with a Context is deprecated. You can now omit the context parameter.

• PermissionException. Handle permissions through ActionComponentCallback, SessionComponentCallback, or ComponentCallback callbacks instead.

• The styles for vouchers have been changed:

  Previous (v5.2.0 or earlier)	Now (v5.3.0)
  AdyenCheckout.Voucher.Description.Bacs	AdyenCheckout.Voucher.Simple.Description
  AdyenCheckout.Voucher.Description.Boleto	AdyenCheckout.Voucher.Full.Description
  AdyenCheckout.Voucher.ExpirationDateLabel	AdyenCheckout.Voucher.InformationFieldLabel
  AdyenCheckout.Voucher.ExpirationDate	AdyenCheckout.Voucher.InformationFieldValue
  AdyenCheckout.Voucher.ButtonCopyCode	AdyenCheckout.Voucher.Button.CopyCode
  AdyenCheckout.Voucher.ButtonDownloadPdf	AdyenCheckout.Voucher.Button.DownloadPdf

• Logger.LogLevel has been deprecated.

  Previous (v5.2.0 or earlier)	Now (v5.3.0)
  Logger.LogLevel	AdyenLogLevel
  AdyenLogger.setLogLevel(logLevel: Int)	AdyenLogger.setLogLevel(level: AdyenLogLevel)

• When creating a configuration, the shopperLocale parameter is now optional.
  • Sessions flow: when you do not set it, the shopper locale is set to the value included in the /sessions request.
  • Advanced flow: when you do not set it, the shopper local is set to the primary user locale on the device.
• For Drop-in, all actions now start in expanded mode.
• For the Google Pay Component, you no longer need to manually import the 3ds2 module to handle transactions that require Native 3D Secure 2 challenge.
• If you use DropInServiceResult.Error without specifying an error message, the default has changed from Error sending payment. Please try again. to An unknown error occurred.
• For the Sessions flow:
  • When starting Drop-in (with DropIn.startPayment) or creating a Component (with YourComponent.PROVIDER.get), the configuration parameter is now optional.
  • When using CheckoutSessionProvider.createSession to create a CheckoutSession, you can pass only environment and clientKey instead of the whole configuration.
  • Removing stored payment methods is now handled internally. You no longer need to override the onRemoveStoredPaymentMethod function.

• Dependency versions:

  Name	Version
  Kotlin	1.9.22
  AndroidX Compose compiler	1.5.8
  AndroidX Compose Activity	1.8.2
  Material Design	1.11.0

Do not use the functions to get configurations, (such as CheckoutConfiguration.getDropInConfiguration() or CheckoutConfiguration.getCardConfiguration()). These functions will be removed in the following release.

If you use the new configuration DSL, pass the CheckoutConfiguration object as it is when starting Drop-in or Components.

• 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.

• 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.