adyen_checkout 1.14.0

Adyen checkout library for Flutter. Accept payments with cards, wallets and local payment methods in your app using our Drop-in and Components.

1.14.0

Fixed

• For the Apple Pay Component on iOS with the Advanced flow: onSubmit and onPaymentResult now always use the current AdvancedCheckout instance set on the Component. Previously, after rerendering the Component, it could still refer to an earlier AdvancedCheckout instance.

Improved

• On iOS: Improved the layout of Drop-in and Components for iPhone Duo.

Changed

• Dependency versions:

  Name	Version
  iOS Drop-in/Components	5.25.1 -> 5.26.0

1.13.0

Improved

• On iOS: For improved accessibility, Drop-in now appears in a dedicated window on top of your app content instead of using FlutterViewController. The behavior of appearing on top of your app remains unchanged. For shoppers that use Full Keyboard Access, the focus now stays inside the native payment interface.

• (Internal change) For Drop-in on iOS: The internal delegates are now simpler to maintain:

  • Stored payment method deletion uses a single delegate instead of duplicated delegates.
  • The delegate implementations are in separate files.

Changed

• On Android: The default AdyenCheckout theme now inherits directly from the Adyen theme, instead of from the generic AppTheme style. Android merges resources from every dependency, so an AppTheme style from an unrelated dependency could replace the Adyen theme and stop the payment form from rendering. If you customize Drop-in through AppTheme, you must move those attributes to an AdyenCheckout style in your app resources.

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

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

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

1.9.0

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

1.8.1

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

1.8.0

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

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

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

1.5.1

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.

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

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.

1.4.0

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.

1.3.0

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.

1.2.0

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.

1.1.0

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

1.0.2

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

1.0.1

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

1.0.0

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

0.1.0

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

0.0.3

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

0.0.2

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

0.0.1

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