adyen_checkout

Improved

• For Card Component on Android: the configured countryCode is now applied as the default country for full-address forms.
• For Apple Pay and Google Pay Components: reduced unnecessary re-rendering on widget rebuilds by caching the availability result.

Changed

• iOS: The minimum version has increased 12.0 to 13.0. This aligns with Flutter's own minimum iOS requirement.
• Android: The minimum API level (minSdkVersion) has increased from 21 to 23. This aligns with the latest pay package requirements.
• Dependency versions:

  Name	Version
  pay	3.2.1 -> 3.3.0
  Android Drop-in/Components	5.19.0 -> 5.20.0

Improved

• For Card Component on Android: the configured countryCode is now applied as the default country for full-address forms.
• For Apple Pay and Google Pay Components: reduced unnecessary re-rendering on widget rebuilds by caching the availability result.

Changed

• iOS: The minimum version has increased 12.0 to 13.0. This aligns with Flutter's own minimum iOS requirement.
• Android: The minimum API level ( minSdkVersion) has increased from 21 to 23. This aligns with the latest pay package requirements.
• Dependency versions:

  Name	Version
  pay	3.2.1 -> 3.3.0
  Android Drop-in/Components	5.19.0 -> 5.20.0

New

• Apple Pay Component on iOS now supports coupon code configuration, dynamic
  sheet updates for shipping contact, shipping method and coupon code changes as well as
  authorization validation.

Changed

• For Google Pay: moved from the deprecated onActivityResult flow to the internal flow, so the
  plugin no longer needs the onActivityResult listener on the host activity.
• iOS example app: Now using a UISceneDelegate for returnUrl handling.
• Dependency versions:

  Name	Version
  Android Drop-in/Components	5.18.0 -> 5.19.0
  iOS Drop-in/Components	5.25.0 -> 5.25.1

New

• Apple Pay Component on iOS now supports coupon code configuration, dynamic sheet updates for shipping contact, shipping method and coupon code changes as well as authorization validation.

Changed

• For Google Pay: moved from the deprecated onActivityResult flow to the internal flow, so the plugin no longer needs the onActivityResult listener on the host activity.
• iOS example app: Now using a UISceneDelegate for returnUrl handling.
• Dependency versions:

  Name	Version
  Android Drop-in/Components	5.18.0 -> 5.19.0
  iOS Drop-in/Components	5.25.0 -> 5.25.1

New

• For Drop-in: you can now hide previously stored payment methods from the payment method list. Set
  showStoredPaymentMethods to false in StoredPaymentMethodConfiguration. The default is
  true. Thank you @pablo-snz.
• For standalone action handling: ActionComponentConfiguration now supports
  ThreeDS2Configuration, so you can set the requestorAppURL and customize the 3D Secure 2 UI.

Changed

• Dependency versions:

  Name	Version
  Android Drop-in/Components	5.17.0 -> 5.18.0
  iOS Drop-in/Components	5.23.1 -> 5.24.0

New

• For Drop-in: you can now hide previously stored payment methods from the payment method list. Set showStoredPaymentMethods to false in StoredPaymentMethodConfiguration. The default is true.
• For standalone action handling: ActionComponentConfiguration now supports ThreeDS2Configuration, so you can set the requestorAppURL and customize the 3D Secure 2 UI.

Changed

• Dependency versions:

  Name	Version
  Android Drop-in/Components	5.17.0 -> 5.18.0
  iOS Drop-in/Components	5.23.1 -> 5.24.0

New

• For the 3D Secure 2: you can now customize the user interface using Adyen3DSTheme. This include support for fromThemeData(), which enables you use the styling from your application's existing theme.
• Supported payment method: BLIK. Payment method type: blik. The shopper pays using a 6-digit code generated in their banking app.
• For card payments: you can now offer shoppers the option to pay in installments.
  • Sessions flow: use the installmentOptions parameter.
  • Advanced flow: use the new installmentConfiguration property.

Improved

