Android SDK

• Google Pay: added allowCreditCards and allowPrepaidCards options to PrimerGooglePayOptions, letting you restrict the card types offered through Google Pay. Both default to true, so existing integrations are unaffected.

• Removed a redundant title from the web view

• General fixes and improvements

• General fixes and improvements

• Improved payment method processing
• Improved error handling in some areas

• Fixes some issues with text color and dark mode theming

• Improved payment method processing

• Add cvvLabel to CardNetwork Descriptor

• Exposing more information through onBinDataAvailable
• Added idempotency key as optional param to continuePaymentCreation in PrimerPaymentCreationDecisionHandler

• Improved payment status polling stability through retry handling

• improved 3DS locale normalization
• improved custom Locale handling in Drop-in

• EFTPOS co-badged cards now leaves card selection up the vendor without user interaction

• fix a corner case when switching between different co-badged cards
• fix navigation bar blur when edge-to-edge enabled

• Fixed an issue where the payment redirect URL wasn’t loaded correctly when starting from a custom URL scheme.

• Raised the minimum supported SDK version to 23
• Updated play-services-wallet dependency to 19.5.0

• Fixed crash that occurred when user returned to 3DS screen using a deeplink.

• Reduced redundant data fetching to speed up loading and improve overall performance.

• Add EFTPOS network support

1. Ensure your backend integration supports API version 2.4
2. Review the Migration Guide for detailed upgrade instructions

• Enhanced internal storage of analytics events.

• Fixed crash that occurred when switching payment methods after the PrimerSessionIntent parameter was changed
• Fixed crash that could occur when calling cleanup() if the Drop-in dismissal event was not properly handled internally

• Improved internal analytics event processing to consolidate redundant events and enhance payload data with richer contextual metadata. This internal improvement reduces network overhead while providing better system insights.

• Improvements to Klarna theme selection.

• Continuing 3DS flow sometimes failed silently, resulting in failed-to-resume or payment-failed errors. We have fixed that and improved our logging in this specific use case.

• Primer SDK now depends on Kotlin 2.0.21

• Better edge-to-edge support in Drop-In integration.
• Improvements to DI resolutions.

• We have bumped compile and target versions to 35
• Analytics: We have reduced number of analytics events captured and sent to our server.

• We have added CardFormUIOptions.payButtonAddNewCard to support the “Add New Card” option in the card form flow. Please check our docs for more information
• Introduced support for the ‘Continue payment flow’ workflow action to configure checkout outcome. See our documentation for more info.

• Fixed a crash caused by misuse of CheckoutExitHandler.

• In certain scenarios, the SDK may crash if a deep link to a specific screen is triggered after a payment flow was already finalized.

• PayPal: Improved support for picture-in-picture mode. Fixed an issue where some successful authentication flows were incorrectly marked as errors by the SDK.
• 3DS: Enhanced locale normalization. Resolved an issue where certain locales were being rejected by the 3DS SDK, causing the flow to fail.
• Cleanup Enhancements: Added a new cleanClientSessionCache parameter to the cleanup function. You can now control whether to clear the Client Session cache in both Drop-In and Headless integrations.

• Klarna: Updated Klarna SDK to 1.1.0
• Klarna: Improved styling support for Klarna components

• The SDK will now default to using API version 2.4 when initialised. It is possible to use API version 2.3 via PrimerSettings.apiVersion. For more information see our SDK reference, Api Reference and Migration Guides.

• In certain scenarios, the SDK may crash if a deep link to a specific screen is triggered while the app has been forcefully killed by the user.

• We have fixed a bug in the Drop-In Checkout which resulted in “Additional fees may apply” text being shown for the Card payment method, when no surcharge was present.

• 3DS Locale Propagation: Resolved an issue where the 3DS SDK occasionally rejected propagated locale settings.
• iDEAL via Adyen: iDEAL is now fully supported as a redirect-based payment method.

• 3DS Flow Stability: Fixed crashes that occurred when the 3DS flow failed while the app was running in the background.

