Release notes - iOS

Version 7.12.1

Implemented general improvements and bug fixes.

SHA: 2f47e9a7c3f9e46067612ec10f74cc84db8dfe0870607fdad0b6188c48190d7b

Version 7.12.0

Implemented general improvements and bug fixes.

SHA: 62bbf4af6f6a48f3eb056d56e3e10fdc8818b73157f2b1038bf13780fd3db3a5

Version 7.11.0

A mandatory update to the nSoftware (IPWorks) library is required because the Mastercard certificate expires on 15 July 2026. You must upgrade to Mobile SDK version 7.11.0 (or newer) and IPWorks 2.4.9625 before 7 July 2026.

If you do not upgrade before 7 July 2026:

  • 3-D Secure authentication may fail.
  • Transactions may be declined or not processed.
  • After the certificate expires, Mastercard transactions fail if the Mobile SDK is not updated.

Upgraded the nSoftware (IPWorks) library to version 2.4.9625.

PayPal now uses ASWebAuthenticationSession instead of SafariViewController for a better user experience.

General improvements and bug fixes.

If you are using an SDK version below 6.0.0, you must follow the Migration guide step by step.

A mandatory update to the nSoftware library is required because the Mastercard certificate expires on 15 July 2026. You must upgrade to Mobile SDK 7.11.0 and IPWorks 2.4.9625 by 7 July 2026.

SHA: 3583a56c668e3475b06a6fb6fe1c30af449bb6a1570bdc451490802c7d2a634f

Version 7.10.0

Implemented general improvements and bug fixes.

SHA: 37cc7d7fa1addcc17cbb58c0cb8c209a8e85a4ffbd31fd4db843c60736e01a26

Version 7.8.1

Implemented general improvements and bug fixes.

SHA: a42dd3fbd6ff977b8edf2130212b1251ffe3ba59707bca046aa837bb3bd16eea

Version 7.6.3

Implemented general improvements and bug fixes.

SHA: bd39c008cc8bb38dbfb4b27303535494a70d21d44bcd12584a37ffd0681c6d1b

Version 7.6.2

Implemented general improvements and bug fixes.

SHA: 1a2f0ad3c3fdecf7b3850d50c640f7757b7cbd5d0d1bdf8cc3bb9d76aa73e62a

Version 7.6.1

Implemented general improvements and bug fixes.

SHA: 48175a08be9ce6109bdf81e1310db44038edd02810ce7afb6f17e3c800f2b594

Version 7.6.0

Upgraded to the latest version of the nSoftware 3DS2 IPWorks library.

General performance enhancements and bug fixes.

SHA: cc5189ef30dd584603d500236e8c1e0b919075568eace9c975675e3c35ca0905

Version 7.4.0

Upgraded to the latest version of the nSoftware 3DS2 IPWorks library.

General performance enhancements and bug fixes.

SHA: 7138789f3108d58b269f6436bc99f44b6db50c74d8859f0f89fccfa8f4782cd1

Version 7.3.0

Implemented general improvements and bug fixes.

SHA: 9f89e9c68e4ff723785eeea324c40f832b528e4a504a00070011de90e0996899

Version 7.2.3

Implemented general improvements and bug fixes.

SHA: 3d91edd67b196651133f8dcb4b2d8aeadc380f92f1ce558974025fa1cd1c368f

Version 7.2.2

Implemented general improvements and bug fixes.

Resolved the UI type compatibility issue introduced in versions 7.0.0 to 7.2.1. The HtmlOob and Information sdkUiTypes are now handled to prevent potential 3-D Secure transaction rejections by some Directory Servers.

SHA: 3df5fb1468e570f790179ae56975eed8c7b987e54dbdfb51071a22c9f686dafb

Version 7.2.1

📘

Awareness note: UI type compatibility in Mobile SDK (iOS) versions 7.0.0 to 7.2.1. In version 7.0.0, two new sdkUiTypes (HtmlOob and Information) were introduced in line with EMVCo Bulletin No. 279. However, some Directory Servers may reject these types, potentially impacting 3-D Secure transactions.

Workaround: override the challengeUiTypes in threeDSConfig as shown below:

OPPThreeDSConfig().challengeUiTypes = [.text, .singleSelect, .multiSelect, .oob, .html]

