- Table of contents
- PostFinance Checkout Android Payment SDK
- PostFinance Checkout Android SDK — Migration Guide v2.0.0
| Version | |
|---|---|
| Kotlin | 2.1.20 |
| Android Gradle Plugin (AGP) | 8.7.0 |
Latest version: 2.0.0 — Maven Central
Add the dependency to your build.gradle.kts:
implementation("ch.postfinance:postfinance-checkout-sdk:2.0.0")Version 2.0.0 brings a complete architectural overhaul of the SDK. The public API and component behavior remain unchanged — the only breaking change is the entry class rename.
The architecture has also been updated to comply with the Android 16KB page size alignment requirement, ensuring compatibility with devices running on 16KB memory page sizes as required by Google. For more details, see the official Android documentation.
Still seeing 16KB alignment issues in your app? The problem may be caused by other libraries or an outdated build toolchain in your project. We recommend upgrading to AGP 8.7.0 or higher and updating your other dependencies to their latest versions.
The main entry class has been renamed:
| v1.x | v2.0.0 |
|---|---|
PostFinanceCheckoutSdk |
PostFinanceCheckout |
Update your import and all references accordingly.
// Before
import ch.postfinance.PostFinanceCheckoutSdk
// After
import ch.postfinance.PostFinanceCheckoutPostFinanceCheckout.init(...)
...
PostFinanceCheckout.instance?.launch(...)No logic or API changes — only find & replace PostFinanceCheckoutSdk → PostFinanceCheckout across your codebase.