PayBito Payments
Android SDK Guide

Quick Start

The PayBito Android SDK is a professional-grade fintech solution for seamless crypto and fiat payment integration. Built on a reactive architecture, it bridges native Android environments with the PayBito payment gateway.

Key Features

Installation

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)
    repositories {
        google()
        mavenCentral()
        maven { url 'https://jitpack.io' }
    }
}

dependencies {
    implementation 'com.github.arunava2804.PayBito-Payments-Android-SDK:library:v1.1.2'
}

Initialization

The SDK is a singleton and must be initialized once at the application level. This ensures that even if the app is killed and restarted, the SDK can restore the user's cart token from SharedPreferences.

Application Class Setup

Create or modify your Application class to initialize the SDK with your merchant credentials:

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()

        val config = PayBitoConfig(
            merchantId     = 26660L,
            publicKey      = "pk_your_public_key",
            brokerId       = "your_broker_id",
            origin         = "https://your-domain.com/",
            enableDebugLogs = true
        )

        PayBitoSdk.init(this, config)
    }
}

Configuration Parameters

Core API

The SDK provides a clean reactive API for managing the shopping cart and triggering checkout. All network calls and local persistence are handled automatically.

A. Add to Cart

Use PayBitoSdk.addToCart() to add products. The SDK handles all network calls and local persistence automatically.

val product = PayBitoProduct(
    productId = "P001",
    name      = "Studio Headphones",
    price     = 89.99,
    imageUrl  = "https://example.com/image.jpg"
)

lifecycleScope.launch {
    PayBitoSdk.addToCart(product)
}

B. Observe Cart State (Reactive)

Collect the cartState Flow to automatically update your UI whenever the cart changes. This is the recommended pattern for keeping badges and totals in sync.

lifecycleScope.launch {
    PayBitoSdk.cartState.collect { state ->
        // Runs automatically whenever the cart changes
        binding.tvCartCount.text  = state.count.toString()
        binding.tvTotalAmount.text = "$" + state.total
        adapter.updateItems(state.items)
    }
}

C. Update Item Quantity

For existing cart items, use updateQuantity() rather than re-adding the product:

// Increment or decrement quantity for an existing item
lifecycleScope.launch {
    PayBitoSdk.updateQuantity(productId = "P001", newQty = 3)
}

D. Open Cart UI

The SDK provides a built-in BottomSheet cart drawer that can be launched from any FragmentActivity:

PayBitoSdk.openCart(this) // Requires FragmentActivity

E. Clear Cart

Call clearCart() after a successful payment to reset the user's cart for the next session:

PayBitoSdk.clearCart()

Checkout Flow

The checkout process is initiated with a single method call. The SDK handles the complete secure payment flow, including 3D Secure verification and post-payment deep linking.

Launching Checkout

PayBitoSdk.checkout(this)

Checkout Activity Internals

Success Deep Linking

When the web-based payment completes, the gateway redirects to paybito://checkout/success. Your app captures this via an <intent-filter> in the manifest.

<activity android:name=".payment.PaymentResultActivity">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data
            android:scheme="paybito"
            android:host="checkout"
            android:pathPrefix="/success" />
    </intent-filter>
</activity>

Demo App Guide

The TechStore Demo App demonstrates best practices for building a premium e-commerce experience with the PayBito SDK using MVVM-lite architecture and reactive programming.

App Architecture

Core Implementation Steps

Key Files to Study

• com.example.paybitodemo.MainActivity — Central hub for UI logic and cart observation
• com.example.paybitodemo.ProductAdapter — Complex RecyclerView with add/update logic
• com.example.paybitodemo.payment.PaymentResultActivity — Post-checkout deep link handler

UI Design Principles

ProGuard & Security

If your app uses code obfuscation (recommended for production releases), add the following rules to your proguard-rules.pro to prevent the SDK models from being stripped or renamed.

# Keep PayBito SDK models intact
-keep class com.paybito.sdk.models.** { *; }
-dontwarn com.paybito.sdk.**

Security Best Practices

Distribution & JitPack

The SDK is distributed via JitPack.io. This section explains how the library is configured for publication and how to create new versioned releases.

Library build.gradle Configuration

For JitPack to correctly build the library, the library/build.gradle must include the maven-publish plugin:

plugins {
    id 'com.android.library'
    id 'org.jetbrains.kotlin.android'
    id 'maven-publish'
}

android {
    publishing {
        singleVariant('release') {
            withSourcesJar()
        }
    }
}

afterEvaluate {
    publishing {
        publications {
            release(MavenPublication) {
                from components.release
                groupId    = 'com.github.arunava2804.PayBito-Payments-Android-SDK'
                artifactId = 'library'
                version    = project.findProperty('version') ?: '1.1.2'
            }
        }
    }
}

Creating a New Release

FAQ & Troubleshooting

Common integration issues and their solutions.