This issue is resolved from version 7.2.2 onwards.

Implemented general improvements and bug fixes.

SHA: 15ef2dc83eabff78aa92d35e7049c72c35f8ed4319b449adffcf684609fb62d3

Version 7.2.0

📘

Awareness note: UI type compatibility in Mobile SDK (iOS) versions 7.0.0 to 7.2.1. In version 7.0.0, two new sdkUiTypes (HtmlOob and Information) were introduced in line with EMVCo Bulletin No. 279. However, some Directory Servers may reject these types, potentially impacting 3-D Secure transactions.

Workaround: override the challengeUiTypes in threeDSConfig as shown below:

OPPThreeDSConfig().challengeUiTypes = [.text, .singleSelect, .multiSelect, .oob, .html]

This issue is resolved from version 7.2.2 onwards.

Implemented general improvements and bug fixes.

SHA: e7142b650758ceffd264771c47e72e1eb7ac0baf631633d9fe25a85a5342236c

Version 7.1.0

📘

Awareness note: UI type compatibility in Mobile SDK (iOS) versions 7.0.0 to 7.2.1. In version 7.0.0, two new sdkUiTypes (HtmlOob and Information) were introduced in line with EMVCo Bulletin No. 279. However, some Directory Servers may reject these types, potentially impacting 3-D Secure transactions.

Workaround: override the challengeUiTypes in threeDSConfig as shown below:

OPPThreeDSConfig().challengeUiTypes = [.text, .singleSelect, .multiSelect, .oob, .html]

This issue is resolved from version 7.2.2 onwards.

Added a new feature for enabling dynamic updates to the card type label based on the detected card type. This feature is available through advanced configuration options. For implementation details and configuration guidance, refer to the Mobile SDK advanced options.

Implemented general improvements and bug fixes.

SHA: d0bdb9fca3f807aaee4c9d38dabb76ffd172b9eba94e8dd736556da3517fd368

Version 7.0.0

📘

Awareness note: UI type compatibility in Mobile SDK (iOS) versions 7.0.0 to 7.2.1. In version 7.0.0, two new sdkUiTypes (HtmlOob and Information) were introduced in line with EMVCo Bulletin No. 279. However, some Directory Servers may reject these types, potentially impacting 3-D Secure transactions.

Workaround: override the challengeUiTypes in threeDSConfig as shown below:

OPPThreeDSConfig().challengeUiTypes = [.text, .singleSelect, .multiSelect, .oob, .html]

This issue is resolved from version 7.2.2 onwards.

Implemented general improvements and bug fixes.

SHA: 7c40342c44bba85e75fb2420042733e9722e96490aef653c83ee77e2fc463f51

Version 6.21.0

Added support for card type and card network parameters in Apple Pay integration.

Changed the Mobile SDK minimum deployment target to iOS 13.0.

General improvements and bug fixes.

SHA: 4ddcd9fa63c3129e5ed20ba4d9ca380c7de12c62db32c1d80436aa7189f07d0f

Version 6.20.1

Resolved an issue where some iOS users were encountering payment failures during the checkout process with Apple Pay.

SHA-256: e0ab08ccd2a5f3e3bf118d674e5f04b63435dbcc9c10f5efe181098962b07e50

📘

As this hot fix uses the code base of Mobile SDK 6.20.0, ensure that when integrating you follow the release notes from 6.20.0 for smooth integration.

Version 6.20.0

The nSoftware 3DS2 library is updated to version 2.3.9048. It is mandatory to use this nSoftware version with the latest Mobile SDK version (6.20.0).

General improvements and bug fixes.

SHA-256: 44139dd86d50d2171baf76244181a24353178eeda3dd459ee7498bf58c16311c

Version 6.19.1

Resolved an issue that caused the application to crash when changing the orientation during the drop-in button flow.

SHA-256: 7b353a6f03a6897ebae0c3d7477f96b44341501b1f82238e1e22a994cb6b8625

Version 6.19.0

FraudForce library verified with version 5.7.0, minimum iOS version 15.0 required.

General improvements and bug fixes.

SHA-256: 781d0435b77572ecba3b87cd6bf0e4dfadff8b8737f6bab720b1f5f94d0ac13f

Version 6.18.0

General improvements and bug fixes.

