Demo App: Build & Run (Android)
The Android 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 from Google Play
The fastest way to try the SDK. No account, server setup, or SDK access required.
- Install the demo app from Google Play:
→ payabl. Mobile SDK Demo - 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-android-demo repository — see the SDK Access Guide. One access request covers both the SDK and demo repositories.
- Your GitHub credentials configured for Gradle (the demo resolves the SDK from GitHub Packages, same as a real integration). The exact setup is documented in the demo repository README.
Steps
- Clone the repository:
git clone https://github.com/payabl-plugins/payablMerchant-android-demo.git - Follow the setup instructions in the demo repository README to configure your GitHub credentials for Gradle.
- Open the project in Android Studio and let Gradle sync.
- Run the app on an emulator or device (API 28+).
The demo uses a fixed payabl. demo merchant configuration and connects to the sandbox out of the box. You cannot swap in your own merchant credentials.
What the demo covers
The app demonstrates each integration pattern the SDK supports:
| Flow | What it shows |
|---|---|
| Hosted Checkout Page | All payment methods in a single integration |
| Pay by Card (standalone) | Direct card entry |
| Google Pay (standalone) | Google Pay sheet and result handling |
| Instant Bank Transfer (standalone) | Redirect / deep-link return flow |
| Result handling | Success, failure, and cancellation callbacks |
