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.

  1. Install the demo app from Google Play:
    payabl. Mobile SDK Demo
  2. Open the app and try any payment method using the sandbox test data.
📱

Requires Android 9.0 (API 28) or higher.

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

  1. Clone the repository:
    git clone https://github.com/payabl-plugins/payablMerchant-android-demo.git
  2. Follow the setup instructions in the demo repository README to configure your GitHub credentials for Gradle.
  3. Open the project in Android Studio and let Gradle sync.
  4. 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:

FlowWhat it shows
Hosted Checkout PageAll 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 handlingSuccess, failure, and cancellation callbacks