• We’ve increased the timeout for payment creation and handling for better stability.

• We’ve fixed issues with displaying the partial billing address form in Drop-in. Now, the data is collected and updated correctly. Previously, the SDK returned an error when updating the client session.

• Drop-in: fixed an issue causing crashes when calling Primer.dismiss() after the checkout sheet is already dismissed.

• With this version it is possible to opt-in to use API v2.4, which is no longer in Beta. For more information see our SDK reference, Api Reference and Migration Guides. The SDK will continue to use API v2.3 by default.
• Expanded Language Support: The Android SDK now supports additional languages, including:
  • Arabic
  • Bulgarian
  • Czech
  • Spanish (Argentina & Mexico)
  • Estonian
  • Croatian
  • Hungarian
  • Japanese
  • Latvian
  • Portuguese (Brazil)
  • Romanian
  • Vietnamese
• 3DS Sandbox Testing: Enhanced support for testing 3D Secure (3DS) flows in the sandbox environment.
• Improved Analytics & Reporting: Enhanced tracking and insights for better performance monitoring.

• With this version it is possible to opt-in to test API v2.4(Beta). For more information see our API Reference and Migration Guides. By default, SDK will remain backward compatible and use API v2.3.

• API Timeout values have been updated to improve behaviour in the loading phases of the checkout.

• Analytics: fixed serialization and deserialization of analytics events.

• Co-badged cards in Drop-in: Primer SDK will automatically detect co-badged cards in the Drop-In integration. This release also brings improvements to card network detection in general. Visit our documentation about co-badged cards in order to learn more.

• Enhanced Card Expiry Date Validation: We’ve improved the accuracy of expiry date validation for both headless and drop-in integrations.
• Improved Stability: Resolved crashes caused by ConcurrentModificationException during SDK initialization.

• Stability improvements.

• Native Payment Method Button Support: Some payment methods require and offer their native views. To support this, we’ve updated our Asset Manager and introduced the getPaymentMethodResource method to access these native resources seamlessly. If you are using Headless integration, make sure to check our updated documentation about rendering of payment method buttons.
  Usage of Native Payment Method Button is a requirement for all new Android Google Pay API integrations that use a Google Pay payment button.
• ACH Vaulting via Stripe: The ACH payment method through Stripe now supports a vaulting flow, enabling you to save customer details on agreement for future transactions.
• Google Pay Enhancements: You can now collect additional user data through Google Pay, including the user’s email and shipping address. Check out our guide for details on enabling this feature.

• PayPal Integration: We’ve improved the PayPal user experience by adopting the recommended approach of using Chrome Tabs, eliminating the need for browser redirections and reducing friction during payment.
• SDK Resilience: We’ve enhanced SDK resilience to better handle scenarios where Activities are destroyed due to process death, ensuring a smoother recovery experience.

• 3DS Locale Handling: We’ve fixed an issue where locale extensions were stripped, causing failed 3DS transactions. This update ensures compliance with 3DS guidelines and smoother transaction processing.

• In order to support Native Payment Method Button requirements, we have deprecated following methods:
  • PrimerHeadlessUniversalCheckoutAssetsManager.getPaymentMethodAsset
  • PrimerHeadlessUniversalCheckoutAssetsManager.getPaymentMethodAssets

• We’ve fixed the issue that caused crashes when retrying a 3DS challenge while another challenge was still in progress.

• We’ve resolved the issue causing crashes when users were deeplinked multiple times from PayPal.

• Disable back buttons when payment is processing

• We’ve fixed the crashes that occurred when using Blik through Adyen’s Drop-In in standalone mode.
• We’ve resolved occasional crashes related to the “fragment not attached” issue in Drop-In.

• Prevent dismissal of Drop-in card form while a payment is active.
• Vipps via Adyen will now fall back to the Web flow in the event that the Vipps mobile app was not installed.
• Added DividerThemeData that can be used for styling of dividers in Drop-In. Check out our documentation here.
• You can now use custom colour for input cursors by specifying cursorColor in InputThemeData

