Demo App: Build & Run (iOS)

The iOS demo app is a fully functional reference implementation of the payabl. Mobile SDK. It runs against the payabl. sandbox using a pre-configured demo merchant, so you can see every payment method working — and read the source that drives them — without setting up your own account or server.

Use it to:

• See the SDK in action before you integrate — install the pre-built app and run real sandbox payments.
• Learn the integration patterns — the source shows how each payment method is configured and how results are handled, with inline comments.

Option 1: Install via TestFlight

The fastest way to try the SDK. No account, server setup, or SDK access required.

1. Install the demo app via TestFlight:
   → payabl. Mobile SDK Demo
2. Open the app and try any payment method using the sandbox test data.

Option 2: Build from source

Explore and modify the reference implementation.

Prerequisites

• Access to the payablMerchant-iOS-demo repository — see the SDK Access Guide. One access request covers both the SDK and demo repositories.
• Your GitHub credentials configured in Xcode (the demo resolves the SDK from the private GitHub repository, same as a real integration). The exact setup is documented in the demo repository README.

Steps

1. Clone the repository:

   git clone https://github.com/payabl-plugins/payablMerchant-iOS-demo.git

2. Follow the setup instructions in the demo repository README to configure your GitHub credentials so Xcode can resolve the SDK package.
3. Open the project in Xcode and let package resolution finish.
4. Run the app on the Simulator or a device (iOS 17.6+).

What the demo covers

The app demonstrates each integration pattern the SDK supports: