Android SDK

The payabl. Android SDK provides a Hosted Checkout Page that includes Google 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:

1. SDK access — your GitHub account has access to the payablMerchant-android repository.
2. Server setup — your backend can call /mobile/init and provide session_id and ephemeral_key to your app.

System requirements

Installation

The SDK is distributed as a GitHub Packages dependency, added to your project through Gradle. Full, always-current installation instructions — repository setup, authentication, and the latest dependency version — are maintained in the repository README:

→ payablMerchant-android — Installation

Manifest configuration

Sentry

If your app uses Sentry for crash analytics, override the auto-init value to prevent a manifest merge conflict with the SDK:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools">

    <application>
        ...
        <meta-data
            android:name="io.sentry.auto-init"
            android:value="false"
            tools:replace="android:value" />
    </application>
</manifest>

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)
• Google Pay
• Instant Bank Transfer

When something goes wrong, see Error Handling & Troubleshooting.