• Stripe ACH mandate template can now be configured either with a resource key or passing the full mandate text directly.
• Better Spanish language support for Stripe ACH.

• We have added support for ACH via Stripe. ACH lets you accept payments from customers with a US bank account.
• ACH Direct Debit is a reusable, delayed notification payment method. It can take up to 4 business days to receive acknowledgement of success or failure.
• This release includes: One-off payments, cancel, and refund actions. We aim to add support for recurring payments in the future.
• You can easily integrate ACH via Stripe into your payment stack with just a few clicks through Primer. Visit the integrations section of the dashboard to learn more or consult the direct integration guide.

• Finnish
• Korean
• Lithuanian
• Catalan
• Serbian
• Ukrainian
• Hebrew
• Indonesian

• Client Session caching: It is now possible to cache the ClientSession configuration client-side, which can speed up certain flows in the SDK. This can be enabled via the clientSessionCachingEnabled flag. Before enabling the flag to true it’s recommended to reach out to Primer support for additional verification since there are edge cases where it is not advised.
• Improved initialization: We have strengthened the Android SDK’s initialization process, ensuring it remains reliable even if users experience connectivity drops. These changes guarantee a smoother experience.
• We have removed Card Components and related UI from the SDK. Card components were previously deprecated.
• Improved payment method handling when payments are completed outside of the scope of the SDK session.

• We have improved the PayPal payment method token by providing additional data, including the payer’s first name and last name. For more information, see our SDK reference docs.

• Improved internal dependency resolution for NolPay components when PrimerHeadlessUniversalCheckout is reinitialized.

• Google Pay: By default, Google Pay is presented to the user regardless of whether they have a supported card in their wallet. You can now automatically hide Google Pay if the user’s wallet does not contain a supported card by setting existingPaymentMethodRequired to true. Check our guide on how to enable this feature.
• PayPal: We have improved the PayPal payment method token by providing additional data, including the payer’s first name, last name, and external payer ID.

• We’ve enhanced our internal analytics infrastructure for tracking network events, empowering us to efficiently gather valuable data on latency and API errors.

• Previously, when the app utilizing our SDK was built in release mode with minification applied, initialization of the SDK would fail. We’ve since addressed this issue by updating our consumer-rules.pro files. You should not manually include any Proguard rules, as consumer-rules.pro are seamlessly integrated with your existing Proguard rules.
• With the release of version 2.26.0, we’ve improved our Klarna integration. As a result, we identified an issue where error handling was not functioning correctly when utilizing standalone mode for Drop-In integration (Primer.instance.showPaymentMethod(..)). This concern has been promptly addressed and resolved.
• We’ve enhanced the handling of payment completion for our Nol pay integration, addressing a regression that had occurred.

• We have added the ability to select Klarna payment category in Klarna Drop-in
• Support has been added for CHECKOUT payment intents for Klarna Drop-in
• We have included support for Klarna Extra Merchant Data
• In this release we have added the PrimerHeadlessUniversalCheckoutKlarnaManager that provides access to the KlarnaComponent. Using the KlarnaComponent you can seamlessly integrate Klarna, with a custom payment category selection UI. Consult the guide to get a sense of how to seamlessly integrate Klarna.

• We have released support for co-badged cards. You can allow users to select a network if their card is co-badged.
• We have also improved card network validation significantly for all card networks.
• In our most recent 3DS SDK update, we’ve addressed a bug affecting 3DS support. Previously, there was an issue where the Issuer or Payment System image wouldn’t consistently display on the Challenge UI. Please note, with this update, compatibility requires the use of the 1.4.1 version of the 3DS SDK (io.primer:3ds-android:1.4.1).

• We have fixed a bug where the SDK would crash in case of recovering from a process death.