SHA-256: fde45b8ae0a46f1cd85d3fdb15db21321b34c87d3c51d2a8d106fc49e677f403

Version 6.17.0

To prevent sensitive data from being copied, we have blocked the copy and cut context menu for the card holder name and expiration date.

Unified error codes for invalid checkout ID in sync with Android.

Added support to handle nil for navigation controller in the 3-D Secure challenge completion callback.

General improvements and bug fixes.

SHA-256: f50f486dfb808492f45eb9d144b3123f173494fa37d4e57e6fff109291fdf840

This version has a known issue while using the Ready-to-use UI button integration in iOS. When a customer clicks the payment brand button (integrated) and changes the phone orientation on the payment screen, the app crashes. The fix for this issue is available from version 6.19.1 onwards.

Version 6.16.1

Added support to collect browser parameters during the web 3-D Secure authentication process.

SHA-256: 247811c53027b62b32b2644f6fb46cde5d34afc89e857965ede587f872a5e790

Version 6.15.0

General improvements and bug fixes.

SHA-256: 15063a43a3b05a77064ac3f29b52e238a4f1cc99c30f7efb3b6470c68221a252

Version 6.14.1

Resolved a NetworkManager naming collision issue.

SHA-256: 24eef560a2780a2b0429e64f79c4570f920c0d76ff49f9ca08f2b776cf47ae7f

Version 6.14.0

Resolved a crash issue in the Mobile SDK caused by the iOS 18 SDK update. We strongly advise adopting Mobile SDK version 6.14.0 because it is designed to work seamlessly with iOS SDK 18 and Xcode 16. Continuing to use an older Mobile SDK version with these latest tools may result in stability issues, which you can avoid by updating to Mobile SDK version 6.14.0.

General improvements and bug fixes.

SHA-256: f3fd5feb85c9acfbf2bcce4c3813da2994c3c212715a7dee386ff36074cc9476

Version 6.13.0

RTL alignment support for non-RTL system languages.

General improvements and bug fixes.

SHA-256: 8b2adb381f2cf4a5cb1b684c6389939faa7d7925a2b1ac5b3306c0b11326564e

Version 6.12.0

Added support for Apple Pay recurring payment API.

General improvements and bug fixes.

SHA-256: 9ef2237f4c220eed3dc5403fd14e5cd3dedb1c2c8c682aad00b5932ea479d6d4

Version 6.11.0

Addressed an issue where the threeDS2Listener was not being invoked for the core integration type.

To prevent sensitive data from being copied, we have blocked the copy and cut context menu for the card number field in the card detail form.

Added a privacy manifest file to the bundle.

The IPWorks library has been updated to version 2.3.8845.

General improvements and bug fixes.

SHA-256: 6f3676323dffa13125d2c2bdf3dc84c5338443799d4143205f6ce483e738849e

Version 6.10.0

Updated the Apple Pay payment method to retrieve and submit billing address and customer information.

SHA-256: c850286e1b400efc7938d0bea68cabb59836c489711300542fb8875a309073f6

Version 6.9.0

Fixed an issue so that card information remains intact when the user switches to another app.

General improvements and bug fixes.

SHA-256: fff4a48d7cf667513e9a393d96f98267750d753af513c2e1ffa49d7153456bde

Version 6.7.0

Updated the IBAN validation.

General improvements and bug fixes.

The feature that enables complete customisation for UI components is currently in Beta. Exercise caution when considering its implementation.

SHA-256: 0e7feca08ae734e4cd192fefe8ed1b50184cb799db1b1f3b0f9e958fd1538c54

Version 6.5.0

Updated the ipworks_3ds SDK to version 2.3.8788.

SHA-256: 0fd43ca71b965b014e550d86dd674cf84febe05df42d34f702792481508f16f6

Version 6.4.0

General improvements and bug fixes.

SHA-256: 971b01ecaa456fef91cf1c620af6051fbc96439c6e1712d949f14437f66256bd

Version 6.3.0

Added support for Iovation FraudForce library version 5.5.0.

SHA-256: 9c2fa89679bfb89fd0bbf9dcbe1321f9c61a7f4a20c4083418174e1a97331609

Version 6.2.0

Improved Apple Pay status handling.

SHA-256: 89aad277f26286c93730eb69dd4bd98e912737659ae7adc09a440ad00e83b425