• The internal component architecture now uses a shared layer. This improves maintainability and makes it easier to extend components that are based on platform views.
• For the Card Component: the implementation is now simplified and complies with the updated component architecture. Thanks @RahmiTufanoglu for the suggestions.

Changed

• Dependency versions:

  Name	Version
  Android Drop-in/Components	5.16.0 -> 5.17.0
  iOS Drop-in/Components	5.22.2 -> 5.23.1

New

• For the 3D Secure 2: you can now customize the user interface using Adyen3DSTheme. This includes support for fromThemeData(), which enables you use the styling from your application's existing theme.
• Supported payment method: BLIK. Payment method type: blik. The shopper pays using a 6-digit code generated in their banking app.
• For card payments: you can now offer shoppers the option to pay in installments.
  • Sessions flow: use the installmentOptions parameter.
  • Advanced flow: use the new installmentConfiguration property.

Improved

• The internal component architecture now uses a shared layer. This improves maintainability and makes it easier to extend components that are based on platform views.
• For the Card Component: the implementation is now simplified and complies with the updated component architecture.

Changed

• Dependency versions:

  Name	Version
  Android Drop-in/Components	5.16.0 -> 5.17.0
  iOS Drop-in/Components	5.22.2 -> 5.23.1

Released: July 6, 2023

Release on GitHub

A feature release with Kotlin K2 compiler updates, new enum class values function, new operator for open-ended ranges, preview of Gradle configuration cache in Kotlin Multiplatform, changes to Android target support in Kotlin Multiplatform, preview of custom memory allocator in Kotlin/Native.

Learn more in:

What's new in Kotlin 1.9.0

What's new in Kotlin YouTube video

Fixed

• HUF Currency Formatting: Fixed an issue where Hungarian Forint (HUF) amounts were incorrectly
  formatted on iOS 26.4 Beta. The iOS beta changed the minor digits for HUF from 2 to 0 in this
  beta, which conflicted with the Adyen backend expectation of 2 decimal places. The SDK now
  explicitly overrides HUF to use 2 minor units, ensuring consistent amount formatting across all
  iOS versions.

Changed

• Dependency versions:

  Name	Version
  iOS Drop-in/Components	5.22.2

Fixed

• HUF Currency Formatting: Fixed an issue where Hungarian Forint (HUF) amounts were incorrectly formatted on iOS 26.4 Beta. The iOS beta changed the minor digits for HUF from 2 to 0 in this beta, which conflicted with the Adyen backend expectation of 2 decimal places. The SDK now explicitly overrides HUF to use 2 minor units, ensuring consistent amount formatting across all iOS versions.

Changed

• Dependency versions:

  Name	Version
  iOS Drop-in/Components	5.22.2

New

• TWINT is now supported in Drop-in and as a redirect instant component. Payment method type: twint.
• For card payments with Drop-in and Component, you can now configure a requestorAppURL in your ThreeDS2Configuration .
• The data object in the onSubmit callback now includes an sdkData parameter. For Advanced flow,
  we recommend that you include this parameter in your /payments request.`

Improved

• For Drop-in on iOS, the payment amount you specified in your /sessions request is used to show the amount at checkout.
• Updated Gradle and AGP to v8.13.

Changed

• Dependency versions:

  Name	Version
  iOS Drop-in/Components	5.22.1
  Android Drop-in/Components	5.16.0
  Android Gradle Plugin	8.13.2

New

• TWINT is now supported in Drop-in and as a redirect instant component. Payment method type: twint.
• For card payments with Drop-in and Component, you can now configure a requestorAppURL in your ThreeDS2Configuration.
• The data object in the onSubmit callback now includes an sdkData parameter. For Advanced flow, we recommend that you include this parameter in your /payments request.`

Released: December 28, 2022

Release on GitHub

A feature release with improved kotlin-reflect performance, new recursively copy or delete directory content experimental functions for JVM, improved Objective-C/Swift interoperability.

Learn more in:

What's new in Kotlin 1.8.0

Compatibility guide for Kotlin 1.8.0

New

