iOS SDK

​

✨ Improvements

• Improved threading in PrimerUIManager and TokenizationProtocols
• Introduced handled flag in data models for clearer state management
• Migrated tokenization view models (StripeAch, CardForm, and PaymentMethod) to async/await

​

🔧 Fixes

• Convert 2-digit expiry years to 4-digit in headless checkout
• Fixed Klarna payment method manager category

​

🛠️ Refactor

• Cleaned up error handling in UserInterface and Core

​

🚀 New features

​

✨ Improvements

• Added support for MM/YY expiry date format
• Enhanced Apple Pay error handling with new specific error IDs:
  • apple-pay-no-cards-in-wallet: Detects when no payment cards are configured in Apple Wallet
  • apple-pay-device-not-supported: Identifies devices that don’t support Apple Pay
  • apple-pay-configuration-error: Reports merchant configuration issues
  • apple-pay-presentation-failed: Captures general presentation failures

​

🔧 Fixes

• Reduce console noise for nil remoteUrl in ImageManager
• Reduce excessive validation logging

​

🛠️ Refactor

• Introduce default values for PrimerError
• Migrated many classes and files to async await
• Clean up UI event posting

​

🔧 Fixes

• Upgraded Primer3DS which includes a fix for missing CartesBancaires DirectoryServerID mapping.

​

🔧 Fixes

