Billy the android

Our goal is to make a modern api of BillingClient so that it is easier to use in compose world. This library is still early beta and APIs for usages will be changes!

How to include in your project

The library is available via MavenCentral:

allprojects {
    repositories {
        // ...
        mavenCentral()
    }
}

Snapshots of the development version are available in Sonatype's snapshots repository.

allprojects {
    repositories {
        // ...
        maven {
            url 'https://oss.sonatype.org/content/repositories/snapshots/'
        }
    }
}

Add it to your module dependencies:

dependencies {
    implementation("se.warting.billy:flow:<latest_version>")
}

How to use

Individual Product Status

All you need to do is to call collect the state of an Product and then call buy() when it is ready:

val earlyBirdProduct = Product.Subscription("early_bird")
val earlyBirdProductStatus by earlyBirdProduct.statusFlow.collectAsState(
    initial = ProductStatus.Loading(earlyBirdProduct)
)

when (val earlyBirdProduct = earlyBirdProductStatus) {
    is ProductStatus.Available -> {
        Text("Available to buy!")
        Button(onClick = {
            // Launch buy flow
            earlyBirdProduct.buy(offer)
        }) {
            Text(text = "buy")
        }
    }
    is ProductStatus.Loading -> Text("Loading....")
    is ProductStatus.Unavailable -> Text("Unavailable")
    is ProductStatus.Owned -> Text("Owned")
}

Discover All Available Products

You can now discover all available products without knowing their IDs beforehand:

// First, configure which product IDs you want to discover
LaunchedEffect(Unit) {
    BillingProvider.instance.configureSubscriptionProducts(
        listOf("premium_monthly", "premium_yearly", "early_bird")
    )
    BillingProvider.instance.configureInAppProducts(
        listOf("remove_ads", "extra_features", "unlock_content")
    )
}

// Then collect all available products
val availableSubscriptions by BillingProvider.instance.getAvailableSubscriptions()
    .collectAsState(initial = emptyList())
val availableInAppProducts by BillingProvider.instance.getAvailableInAppProducts()
    .collectAsState(initial = emptyList())

// Display all available subscriptions
LazyColumn {
    items(availableSubscriptions) { productDetails ->
        Text("Subscription: ${productDetails.name}")
        Text("Price: ${productDetails.subscriptionOfferDetails?.firstOrNull()?.pricingPhases?.pricingPhaseList?.firstOrNull()?.formattedPrice}")
    }
}

// Display all available in-app products
LazyColumn {
    items(availableInAppProducts) { productDetails ->
        Text("Product: ${productDetails.name}")
        Text("Price: ${productDetails.oneTimePurchaseOfferDetails?.formattedPrice}")
    }
}

For a full implementation see: Full sample

Test your apps products

If you want to load your own products in the sample app you can do so by adding your apps package name to local.properties file like this:

APPLICATION_ID=your.app.id

Notes

There is no need to initiate the BillingClient we are doing it for you! see: BillingInitializer