Version 6.1.0

Added support for APPLEPAYTKN.

SHA-256: 18e2340ee77c1260cf1e539a5a4e3e6889ab62b608cffa50ef7031f989fa0de6

Version 6.0.0

The iOS version changed to 12.

General improvements and fixes.

SHA-256: 5384e062fed298f9f482d6269b1d287947cf77a0835bb8cb881bd46d3944f765

Updating from 5.x.x is not mandatory, but recommended. See the Migration guide.

Version 5.7.0

Added the version number to the 3DS SDK file names.

SHA-256: 3abcec3e2bc0e3a8ff5989ce8f9ef244a8001b6063ea444ed3d16fccb80d9eff

Version 5.6.0

Fixed an issue where the Apple Pay notification was not being sent to Apple.

General improvements and fixes.

SHA-256: 6f3ab0ebd3886be6a41239e2a0b7b5f40a696789e6c579cc8c6328e7f9acedee

Version 5.5.0

General improvements and fixes.

SHA-256: 62e338663ededa99f91166fd17f7fa58b183861534f6adec4cc896db79453941

Version 5.4.0

Added support for COPYandPAY in the Mobile SDK.

Added support for 3-D Secure 2.x cardholderInfo.

General improvements and fixes.

SHA-256: 1e8e251d947ceee7810e4bf3a529b45d543d74237f860167ce8dc34fea6f24bb

Version 5.3.0

General improvements and fixes.

Added support for optional expiry date.

SHA-256: 6e1787136db5ff893b2650379d59feccd2dd05ebb02428314ce97fe2aeb396b8

Version 5.2.0

Improved 3-D Secure 2.x web flow.

Added support for Ready-to-use UI Apple Pay button styles.

General improvements and fixes.

SHA-256: da62ed516fddabadcfd8025b20ed4330efb7d806ffa9e1706bca9fcc47896d29

Version 5.1.0

Fixed localisation typos.

SHA-256: 94f0a7d90ffe518eb6e97ab5dca0e94a0c8c18c3dec6c0ea3a3f864384e8457e

Version 5.0.0

General improvements and fixes.

Cleaned up deprecated API.

SHA-256: f8c31b0713101b512e39ffa5173a0d87ba3e71a1a3141a89f44bb7e0c0a1db70

Updating from 4.x.x is not mandatory, but recommended. See the Migration guide.

Version 4.12.0

Simplified 3-D Secure 2.x integration.

SHA-256: 8226bcdd91142ad0080865257eb61c05678f305ed60011dddbc4af9d667940f6

Version 4.11.0

Removed the UncaughtException handler internal implementation.

Updated Iovation FraudForce SDK to version 5.3.0.

Updated the internal card scanning implementation to support vertical cards layout.

SHA-256: ac6188d85cfc974e8d0e11cc0967c50fc4acf0a94bbf90fe0755d918fb47cff0

Version 4.10.0

The ipworks_3ds SDK is updated to version 2.2.8318.

Added an option for payment button customisation.

Bug fixing and improvements.

SHA-256: c5dec1dcb5616ba5121bc8e3fd510938396e9271db4c03507b0d49c0af7e17e1

Version 4.9.1

Enhanced automation redirect for external MPI web flow through MPGS.

SHA-256: e353f313a8d134b1a6ca4a31978c63d25d2b2bfe846290e302d47e6fb619abc3

Version 4.9.0

Added an option for asynchronous payment redirection.

SHA-256: 68a8a6e6c0b13041f7bbdff66e37f7b4fb51231a2d8d6af6e8da08c25ba56832

Version 4.8.0

Added support for external 3-D Secure 2.x MPI.

General improvements and fixes.

SHA-256: ed2ee8630f8fb973cd193f3b9a847765fee54b686703567636a48ae8f7850b40

Version 4.7.0

Added the ability to align the token based on the payment brand list.

General improvements and fixes.

SHA-256: 906a8f6d97ede29b954c576597cfa191e21956fe40c874650075749361a98d62

Version 4.6.0

Improved the 3-D Secure 2.x Out-of-Band (OOB) challenge flow.

Replaced the CardIO card scanning library with an internal implementation.

General improvements and fixes.

SHA-256: 9c2fe967d9edccaa8ed79f1fd57102f927c53ee68085af29cee94180e47eb00b

