SDK downloads
Download the Lib Lite Android AAR, MasterPassKit iOS XCFramework, and version 1.0 demo applications.
Both SDKs are distributed as direct downloads. Public registry distribution (Maven Central / CocoaPods / Swift Package Manager) isn't on the roadmap — direct download is the canonical distribution path.
Android — Lib Lite AAR
Download the latest AAR — liblite-masterpass-release-V1.4.72.aar
| Item | Detail |
|---|---|
| Package | liblite-masterpass-release-V1.4.72.aar |
| Minimum SDK | Android API 21 (Lollipop, 5.0) |
| Target SDK | Android API 34 (Android 14) — recommended |
| Distribution | Direct download from s3.eu-central-1.amazonaws.com/com.oltio.software/liblite/ |
| Latest version | 1.4.72 — see Android release notes |
Required dependencies (declare in your build.gradle):
implementation 'com.googlecode.libphonenumber:libphonenumber:8.10.2'
implementation 'com.google.android.gms:play-services-auth:16.0.1'
implementation 'com.google.android.gms:play-services-auth-api-phone:16.0.0'Install steps walked through in Android — Installation.
iOS — MasterPassKit XCFramework
Download the latest framework — MasterpassKit_1.44_build_132.zip
| Item | Detail |
|---|---|
| Package | MasterpassKit_1.44_build_132.zip containing MasterPassKit.xcframework |
| Minimum iOS | iOS 12 |
| Recommended | iOS 14+ |
| Distribution | Direct download from s3.eu-central-1.amazonaws.com/com.oltio.software/liblite/ |
| Latest version | 1.44 build 132 — see the iOS release notes |
Required Info.plist keys:
<key>NSLocationWhenInUseUsageDescription</key>
<string>Your location will be used to prevent fraud</string>
<key>NSCameraUsageDescription</key>
<string>Used to scan QR codes during card registration</string>Install steps walked through in iOS — Installation.
Verifying you have the latest version
The version number is printed on first launch in the SDK's debug log. Match it against the Android release notes or iOS release notes to confirm you're current.
Re-check the download URLs on this page periodically for a new AAR version (Android) or XCFramework package (iOS). For security patches we'll notify your tech lead directly. Minor releases ship every 3-4 months; major releases every 18-24 months with a migration guide and 6-month overlap.
Versioning policy
| Release type | Cadence | Migration support |
|---|---|---|
| Patch (1.2.x) | As needed | No code changes required |
| Minor (1.x) | Every 3-4 months | Drop-in replacement; check release notes |
| Major (x) | Every 18-24 months | Migration guide + 6-month overlap |
| Security | Out of band | Notification + recommended upgrade window |
You're expected to be on a supported version. Security patches and major versions have upgrade obligations defined in your integration agreement.
Demo applications
Use the version 1.0 demo applications to validate your setup before adapting the SDK integration for your own app. Each demo includes Test and Live environment selection, input validation, diagnostic logging that masks the Lib Lite token, and SDK result handling.
| Platform | Included SDK | Demo source |
|---|---|---|
| Android | Lib Lite V1.4.72 | View the Android demo |
| iOS | MasterPassKit 1.44 build 131 | View the iOS demo |
Download: both demo applications as a ZIP
The demos do not contain credentials. Use a transaction code and Lib Lite token created for the same selected environment.
What's next
- Install on Android → Android — Installation
- Install on iOS → iOS — Installation
- Run a reference integration → Lib Lite demo applications
- First payment → Android — Payments or iOS — Payments
- Generate the API token your SDK needs → Portal API → Lib Lite tokens
- Support → [email protected]
Updated 2 days ago