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)
    is PaywallResult.WinbackAccepted -> unlockProFeatures()
  }
}
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.

Ship Android billing in one afternoon

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

Start free