Version 4.5.0

Added support for external MPI web flow through MPGS.

Improved Apple Pay integration.

SHA-256: 60032793ae7df99907f4a83097e2273b5aa87ab4858cd8edb78bbaac4cddfb97

Version 4.4.1

Fixed the 3-D Secure 2.x web flow.

Version 4.1.0

Enhanced OPPPaymentProvider to get additional information about a specific card BIN.

General improvements and fixes.

Version 4.0.0

Moved the 3-D Secure 2.x extension into the base Mobile SDK.

Cleaned up deprecated API.

Updating from 3.x.x is not mandatory, but recommended. See the Migration guide.

Version 3.17.0

General improvements and fixes.

Version 3.16.0

Added support for collecting the billing address with card payment.

Version 3.15.0

Fixed a total amount view issue with Ready-to-use UI.

General improvements and fixes.

Version 3.14.0

General improvements and fixes.

Version 3.13.0

Added support for an alternative set of test and live domains.

Added a new card brand detection presentation style.

General improvements and fixes.

Version 3.12.0

Added 3-D Secure 2.x authentication for tokenisation.

Added support for Xcode 13.

Fixed an iOS 15 navigation bar issue.

Version 3.10.0

Improved Apple Pay button integration with Ready-to-use UI.

Version 3.9.0

Added support for VoiceOver.

Added support for landscape mode.

Version 3.8.0

Added support for Apple M1 chips.

Version 3.5.0

Enhanced OPPPaymentProvider: the ability to use brand detection for a specific card BIN.

Version 3.4.0

Added support for 3-D Secure 2.x browser-based authentication.

Version 3.0.0

Migrated the SDK from a universal framework to XCFramework. Cleaned up deprecated API.

Improved customisation of Ready-to-use UI strings. This is now controlled at the application level.

Updating from 2.x.x is not mandatory, but recommended. See the Migration guide.

Version 2.66.0

Added support for PayPal tokens.

Version 2.64.0

Added support for Xcode 12.

Version 2.62.0

Added native integration for 3-D Secure 2.x.

Version 2.60.0

General improvements and issue fixes.

Version 2.59.0

Updated Iovation FraudForce SDK to the latest version, 5.1.0.

Version 2.57.0

Added a check for unsupported brands in Ready-to-use UI.

Version 2.56.0

Enhanced PaymentParams to send any server parameters.

Added support for Xcode 11.

Version 2.54.0

Optimised card brand detection.

Version 2.50.0

Fixed a minor UI issue on the payment selection screen.

Version 2.48.0

Added an option for customising logos in Ready-to-use UI.

Removed the collection of the UUID which was sent as the SHOPPER_deviceId criterion (it does not affect RedShield).

Version 2.46.0

Enhanced card brand detection in Ready-to-use UI:

  • the possibility to hide the list of detected brands.

Version 2.45.0

Enhanced card brand detection in Ready-to-use UI:

  • a new way to detect the card brand based on a BIN list,
  • the possibility to set the preferred order of detected brands,
  • the first brand is selected by default if multiple brands are detected.

Version 2.42.0

Updated the Iovation flag.

Version 2.41.0

Added a new callback from the Safari browser to handle the browser close event.

Version 2.40.0

Fixed nullability warnings.

Version 2.37.0

Fixed an issue with logs.

Version 2.35.0

Added support for Xcode 10.

Version 2.33.0

General improvements and issue fixes.

Version 2.31.0

Fixed a card brand detection issue.

Version 2.30.0

Added support for installment payments.

Version 2.29.1

Fixed support for eastern Arabic digits.

Version 2.29.0

Added a new callback from the payment form to override card holder validation.

Version 2.28.0

Minor issue fixed.

Version 2.27.0

Improved card holder validation. Do not allow the card number and CVV.

Version 2.26.0

Added automatic brand support.

Version 2.25.0

Added support for optional card holder name.

Added support for optional paymentBrand for card brands in step 2.

Version 2.24.0

Added support for sending shopperResultUrl in step 2 (submitting the transaction to the server).

Version 2.23.1

Added support for zero-amount transactions.

Version 2.23.0

Added support for displaying the total amount on the checkout form.

Version 2.22.0

Added support for collecting Apple Pay shipping and billing information.

Version 2.20.0