• In this latest release, our 3DS support has undergone some slight enhancements. Please note, with this update, compatibility requires the use of the 1.4.0 version of the 3DS SDK (io.primer:3ds-android:1.4.0). We recommend upgrading to this version as it brings new LOA Reference Number for all protocol versions.
• Internally, between the different platforms, we have aligned how the currencies are formatted. Currency metadata is now being served from our server, allowing us to adapt to potential changes without the SDK update being needed.

• Previously, Google Pay was hidden in case the amount was set to 0. From now on, Google Pay will be always shown in case it was enabled in Primer Dashboard and the device supports payments with Google Pay.

• load list of all supported banks
• submit user’s selection

• In this latest release, our 3DS support has undergone significant enhancements, offering a multitude of improvements. Please note, with this update, compatibility requires the use of the 1.3.0 version of the 3DS SDK (io.primer:3ds-android:1.3.0)

• We have enhanced our internal analytics capabilities, enabling us to collect a broader range of data, and we have streamlined the process for sending events, ensuring greater efficiency and effectiveness.
• Keyboard cache is now disabled for sensitive inputs. We highly encourage you to update your SDK to reduce the risk that sensitive user data are leaked to other applications.

• We have improved empty phone number validation for nol Pay

• Phone number validation is significantly improved.
• We no longer require separate fields for phoneCountryDiallingCode to be passed. Now you can pass full phone number and SDK will parse and validate phone number.
• We have also fixed the crash that was reported when there were no workflows configured for payment methods.

• Listing Nol cars: Listing previously linked Nol payment cards using NolPayLinkedCardsComponent.
• NFC Scanning: Allows your application to scan NFC Nol payment cards using NolPayNfcComponent.
• Linking: Link the Nol card to a phone number using NolPayLinkCardComponent.
• Unlinking: Unlink previously linked Nol card using NolPayUnlinkCardComponent.
• Transactions: Execute payments using selected Nol payment cards NolPayPaymentComponent.

• In previous versions we have used Koin for Dependency Injection inside of our SDK. Starting from this release, Koin was removed as transitive dependency.

• 3DS will be conditionally triggered in case Google Pay method returns PAN_ONLY token in Headless integration

• Removed requirements for amount in client session when vaulting PayPal

• fetch a list of vaulted payment methods
• delete a vaulted payment method
• validate the additional data used to perform a payment (e.g. validate CVV)
• perform a payment using a vaulted payment method

• Support 3DS weak validation
• Support 3DS OOB flow
• Improve 3DS reporting

• Cards via iPay88 Payment Method now is fully supported via Headless Universal Checkout and Drop-In.
• You can now make one-off payments or vault a card with iPay88 in order to make recurring payments.
• Please update the iPay88 SDK version to 1.0.1

• Improvements to deeplink handling for PayPal and Redirect based payment methods
• Reintroduce showing a payment method directly with the Drop In UI integration
• Koin dependency has been bumped to version 3.3.3
• Better interoperability with Java when using Primer SDK
• Internal SDK improvements
• PrimerPaymentMethodAsset now exposes the payment method’s friendly name

• Fixed bug where calling submit method of PrimerHeadlessUniversalCheckoutCardComponentsManager would return error due to wrong formatting of expiry date.
• Apply fix on PayPal vaulting
• Resolved bug where Drop In UI could be launched multiple times at same time
• Resolved internal analytics crashes.

• PrimerCardComponentsManagerListener has been renamed to PrimerHeadlessUniversalCheckoutCardComponentsManagerListener.
• The package name for the PrimerHeadlessUniversalCheckoutNativeUiManager has been changed to io.primer.android.components.manager.nativeUi.

• Improvements to deeplink handling for PayPal and Redirect based payment methods

• fetch a list of vaulted payment methods
• delete a vaulted payment method
• validate the additional data used to perform a payment (e.g. validate CVV)
• perform a payment using a vaulted payment method

• Fixed bug where calling submit method of PrimerHeadlessUniversalCheckoutCardComponentsManager would return error due to wrong formatting of expiry date.