• Fix memory crash in validateRawData with weak self capture (#1185)

​

✨ Improvements

• Consolidate PrimerClientSession

​

✨ Improvements

• UIColor: Added primer prefix to gray color variables to improve naming consistency and avoid potential conflicts with other libraries.
  Migration Guide

​

✨ Improvements

• Klarna auto continues when single payment option
• Implement the Co-badged Cards feature on Drop-in

​

✨ Improvements

• Reduce init(coder:) boilerplate
• Remove unused code from Networking
• Finalise classes where appropriate

​

✨ Improvements

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

​

🔧 Fixes

• We have fixed a crash issue that occurred during NolPay initialization.

​

✨ Improvements

• We have made several cleanups and improvements across the SDK.

​

✨ Improvements

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

​

🔧 Fixes

• We have fixed an issue which resulted in incorrect formatting of the currency strings in our UI for french locales.

​

✨ Improvements

• Improved error handling when server returns 202 response code

​

🔧 Fixes

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

​

✨ Improvements

• We have made changes to our internal Analytics logging system which will result in fewer unnecessary logs being sent.

​

✨ Improvements

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

​

🔧 Fixes

• We have fixed a bug in our Drop-In Card Form, which resulted in a poor user experience while using RTL formatted languages.

​

✨ Improvements

• 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 iOS 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. This requires upgrading your primer-sdk-3ds-ios dependency to version 2.4.2. For more information on 3DS SDK version, see here.

​

🧪 Experimental

• 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

​

✨ Improvements

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

​

🔧 Fixes

• We have fixed an issue where PaymentInstrumentData.accountNumberLast4Digits was incorrectly named PaymentInstrumentData.accountNumberLastFourDigits when exposed via the PrimerHeadlessUniversalCheckout interface. Visit our SDK Reference for more information.

​

✨ Improvements

• It is now possible to vault ACH via Stripe payments, and pay with vaulted ACH via Stripe tokens. See our docs for more info.
• It is now possible to granularly control Apple Pay Billing and Shipping options. See our docs for more.

​

🔧 Fixes

• We have fixed an issue where the wrong error (generic-underlying-errors) was passed when a user cancelled a PayPal payment. Now, the correct error (payment-cancelled) is reported.
• We have updated the default background colour of the default theme for dark mode.
• The close button is now disabled for Klarna during payment processing.
• The success asset is now more prominent in dark mode.

​

🔧 Fixes

• Updated the 3DS SDK to version 2.4.1 which fixes a crashing issue.
• Remove precondition on presentPaymentMethod which could cause a crash in certain scenarios.

​

✨ Improvements

• We have added additional dismissal controls to PrimerUIOptions. It is now possible to dismiss the Primer UI via gestures, an explicit close button, or both. See our SDK reference for more information.

​

🔧 Fixes

• Fixes for range or index out of bounds crash in the Card Form UI.
• Fixes for a crash in InternalCardComponentsManager.

​

✨ Improvements

• Expose VaultedPaymentMethod initialiser

​

🔧 Fixes

• Prevent dismissal of Drop-in card form while a payment is active
• Discover card network image not showing
• Move the cursor to the end of the text after pasting the card number
• Errors in the card form are now correctly localized

​

🔧 Fixes

• Adyen Blik dismissal issue and small UI glitch

​

🔧 Fixes

• Fixed an issue where Adyen Vipps would not fall back to the Web flow in the event that the Vipps mobile app was not installed.
• Fixed an issue where Adyen Blik was not present in PrimerHeadlessUniversalCheckout availablePaymentMethods.
• Various stability improvements.

​

✨ Improvements

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

​

🔧 Fixes

• Fixed an issue where the PayPal flow was unusable in the Drop-In Universal Checkout
• Fixed an issue where PrimerCheckoutData was nil when reporting an error in payment creation.

​

✨ Improvements

• Improved initialization: We have strengthened the iOS SDK’s initialization process, ensuring it remains reliable even if users experience connectivity drops. These changes guarantee a smoother experience
• We have made improvements to our internal analytics to facilitate troubleshooting

​

🔧 Fixes

• Setting the uiDelegate via PrimerHeadlessUniversalCheckout.current.start now works as expected.

​

✨ Improvements

​

✨ Improvements

• Create a client session with the desired merchant name as shown here
• The iOS SDK will then show this name on the Apple Pay flow rather than the merchant name on your Primer account.
• Setting this value via PrimerSettings is now deprecated.

​

🔧 Fixes

• Fixed a crash that could occur when using PrimerSDK from multiple threads.
• Fixed a crash that could occur during Primer3DS initialization.

​

✨ Improvements

• We have removed Card Components and related UI from the SDK. Card components was previously deprecated.

​

🔧 Fixes

• Fixed an issue where payment resume network responses weren’t being handled correctly.
• Fixed a crash in CVV recapture caused by setting explanation text.

​

🔧 Fixes

• We have aligned the card expiry date validation logic between the Drop-In and Headless integrations, which were previously different.
• Fixed a bug in the Klarna Headless implementation where the correct events were not fired during a manual payment flow.

​

🔧 Fixes

• Fixed a bug in the Klarna Headless implementation where the correct events were not fired during a manual payment flow.

​

✨ Improvements

• We have aligned error handling across mobile platforms and enhanced our analytics capabilities. Additionally, we have thoroughly documented all errors. For more details, please refer to the official documentation here.
• We have improved validation of the custom URL scheme setting used for payment methods with native UI.

​

🔧 Fixes

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

​

✨ Improvements

​

🔧 Fixes

• The release involves a fix to the Primer API client on iOS to allow payments made with NolPay to settle correctly.

​

✨ Improvements

​

✨ Improvements

• We’ve simplified the way that we make network requests and improved how we log traces and analytics events when requests are made.

​

🔧 Fixes

• Fix Nol pay Xcode errors
  • Addressed an intermittent build failure issue related to PrimerHeadlessUniversalCheckout not recognizing PrimerHeadlessNolPayManager due to specific Xcode build settings and packaging nuances within CircleCI/Fastlane environments.
  • The update ensures compatibility with Xcode 15.2 and proper handling of nested classes and conditional imports, stabilizing the integration of PrimerNolPaySdk and PrimerSDK.

​

🔧 Fixes

• Fix Nol pay Xcode errors
  • Build failure issue related to PrimerHeadlessUniversalCheckout not recognizing PrimerHeadlessNolPayManager due to specific Xcode build settings and packaging nuances within CircleCI/Fastlane environments.

​

🚀 New feature

• Merchants can now prompt customers to re-enter their CVV for additional verification during checkout, improving security without storing CVV data.

​

✨ Improvements

• Update 3DS to the latest version

​

🚀 New feature

• Pay now
• Pay later: Pay in 30 days
• Pay over time: Pay in 3-4 instalments. First payment right away, then the rest in instalments (no interest)
• Fair financing: Instalment plans of 6, 12, 24, and 36 months with flexible payments (with interest)

• The Klarna Drop-In integration now uses the same code as the headless integration under the hood, resulting in a more robust experience.
• Klarna Drop-In now has a fresh new design.

​

✨ Improvements

• Bumped minimum iOS version to 13.0
  • This means that our SDK now works with apps that target iOS 13.0 and above
• The loading spinner appears more promptly in drop-in checkout after the user submits the payment
• Local card network identification is now significantly faster and more performant

​

✨ Improvements

• 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’ve made several internal improvements to our analytics service that improve its performance. This also fixes a memory leak that caused a crash in very specific circumstances for older versions of the SDK.
• In drop-in checkout, the card icon now updates correctly whenever the entered card number is changed.

​

✨ Improvements

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

​

✨ Improvements since 2.20.1

• Fix NOL pay bug - fetching of the cards
• Implement new currency handling logic
• Update 3DS to the latest version

​

✨ Improvements since 2.20.0

• Fixes an issue where PrimerSDK had a dependency on KlarnaMobileSDK v2.2.2

​

💳 APMs support

​

iDEAL via Adyen

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

​

✨ Improvements since 2.19.0

• Throw error when using NativeUIManager for non-native payment method (#772)
• Improved Errors in the event Apple Pay cannot be presented.

​

🚀 New Features since 2.18.3

• In this release, our 3DS support has undergone significant enhancements, offering a multitude of improvements that improve the conversion rate of 3DS challenges. Please note, with this update, compatibility requires the use of the 2.1.0 version of the 3DS SDK (pod 'Primer3DS', '2.1.0')
• We have also improved internal analytics by adding additional information to errors that the SDK can encounter. This will enable us to troubleshoot issues much quicker.

​

✨ Improvements since 2.18.2

• Fixed analytics issue causing high memory usage and occasional freeze

​

✨ Improvements since 2.18.1

• Fix phone validation
  • Add local empty phone validation before sending the string to server

​

✨ Improvements since 2.18.0

• Fix State Machine for Nol Pay
  • Developers can now move through steps as expected

​

🚀 New Features since 2.18.0-b1

• Logging interface for SDK
• Implement async Phone Validation for Nol

​

✨ Improvements since 2.18.0-b1

• Fixes ApplePay button rendering logic

​

🚀 New Features since 2.17.6

​

nol Pay

• Listing Nol cars: Listing previously linked Nol payment cards using NolPayLinkedCardsComponent.
• 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.

​

✨ Improvements since 2.17.5

• • Add UIKit import to Mock3DSService.swift - fixes Swift Package Manager compilation issue.

​

✨ Improvements since 2.17.4

• Removed noisy analytics events during SDK init

​

✨ Improvements since 2.17.3

• Upgrades for Xcode 15

• We’ve removed the UIKit import guards from all files

• Fix issue where Cardholder Name field would not accept spaces in Headless Integration.

• Fix Apple Pay crash

​

🚀 New Features since 2.16.7

• Headless Vault Manager Add PrimerHeadlessUniversalCheckout.VaultManager() which returns an instance of PrimerHeadlessUniversalCheckout.VaultManager. It provides the following features:
  • 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.
• Our 3DS service has been completely revamped. Primer SDK now supports 3DS protocol version 2.2.0. It includes the following enhancements:
  • Support 3DS weak validation.
  • Support 3DS OOB flow.
  • Improve 3DS reporting.
  • Set the 3DS sanity check in PrimerSettings to false when you are in DEBUG mode, to disable the device check when testing on the simulator.
• PrimerPaymentMethodAsset now exposes the payment method’s friendly name
• Reintroduce showing a payment method directly with the Drop-In UI integration.
• Support for iPay88 This version is adding support for iPay88 payments in Malaysia. Our documentation has been updated to reflect these changes. You can also find a Migration Guide detailing the changes.

• Fix vaulted payment method on Drop In not getting tapped
• Enhance 3DS auth rates
• Fix checkout not rendering when there are vaulted payment methods
• Make performance improvements on raw data manager validation delegate
• Fix the scenario where the payment method’s image file is missing
• Print console warning when a decisionHandler is not implemented
• Observability improvements
• Improves cancellation happening from 3rd party payment apps through deep links
• Fix Atome cancellation from within the web view
• Fix UI unresponsiveness happening on iOS 16.0.x in certain cases

​

✨ Improvements since 2.17.0-rc.16

• Fix vaulted payment method on Drop In not getting tapped

​

✨ Improvements since 2.17.0-rc.15

• Enhance 3DS auth rates

​

✨ Improvements

• 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

​

✨ Improvements since 2.17.0-rc.14

• Fix issue with Vipps getting presented

​

✨ Improvements

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

​

✨ Improvements since 2.17.0-rc.13

• Fix checkout not rendering when there are vaulted payment methods
• Make performance improvements on raw data manager validation delegate

​

✨ Improvements since 2.17.0-rc.12

• Apply fix on PayPal vaulting
• Fix Klarna archiving issue

​

✨ Improvements

• 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
• Set 3DS sanity check in PrimerSettings to false when you are in DEBUG mode, to disable the device check when testing on the simulator.

​

✨ Improvements since 2.17.0-rc.11

• Minor fixes

​

🔧 Fixes

• Take into account tax and discount on Apple Pay items
• Prioritize merchant amount over total amount
• Only take into account surcharge when merchant amount is not set

​

🔧 Fixes

• Take into account tax and discount on Apple Pay items
• Prioritize merchant amount over total amount
• Only take into account surcharge when merchant amount is not set

​

🔧 Fixes

• Expose payment instrument data on tokenization callback
• Fix issue that prevented the client session from being updated when restarting headless checkout
• Make iPay88 userContact optional

​

🔧 Fixes

• Expose payment instrument data on tokenization callback

​

🔧 Fixes

• Fixed SDK crashing when Primer3DS is not included
• Fixed build issue due to iPay88 when archiving

​

✨ Improvements since 2.17.0-rc.7

• Modify iPay88 validation rules

​

✨ Improvements since 2.17.0-rc.6

• Improved analytics

​

✨ Improvements since 2.17.0-rc.5

• Improved analytics

​

✨ Improvements

• PrimerPaymentMethodAsset now exposes the payment method’s friendly name

​

✨ Improvements since 2.17.0-rc.4

• Improved analytics
• Fix scenario where payment method’s image file is missing
• Print console warning when a decisionHandler is not implemented

​

✨ Improvements since 2.17.0-rc.3

• Fix for React Native

​

✨ Improvements

​

✨ Improvements since 2.17.0-rc.2

• Contains the features and improvements of 2.16.5
• Observability improvements
• Improves cancellation happening from 3rd party payment apps through deep links
• Fix Atome cancellation from within the webview
• Fix UI unresponsiveness happening on iOS 16.0.x on certain cases
• Fix iOS console warnings

​

🔧 Fixes

• Fix an issue that prevented 3DS from working with some card networks (AMEX, Maestro, Discover, and JCB)
• Fix an issue that prevented 3DS from working when the billing address is set or updated after the SDK is initialized with a client session
• Improve 3DS visibility

​

✨ Improvements

​

✨ Improvements since 2.17.0-rc.1

• Contains the features and improvements of 2.16.3 and 2.16.4
• Remove Google Pay from the list of payment methods

​

✨ Improvements

• Fix translations

​

🔧 Fixes

• Fix build issue on Xcode 13

​

✨ Improvements

• Add translations
• Add analytics events and errors

​

🔧 Fixes

• Fix theming issue

​

✨ Improvements

​

✨ Improvements since 2.16.2

• Contains the features and improvements of 2.16.1 and 2.16.2
• Remove Google Pay from the list of payment methods

​

🔧 Fixes

• Fix Xendit OVO redirect

​

🔧 Fixes

• Fix Klarna payment category

​

✨ Improvements

​

🔧 Fixes

• Remove Xcode configuration flags from podspec.
• Apple Pay will return an error on simulator

​

🔧 Fixes

• Fixing the MBWay local asset loading
• Removed the GENERATE_INFOPLIST_FILE as part of the xcconfig of the PrimerSDK podspec as it was causing an issue upon archiving the hosting apps
• Added CODE_SIGNING_ALLOWED => NO to xcconfig in podspec to remove the Signing requirement introduced in Xcode 14+

​

🔧 Fixes

• Fixed the Contributing link in our SDK Readme
• Added the GENERATE_INFOPLIST_FILE as part of the xcconfig of the PrimerSDK podspec
• Improved the Cardholder Name field availability in Card form

​

🔧 Fixes

• Fixed an issue with regards to the availability of retrieving some assets
• Small improvements in the way the Country selector in billing address gets loaded

​

🔧 Fixes

• Fixed 3DS on frictionless flows
• Sending analytics events with correct sdkVersion

​

🔧 Fixes

• Fixed the PayPal vaulting service

​

🔧 Fixes

• We have fixed wrong cardholder name checkout modules evaluations which resulted in not requesting cardholder name on headless
• We have fixed raw data validation callbacks not being fired on headless

​

🔧 Fixes

​

✨ Improvements

​

💳 APMs support

​

Retail Outlets via Xendit

​

🔧 Fixes

​

🔧 Fixes

​

✨ Improvements

​

💳 APMs support

​

Bancontact via Adyen

​

Apple Pay billing address

​

🔧 Fixes

​

✨ Improvements

​

✨ Improvements

​

✨ Improvements

​

✨ Improvements

​

✨ Improvements

​

✨ Improvements

​

✨ Improvements

​

✨ Improvements

​

🚨 Migration info🚨

​

✨ Improvements

​

💳 APMs support

• Internal codebase refactors
• Fix Danger check

​

✨ Improvements

​

💳 APMs support

​

Billing address support 🧾

• Fix checkout with Adyen iDeal

​

✨ Improvements

​

✨ Payments created automatically

• Fix Klarna checkout
• Dummy APMs

​

✨ Improvements

​

✨ Payments created automatically

extension MyViewController: PrimerDelegate {

   func clientTokenCallback(_ completion: @escaping(String ? , Error ? ) - > Void) {
      // API call to fetch client token from your backend.
      fetchClientToken() {
         (token, err) in
         completion(token, err)
      }
		}

	func onTokenizeSuccess(_ paymentMethodToken: PaymentMethodToken, resumeHandler: ResumeHandlerProtocol) {
	   // Send the payment method token to your server to create a payment
	   sendPaymentMethodToken(token: paymentMethodToken) { (res, err) in
	      if let err = err {
	         resumeHandler.handle(error: err)
	      } else if
	      let res = res {
	         guard
	         let requiredActionDic = res["requiredAction"] as ? [String: Any],
	            let clientToken = requiredActionDic["clientToken"] as ? String
	         else {
	            resumeHandler.handleSuccess()
	            return
	         }

	         resumeHandler.handle(newClientToken: clientToken)
	      }
	   }
	}

	func onResumeSuccess(_ resumeToken: String, resumeHandler: ResumeHandlerProtocol) {
	   // Resume the payment
	   sendResumeToken(resumeToken) {
	      (res, err) in
	      if let err = err {
	         resumeHandler.handle(error: err)
	      } else if let res = res {
	         resumeHandler.handleSuccess()
	      }
	   }
	}

}

​

🔨 Deprecation

• Add Klarna checkout

• Add the HUC beta feature

• Fix vaulting with PayPal
• Return error when vaulting without a customer id in the client session

• Added following APMs
  • Coinbase
  • Opennode
  • 2c2p
  • PayShop
• Minor codebase improvements

• Fix Apple Pay merchant name not showing

• Add the Processor3DS functionality

• Refactor Apple Pay cancellation flow
• Change primer error message to something generic

• Translations updates
• Better accents handling when uppercased text is presented
• Better handling of subunits for VND (Vietnamese Dong) currency

• Fixes cardholder name field not deleting characters
• Changes cardholder name field’s keyboard type

• Fixes Klarna tokenization when vaulting
• Fixes disabled user interaction on Dot Pay

• Fixes Klarna and Twint logos

• Added following APMs
  • Paytrail
  • Interac

• Client session validation improvement via dedicated BE API
• React Native bridge fixes
• PayPal logo aligned with other platforms
• Other UI improvements

• Adds payment method Blik
• Adds React Native helpers.

• Added right-to-left support
• Various bug fixes and enhancements

• Fix Apple Pay merchant name not showing

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

• Add missing localized strings
• Fix PayNow image color

• Fix compiler warnings

• Remove submodule responsible for localization because it was blocking SPM
• Make License file a resource
• Fix SPM import errors

• Improved UI for loading, success & error screens
• Fix APM redirect failing on some cases
• Remove some warnings

• Added the support for the 12 new languages;
  • Danish
  • Dutch
  • French
  • German
  • Greek
  • Italian
  • Norwegian
  • Polish
  • Portuguese
  • Spanish
  • Swedish
  • Turkish

• Improvements to payment method redirections

• Add Xfers
• Add payer info on PayPal
• Fix RN bug

• Tokenization will always return a SINGLE_USE token
• Add locale in analytics

• Support for capturing postal code in card form and observing using client session actions
• Additional currencies and associated symbols
• Improved error handling
• Improvements to surcharge UI
• Autofocus on the next field in the card form feature added.

• Add Atome Payment Method in beta

• Fix replacing that was replacing country code.

• Ignore client session warning if client session has already modified the settings
• Fix bug with enum’s default case.

• Fixes dark mode colors
• Fixes searchfield return button tap bug
• Add missing ”+” on payment methods surcharge
• Changes amount in minor units in the example app
• Sort picker view rows in the example app alphabetically

• Fixes client token env issue

• Fixes Apaya redirection for subdomains

• Add tests
• Minor fixes

• Minor fixes

• Minor fixes
• Surcharge feature stable

• Adds surcharge functionality
• Adds client session actions (documentation)
• Fix laggy cardnumber field
• Various fixes

• Adds Bancontact, EPS, Giropay, iDeal and Sofort via Buckaroo
• Minor fixes on the Example app
• Minor fix on PayPal presentation

• Deprecates amount, currency, countryCode, customerId, customer, billingAddress & orderItems from PrimerSettings in favour of setting them in the client-session with POST /client-session.

• Deprecates PrimerTheme and introduces PrimerThemeData.
• Restructure SDK theming
• Adds Payconiq, Giropay & Bancontact via PayNL, and iDeal & Bancontact via Mollie
• Focus on cardnumber field when opening card form
• Provide error when a payment method hasn’t been configured
• Provides the functionality to change the background view’s color
• Integrate with client session (documentation)

• Fixes Apaya redirection for subdomains

• Fixes status bar bug on Apaya webview
• Adds iDeal & DotPay view Adyen
• Fixes 3DS challenge not being presented when opted-in in scenes

• Hotfix for broken case, and its presentation.

• Adds payment methods
  1. iDeal
  2. Hoolah
  3. Ali Pay
  4. Trustly
  5. Giropay
  6. Twint

• Fixes Apaya crash when presenting and dismissing almost at the same moment.

• Fixes Apaya bug when dismissed.

• Add card network and validation icons on the card form
• Bug fixes

• Bump

• Fix Apple Pay bug on React Native

• Fix resume handler protocol in certain situations.

• Adds dynamic 3DS logic
• Applies minor fixes

• Fixes unknown payment method parse.

• Fixes SDK presentation when opted-in to UISceneDelegate

• Fixes Swift Package Manager installation

• Deprecates showCheckout(_ controller:, flow:) in favour of:
  1. showUniversalCheckout(on:)
  2. showVaultManager(on:)
  3. showPaymentMethod(:, withIntent:, on: UIViewController)
• Applies minor fixes
• Fixes failing tests

​

✨ Improvements

• Phonenumber for Apaya can be passed in PrimerSettings.Customer
• Minor fixes

​

✨ Improvements

• Refactors UI
• Fixes UI bugs introduced on iOS 15

​

✨ Improvements

• Fix Xcode 12.4 building
• Refactor currency formatting

​

✨ Improvements

• Add the Apaya payment method
• Fix card view validation
• Apply minor fixes

​

✨ Improvements

• Fix configuration parse bug on staging
• Add missing Klarna tokenDetails on tokenization
• Fix bottom view bouncing when the keyboard was presented at the same time as a push animation
• Fix bottom view scrolling bug on universal checkout and vault manager

​

Breaking Changes

• Delegate function’s clientTokenCallback completion handler has been modified.

​

✨ Improvements

• Delegate functions tokenAddedToVault, onTokenizeSuccess, onCheckoutDismissed, checkoutFailed are now optional.
• Deprecate authorizePayment delegate function in favour of onTokenizeSuccess.
• Fix return & cancel urls for PayPal checkout

​

✨ Improvements

• Add cancel error ( domain: "primer", code: 1500)
• Add UI tests
• Embed PromiseKit for future use

​

✨ Improvements

• Automatically redirect from Klarna to BankId (if installed)
• Fix UI bugs on universal checkout & vault
• Fix Apple Pay cancel from button

​

✨ Improvements

• Fix dismissing root view controller on error
• Fix flows
• Deprecate authorizePayment in favor of onTokenizeSuccess

​

Features

• Add ApplePay

​

✨ Improvements

• Add ApplePay functionality.
• Add PENDING amount functionality on OrderItem. Initializer throws errors if not initialzied correctly.
• Add payment networks
• Change the order of fields on the card form view.
• Modify extensions access levels.
• Use subclasses and extend them, if needed.
• Remove duplications and unused functionality.

​

✨ Improvements

• countryCode can be passed from the backend or, optionally, on the SDK. Backend countryCode has higher priority.
• Fix wrong error description.
• Expose LocaleData and let it be set on the PrimerSettings object. If no LocaleData is provided the SDK will default to the system’s Locale.
• Modify classes, protocols and extensions access level.

​

✨ Improvements

• Update example

​

✨ Improvements

• Fix vault title
• Fix card form title
• Update labels
• General UI fixes

​

✨ Improvements

• Validate token parameter on webview redirects
• Catch cancel state on webview redirects
• Refactor webview process, work with a completion handler instead of viewWillDisappear
• Expose errors
• Move various functionalities from view controllers’ view life-cycle to more appropriate places
• All public facing API call are dispatched on the main queue (for now)
• Add & fix Klarna validations
• Fix missing super() calls
• Add scheme variable for logging and default it to false
• Remove alerts
• Delegate methods are called on the main queue
• Remove unused variables. Modify one-liners to be more readable.

​

Breaking Changes

• The completion of the clientTokenCallback(_:) delegate function now expects a string

​

✨ Improvements

• exp has been added in the client token payload and token validation is performed. If token is expired an error will be returned through the checkoutFailed(with:) delegate function

​

✨ Improvements

• Provide isInitialLoadingHidden param which hides the initial loading view
• Refactor the success/failure view
• Expose errors trough the checkoutFailed(with:) delegate function
• Update icons

​

Bug fixes

• Remove card scanner button
• From vault, move back to checkout if no card is present
• Remove Add new card from the vault manager
• Replace Klarna customer token copy with user’s Klarna email

​

✨ Improvements

• Expose tokenAddedToVault(_: PaymentMethodToken) delegate function

​

Bug fixes

• Rename Klarna Customer Token to user’s email (if present)
• Rename SAVED CARD to SAVED PAYMENT METHOD

​

✨ Improvements

• Refactor Klarna flow

​

Bug fixes

• Update success screen
• Update localizable strings

​

Bug fixes

• Fix Swift Package Manager bundled resources
• Fix Swift Package Manager localization strings
• Update Swift version to 5.3

​

✨ Improvements

• Introduce the Klarna payment method (in beta)
• The Vault Manager now supports vaulting PayPal
• Add Swift Package Manager integration support
• Various performance and size optimisation

​

Bug fixes

• Include toolbar above keyboard on date picker
• Fix buggy behaviour of RN bridge
• Improve the validation of the IBAN field in the Direct Debit form