Release notes

Use this page to identify the MasterPassKit package you have, understand the latest fixes, and decide what to retest when upgrading.

For the Android equivalent, see Android release notes.

Current release

Item	Detail
SDK version	1.44
Distribution build	132
Released	27 August 2026
Package	`MasterpassKit_1.44_build_132.zip`
Framework	`MasterPassKit.xcframework`
Public API	`MPMasterPass` and `MPMasterPassDelegate`
Minimum deployment target	iOS 12.1

Download MasterPassKit 1.44 build 132

Upgrade recommendation: build 132 replaces build 131 and is recommended for all MasterPassKit 1.44 integrations. The public checkout methods and required delegate methods have not changed.

Mobile-number normalization

Converts South African local mobile numbers such as 0640661743 to the international form 27640661743 before activation.
Repairs a South African trunk prefix incorrectly placed after the country code, so 270640661743 and +270640661743 are submitted as 27640661743.
Applies normalization to a host-supplied suggested mobile number and again immediately before submission.
Removes spaces and punctuation while retaining non-South-African international numbers.

Reliability and recovery fixes

Establishes the checkout network session outside the application's main thread so checkout() returns promptly.
Applies a 60-second timeout to individual SDK network requests instead of the previous 3000-second value.
Stops receipt polling after 60 seconds instead of leaving the customer on an indefinite loading screen.
Routes network and receipt-polling timeouts into the existing Retry/Cancel recovery flow.
Presents alerts from the host application's active scene and window.
Removes the blocking progress overlay before showing a connection-error alert.
Restores interaction after incorrect-OTP and connection-error alerts are dismissed.

Activation UI fixes

Aligns the country-code and mobile-number fields to the same height and vertical centre.
Renders both the country code and mobile-number input in white for consistent contrast.
Constrains the bottom gradient ribbon to the modal edges so it does not overflow.

Compatibility and validation

Includes arm64 device and arm64/x86_64 simulator slices.
Built and archived for device and simulator with Xcode 26.6.
Retry and Cancel recovery were exercised on an iOS 26.5 simulator.
No changes were made to the public checkout method or required MPMasterPassDelegate callbacks.

Build identifier: the public distribution is identified by the ZIP filename as build 132. The embedded framework metadata reports version 1.44, build 125. Include both values when submitting a support request.

Known integration notes

Scene-based applications

MasterPassKit includes a legacy progress component that reads the application delegate's window during first-time mobile-number activation. If your UIKit app uses UIScene, keep a valid AppDelegate.window bridge while the SDK is presented. The iOS demo application includes this compatibility setup.

Payment-failure callback

masterpassPaymentFailedWithTransactionReference returns the transaction reference but does not expose a structured issuer decline code. Codes such as 04 or 51 cannot currently be retrieved from this callback. Use the transaction reference for support and backend investigation.

Previous releases

Version	Released	Highlights
1.44 build 132	27 August 2026	Current release. Corrects South African mobile-number normalization during activation.
1.44 build 131	14 August 2026	Checkout recovery, 60-second timeouts, alert handling, and activation UI fixes. Superseded by build 132.
1.44 build 123	15 May 2025	Updated certificate-path handling for the Test environment. Superseded by build 131.
1.44 build 120	20 February 2025	Updated activation label and input colours. Superseded by build 123.
1.41	—	Added support for passing an amount for variable-amount codes.
1.40	—	Added 3-D Secure 2.0 support.
1.39	—	Fixed a crash when the host application also integrates Google Firebase.
1.38	—	Replaced `UIWebView` with `WKWebView`.
1.37	—	Added standalone card management and SDK deregistration.

Upgrade checklist

Download MasterpassKit_1.44_build_132.zip from SDK downloads.
Remove the previous MasterPassKit.xcframework from the Xcode project and add the new framework.
Confirm Embed & Sign is selected for the application target.
Clean the Xcode build folder and rebuild for both a simulator and a physical device destination.
Test first-time activation with 0..., 27..., and +27... mobile-number formats.
Test incorrect OTP, Retry, Cancel, and the 60-second connection-recovery path.
Test with a transaction code and Lib Lite token created for the same selected environment.
Verify successful payments on your backend before fulfilment; the SDK callback alone is not authoritative.

For a working Swift/UIKit reference integration, use the iOS demo application.

What's next

Download the current framework → SDK downloads
Install the SDK → Installation
Request a payment → Payments
Run the reference app → iOS demo application
Android version history → Android release notes