• Reintroduce showing a payment method directly with the Drop In UI integration

• Apply fix on PayPal vaulting
• Resolved bug where Drop In UI could be launched multiple times at same time

• Our 3DS service has been completely revamped. Primer SDK now supports 3DS protocol version 2.2.0
• Support 3DS weak validation
• Support 3DS OOB flow
• Improve 3DS reporting

• Resolved internal analytics crashes.

• Koin dependency has been bumped to version 3.3.3

• Better interoperability with Java when using Primer SDK
• Internal SDK improvements

• PrimerPaymentMethodAsset now exposes the payment method’s friendly name

• Improved handling of payment cancellations for Atome

• Fixed bug that caused some of the expiry dates not being validated correctly

• Improved internal analytics for 3DS events
• Improved internal analytics for headless integration

• Thai translations have been improved and updated.

• Malay
• Thai
• Mandarin Chinese

• Google Pay payments now support native 3DS.

• Drop-In can now be intialized with 0 amount.
• Particular flows that use showPaymentMethod have been improved.

• In this version of the SDK we have introduced a new version of Klarna library. Primer SDK will depend on io.primer:klarna-android:1.0.1 from now on.
  ⚠️ If you are using Klarna dependency in your code, you are required to update it in order to align with the supported version. Otherwise, Klarna will result in failure.

• In this version of the SDK we have introduced a new version of 3DS library. Primer SDK will depend on io.primer:3ds-android:1.1.2 from now on.
  ⚠️ If you are using 3DS dependency in your code, you are required to update it in order to align with the supported version. Otherwise, 3DS will result in failure.
• We have added a way to capture billing address using Google Pay. You will need to pass captureBillingAddress = true to PrimerGooglePayOptions

• This version fixed an issue when a developer wanted to disable the showing of some screens. Previously that was broken due to Android OS automatically showing the bottom sheet dialog when we get back on the main screen, even if we hide it before.

• We have fixed certain redirection issues for payment methods using Buckaroo as PSP

• Aligned the RN_ANDROID on Analytics sdkType

• Fix initialization for Universal Checkout.

• Added support for Multibanco via Adyen.

• Added support for Multibanco via Adyen.
• Added support for MbWay via Adyen.

• PayPal via Primer
• Sofort via Primer
• Klarna via Primer

• Added support for Coinbase
• Added support for OpenNode
• Added support for 2c2p

• We have added support for 3DS processor

• Added support for the RN bridge

• Added support for Blik

• Dark mode support
• Fixes in analytics
• Various performance fixes

• Added support for P24 via Mollie
• Added support for Giropay via Mollie
• Added support for EPS via Mollie
• Added support for P24 via PayNL
• Added support for EPS via PayNL

• Implements the Headless Universal Checkout - Beta for cards and APMs (except for Blik, Adyen Dot Pay and Adyen iDeal)