Added support for automatic card brand detection.

Version 2.19.0

Added support for optional expiry date and CVV.

Version 2.18.0

Added support for the Iovation SDK for calculating the device fingerprint.

Version 2.16.0

Added support for right-to-left text.

Added Arabic language.

Version 2.14.0

Improved brand detection and validation procedures.

Version 2.13.0

Added a new callback on the Mobile SDK that triggers before payment submission. This callback allows the mobile app to cancel the payment submit action.

Version 2.12.0

Added support for the "create omni-token" workflow.

Fixed the conflict with the Pushwoosh SDK.

Version 2.9.0

Minor changes.

Version 2.7.0

Corrected an issue where the Mobile SDK did not appropriately handle an unexpected response from MasterPass.

Version 2.6.0

Added support for iPhone X, including Face ID authentication.

From this version, only iOS 9 or later is supported.

Version 2.5.0

Added a Demo App for Developers.

Added full support for Bitcode.

Version 2.4.0

Fixed a scroll issue on the card form on iOS 11 and fixed errors during publishing the app with the Mobile SDK to the App Store.

Updating to 2.4.0 is mandatory.

Version 2.3.0

In version 1.9.0 SDK logging capabilities were added to assist troubleshooting. From this version, this information is sent up to the server and made available through the Smart Payments Platform transaction log.

Version 2.2.0

Update for expiring certificates (9/2017 for the test system and 12/2017 for the live system).

IMPORTANT: apps using older versions stop working when the old certificates expire.

Updating to 2.2.0 is mandatory. See the Migration guide.

Version 2.0.0

As of this version, third-party libraries are not included. This keeps the SDK smaller, especially where the third-party libraries are not needed. Note: customers must now import required libraries as needed. Refer to the developer portal documentation for more information.

Updating from 1.x.y is not mandatory, but recommended. See the Migration guide.

Version 1.11.0

Added the capability to securely store and tokenise a card without making a payment at the same time.

Enhanced the ease of integration: the resourcePath URL is now returned in the step 2 response from the server so that it need not be constructed in step 3, but may be used as provided.

Server-side enhancements have been made to further support Apple Pay and Android Pay setup and management.

Version 1.10.0

Added French language.

Version 1.9.0

Added Portuguese language.

Added SDK logging capabilities. Messages sent and received are logged, as well as configuration.

Version 1.8.0

The device UDID is now sent up to the server, and may be reviewed in logs and included in risk and fraud checks.

Version 1.7.0

Added support for the Masterpass payment method.

Drop-in buttons now use stored credentials if available.

Fixed a duplicate symbol error using the AFNetworking framework.

Version 1.6.0

Enhanced the look and feel of the checkout screen that displays the payment method listing. The shop is shown in the background to provide a more seamless user experience, and the stored payment methods are displayed in a more compact and neater fashion.

Additional statistics are now sent up to the server platform, including the OS type and version, the handset device model, the Mobile SDK version, and an indicator of whether the Mobile SDK uses a custom UI or the Mobile SDK-provided UI. You can view these parameters at a transaction level through the Smart Payments Platform.

Version 1.4.0

Enhanced the Mobile SDK and the Smart Payments Platform so that payment methods can now be enabled and disabled in the Smart Payments Platform, allowing merchants to update the payment methods offered to customers without requiring an update to the mobile app.

Version 1.3.0

Added support for device authentication, that is, user authentication using the fingerprint scanner, Touch ID, password, or passcode before the payment is processed.

Version 1.1.0

Added support for Drop-In Payment Buttons. Any payment method can now be placed on any page in the merchant app, for example to support instant checkout of a particular product.

Added support for multiple checkout IDs. This supports the need to handle payment methods under different profiles so that, for example, different risk rules can be applied.

Version 1.0.1

Corrected an error whereby certain payment methods were not displayed when no stored payment credentials were available for the customer.

Version 1.0.0

This is the first GA (Generally Available) release of the Mobile Commerce SDK.

Supported payment methods:

  • Visa
  • Mastercard
  • American Express
  • Diners Club
  • PayPal
  • Apple Pay

Supported features:

  • Tokenisation of payment credentials
  • Store payment methods for future use
  • 3-D Secure
  • Scan card using mobile device camera
  • Compatible with Objective-C and Swift