iOS SDK
The payabl. iOS SDK provides a Hosted Payment Page that includes Apple Pay, Instant Bank Transfer, and Pay by Card, plus standalone integrations of each payment method if you need finer control.
Every payment method uses the same PBLConfiguration and PBLPaymentResult types, so switching between or combining methods requires minimal code changes.
New to the payabl. Mobile SDK? Start with the Quick Start for an overview of how the SDK works and the full integration path.
Before you start
Make sure you have completed:
- SDK access — your GitHub account has access to the payablMerchant-iOS repository.
- Server setup — your backend can call
/mobile/initand providesession_idandephemeral_keyto your app.
Want to see the SDK in action first? Run the demo app — it works against the sandbox with a pre-configured demo merchant, no server setup required.
System requirements
| Minimum OS | iOS 17.6 or higher |
| Language | Swift, with SwiftUI support |
Installation
The SDK is distributed as a Swift Package from the private GitHub repository, added to your project through Xcode or your Package.swift. Full, always-current installation instructions — package setup, authentication, and the latest version — are maintained in the repository README:
→ payablMerchant-iOS — Installation
Resolving the package requires access to the payablMerchant-iOS repository and GitHub credentials configured in Xcode (or Git). If you don't have repository access yet, follow the SDK Access Guide.
Integrate a payment method
With the SDK installed, continue with the integration that fits your needs:
- Hosted Payment Page — one integration, all payment methods. Recommended starting point.
- Pay by Card (Standalone)
- Apple Pay
- Instant Bank Transfer
When something goes wrong, see Error Handling & Troubleshooting.
Updated 17 days ago