• Implements the Headless Universal Checkout - Beta for cards and APMs (except for Blik, Adyen Dot Pay and Adyen iDeal

• Improvements to amount calculation

• Improvements to payment method redirections

• Danish
• German
• Greek
• Spanish
• French
• Italian
• Norwegian
• Dutch
• Polish
• Portuguese
• Swedish
• Turkish

• Improvements to payment method redirections

• Added support for Xfers payment method.

• Improvements to PayPal tokenization flow
• Improvements to payment method redirections
• Added autofocus feature in card form
• isVaulted flag added to PaymentMethodToken
• Performance improvements

• Improvements to tokenization flow
• Improvements to surcharge UI
• Support for capturing postal code in card form and observing using client session actions
• Support for hiding cardholder name in card form

• Added support for Atome payment method in beta

• Added support for easier integration with Java
• Better support for Android S
• Minor UI improvements
• Surcharge feature now stable

• Adds beta version of surcharging

• New payment methods: iDEAL, Giropay, Sofort, EPS and Bancontact via Buckaroo

• Added further support for SDK customisation when generating client session. Settings Migration Guide
• New payment methods: Bancontact & iDEAL via Mollie and Giropay & Payconiq via PayNL
• Added loading payment methods screens

• Added Primer.cleanup method. *This method should be called when disposing the listener in order to free Primer SDK resource.*
• Added Adyen payment methods (Vipps, Mobilepay, iDEAL, Dotpay)
• Additional improvements for PayPal error handling

• Updated to 3DS 1.1.0 version
• Stability improvements

• Improved 3DS handling (VAULT/CHECKOUT)
• Deprecated PrimerSettings.order and PrimerSettings.customer in favour of configuration set through client session creation
• Added Adyen AMPs (Giropay, Twint, Trustly, Sofort, Alipay)

• fetchSavedPaymentInstruments method has been deprecated
• Improved card form layout and default theming.
• Enabled 3DS testing in all environments.

• Complete redesign of PrimerTheme. PrimerTheme.create() is now deprecated. Use PrimerTheme.build() or resource files to create custom themes.
• Primer singleton object has been redesigned with a new initialisation flow. Please refer to the quick start guide for further info. Primer.initialize() is now deprecated.

• Improved Apaya redirect url schema logic.

• Added support to pre-fill Apaya phone number. Please see documentation for integration steps.

• Added support for Apaya payment method. Please see documentation for integration steps.

• Added beta support for 3DS dependency.
• Stability improvements & networking fixes.

​

(ignore)

• Fixes issue with card number validation for American Express.

• Issue when pressing Android back button after displaying payment flow with doNotShowUi = true addressed.
• Improvements to Klarna payment flow error handling & stability.
• Optional completionHandler added to TokenizationSuccess event. Call this to complete flow with error/success screen after completing payment action.

​

(ignore)

• The Klarna flow has been updated so that all user cancellations are captured by the event listener. Refer to CheckoutEvent.Exit & its CheckoutExitReason parameter to listen to the following events: DISMISSED_BY_USER or ERROR (error thrown by Klarna).
• You can now pass a flag to clear all listeners when dismissing the Primer view with UniversalCheckout.dismiss(clearListeners = true). This is the recommended way to complete the session before navigating to a different activity/fragment.

• Bug fixes for PayPal flows.
• Option to pass in flag clearAllListeners when calling showVault() / showCheckout(). Set this flag as true, if you need to call UniversalCheckout.initialise() more than once.
• Fixes bug where main universal checkout would display checkout options incorrectly.

• Running the SDK in release mode with app shrinking minifyEnabled = true caused the app to crash. This has been addressed so that the SDK will run with all forms of app shrinking.
• The Klarna web view flow for Sweden is now configured to automatically redirect to the Mobile BankID app when using direct debit.
• When creating in the Klarna object it is now possible to set a webViewTitle for the Klarna web view’s toolbar.
• Improvements to error handling & SDK stability.

​

(ignore)

• Improvements to app links and schemes with new webBrowserRedirectScheme param to pass in custom app link scheme when calling the SDK with showVault()/showCheckout().
• New option of preferWebview for showing Klarna checkout flow in an integrated web view instead of a separate browser window.
• new option to call UniversalCheckout.showError() when wishing to display the default SDK error view.
• The locale is now optionally set in UniversalCheckout.initialize() and is used solely to determine language and localisation.
• A countryCode parameter has been added to showVault()/showCheckout(). This is used to determine location for different payment sessions (e.g. Klarna). If a country code has already been passed in when creating a Primer client token on the backend this SDK’s countryCode value is ignored.
• Minor bug fixes & improvements to stability and UX.

• Major improvements to UI for checkout view and managing saved payments.
• 1-click checkout enabled in default (universal) checkout view.
• Improved success screens with some customisability.
• Delete/select saved payment methods enhanced.
• Overall improvements to stability and UX.
• No updates to Klarna & direct debit flows.

• You can easily integrate ACH via Stripe into your payment stack with just a few clicks through Primer. Visit the integrations section of the dashboard to learn more or consult the direct integration guide.