• Pay by Bank is now supported as an Instant Component. Payment method type: paybybank.
• Support for Swift Package Manager (SPM).
  When migrating an existing project to Swift Package Manager (SPM), you must manually import
  modules in your AppDelegate.swift:
  • import AdyenActions
  • If you apply custom styling to Drop-in, you must also include import AdyenDropIn.

Improved

• For Apple Pay Component: the instantiation of the widget is now more efficient. Thanks @RahmiTufanoglu.
• For the Instant Component: streamlined the implementation for Android by removing redundant code.
• For Components in general: the communication of platformView height now includes a type specification.

Changed

• Dependency versions:

  Name	Version
  iOS Drop-in/Components	5.21.0

New

• Pay by Bank is now supported as an Instant Component. Payment method type: paybybank.
• Support for Swift Package Manager (SPM).
  When migrating an existing project to Swift Package Manager (SPM), you must manually import modules in your AppDelegate.swift:
  • import AdyenActions
  • If you apply custom styling to Drop-in, you must also include import AdyenDropIn.

Improved

• For Apple Pay Component: the instantiation of the widget is now more efficient.
• For the Instant Component: streamlined the implementation for Android by removing redundant code.
• For Components in general: the communication of platformView height now includes a type specification.

Changed

• Dependency versions:

  Name	Version
  iOS Drop-in/Components	5.21.0

Released: June 9, 2022

Release on GitHub

A feature release with Kotlin K2 compiler in Alpha for JVM, stabilized language features, performance improvements, and evolutionary changes such as stabilizing experimental APIs.

Learn more in:

What's new in Kotlin 1.7.0

What's new in Kotlin YouTube video

Compatibility guide for Kotlin 1.7.0

Improved

• Improved initialization of Google Pay Component.
• For the Apple Pay Component:
  • Now uses PassKit for its availability check instead of a temporary native Adyen Apple Pay
    Component.
  • Billing contact fields are now correctly mapped.
• On iOS with the Advanced flow: when an error occurs during a card payment, the loading spinner now
  stops automatically.

Changed

• Dependency versions:

  Name	Version
  Android Drop-in/Components	5.14.0
  iOS Drop-in/Components	5.20.0

Improved

• Improved initialization of Google Pay Component.
• For the Apple Pay Component:
  • Now uses PassKit for its availability check instead of a temporary native Adyen Apple Pay Component.
  • Billing contact fields are now correctly mapped.
• On iOS with the Advanced flow: when an error occurs during a card payment, the loading spinner now stops automatically.

Changed

• Dependency versions:

  Name	Version
  Android Drop-in/Components	5.14.0
  iOS Drop-in/Components	5.20.0

Released: November 16, 2021

Release on GitHub

A feature release with new language features, performance improvements, and evolutionary changes such as stabilizing experimental APIs.

Learn more in:

Release blog post

What's new in Kotlin 1.6.0

Compatibility guide

New

• Android Components/Drop-in version: 5.13.0.

Fixed

• For card payments on Android, the expiry date field now works correctly when the shopper leaves
  the app, and resumes it from the background. This fixes the known issue in v1.5.0.

New

• Android Components/Drop-in version: 5.13.0.

Fixed

• For card payments on Android, the expiry date field now works correctly when the shopper leaves the app, and resumes it from the background. This fixes the known issue in v1.5.0.

New

• Android Components/Drop-in
  version: 5.12.0.
• iOS Components/Drop-in
  version: 5.19.1

Improved

• Improved how the Apple pay bottom sheet closes when dismissing Drop-in.
• When the shopper enters the details for a co-badged card, the available brand options are now
  shown in a separate section in the payment form.

New

• Android Components/Drop-in version: 5.12.0.
• iOS Components/Drop-in version: 5.19.1

Improved

• Improved how the Apple pay bottom sheet closes when dismissing Drop-in.
• When the shopper enters the details for a co-badged card, the available brand options are now shown in a separate section in the payment form.

Warning

