Framework guide

Tierux Android SDK

Native Kotlin SDK for Android. Add a Maven repo, drop in a dependency, and call showPaywall() — server-side verification, remote config, one API call.

1

Add the Tierux Maven repository

Add the self-hosted Maven repo to your settings.gradle.kts.

// settings.gradle.kts
dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
    maven { url = uri("https://maven-tierux.web.app") }
  }
}
2

Add the dependency

Add the Tierux SDK to your app module's build.gradle.kts.

// app/build.gradle.kts
dependencies {
  implementation("com.tierux:android-sdk:0.2.0")
}
3

Initialize the SDK

Call Tierux.init() once — typically in your Application class. The public app_xxx ID comes from create_project or your Tierux dashboard.

// MyApplication.kt
class MyApplication : Application() {
  override fun onCreate() {
    super.onCreate()
    Tierux.init(this, appId = "app_xxx", baseUrl = "https://tierux.com/")
  }
}
4

Show a paywall

Call showPaywall() from any Activity. The SDK handles BillingClient setup, purchase flow, and server-side verification.

// In your Activity or Fragment
Tierux.showPaywall(activity = this, paywallId = "pro") { result ->
  when (result) {
    is PaywallResult.Purchased -> if (result.active) unlockProFeatures()
    PaywallResult.Cancelled -> Unit
    is PaywallResult.Error -> showError(result.error)
    else -> Unit
  }
}
5

Check entitlement state

For client-side checks, the SDK caches the last verified state.

// Client-side check (suspend — call from a coroutine)
lifecycleScope.launch {
  val isPro = Tierux.isEntitled(userId = firebaseUid, entitlementId = "pro")
}
Related guides

Server-side entitlements

Gate features from your backend — Tierux normalizes purchase state into entitlement status.

MCP setup

Let your AI agent configure Google Play products and entitlements before you integrate the SDK.

Quickstart docs

Full integration path — from project creation to verified purchase in minutes.

Frequently asked questions

How do I add the Tierux Android SDK to my project?
Add the Tierux Maven repository to your settings.gradle.kts, then add the dependency in app/build.gradle.kts. The SDK is distributed via a self-hosted Maven repo at maven-tierux.web.app — no JitPack or third-party hosting required.
Does the Android SDK support Jetpack Compose?
Yes — Tierux.showPaywall() works in both Compose and View-based Activities. The paywall is rendered natively and fetches its config server-side at runtime, so layout and copy can be updated without an app release.
Where does purchase verification happen with the Android SDK?
Verification is server-side — the SDK sends the purchase token to Tierux's servers, which verify with the Google Play Developer API. Your API key is never in the client binary. The SDK returns normalized entitlement state: active, expired, or in grace period.

Ship Android billing in one afternoon

Free tier — unlimited apps, 1 paywall. No credit card, no revenue share.

Start free