For Android: We've identified an issue where the expiry date input field for card payment in Drop-in and Component functions incorrectly when the app is resumed from the background. This has been fixed in v1.5.1.

Released: May 5, 2021

Release on GitHub

A feature release with new language features, performance improvements, and evolutionary changes such as stabilizing experimental APIs.

Learn more in:

Release blog post

What's new in Kotlin 1.5.0

Compatibility guide

New

• For Sessions and Advanced flows, added methods to dismiss Drop-in.
• For the card component and cards within Drop-in, added support for BIN lookup callbacks that will be called when the shopper enters their card details.
• Added a custom card Flutter widget to the example app using CSE and card validators.
• Android Components/Drop-in version: 5.10.0.
• iOS Components/Drop-in version: 5.17.0

Changed

• Minimum SDK version: Flutter 3.16.0 /Dart 3.2

Improved

• For native 3D Secure 2, when a shopper cancels the payment during the payment flow, the onAdditionalDetails callback is now triggered. The payment flow no longer ends with CANCELLED_BY_USER. The onAdditionalDetails returns the details of the cancelled transaction.

Released: August 17, 2020

Release on GitHub

A feature release with many features and improvements that mostly focus on quality and performance.

Learn more in:

Release blog post

What's new in Kotlin 1.4.0

Compatibility guide

New

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

Improved

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

New

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

Improved

• For card component, improved the dynamic viewport.

Removed

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

• Added support for renaming payment methods in Drop-in.
• 3DS2 cancellations are now resolved as a PaymentCancelledByUser payment result.
• Improved configuration parsing for Google Pay component.
• Improved instantiation of Apple Pay component.

• Improved card component for large font and display sizes.
• Improved component bottom sheet behavior on Android.
• Migrated Android example to use Flutter Gradle plugins through the Plugin DSL.
• Updated iOS SDK to v5.11.0.

• Fixed resolving of view references for Android when using Flutter with Gradle's Plugin DSL.
• Excluded default androidx.lifecycle dependencies of the Android SDK to enable AGP 7 compatibility.
• Updated project readme.

• ⚠ Breaking Change: Cash app pay configuration now uses named parameters.
• ⚠ Breaking Change: Styling for iOS is now simplified by exposing AdyenAppearance for setting the style directly.
• Added standalone action handling for the API only integration flow.
• Improved rendering of components.
• The amount inside the different payment method configurations is now optional. Only for Apple Pay in combination with the advanced flow, the amount is still required.
• Added support for the iDEAL redirect flow.
• Updated iOS SDK to v5.9.0.
• Updated Android SDK to v5.6.0 and moved to Gradle v8.

• ⚠ Breaking Change: Changed ResultCode into an enum. Please adjust your usage of the PaymentResult (PaymentSessionFinished or PaymentAdvancedFinished).
• ⚠ Breaking Change: Changed the payment methods type from String to Map<String, dynamic> to support JSON data directly.
• ⚠ Breaking Change: Updated AdvancedCheckout class and removed deprecated implementation.
• Updated iOS SDK to v5.8.0.
• Updated Android SDK to v5.4.0.
• Added support for customizing Drop-in and Card Component.
• Added option to adjust Drop-in preselected payment method title.
• Added support for Instant Component.
• Added support for Client-Side Encryption (CSE).

• ⚠ Introduced the AdvancedCheckoutPreview as a replacement for the AdvancedCheckout. Please consider using it as we plan to replace the deprecated AdvancedCheckout in the first beta release.
• Added Google Pay Component.
• Added Apple Pay Component.
• Added support for optional configuration for Apple Pay and Google Pay (Drop-in and Components).
• Updated minimum supported SDK version to Flutter 3.10.6/Dart 3.0.6.

• Improved error handling by dismissing Drop-in in case an Apple Pay transaction fails.
• Updated iOS SDK to v5.6.0.
• Updated Android SDK to v5.2.0.
• Updated API integration of example app to v71.

• Initial alpha release containing following features:
  • Drop-in with session flow and advanced flow.
  • Card-component with session flow and advanced flow.