In-app-purchase-kmp
1.0.43indexedFacilitates in-app purchases, offering features for product management, purchase handling, and transaction validation with a streamlined API for easy integration.
11
Stars
—
Used by
dependents
—
Health
/ 100
In App Purchase Kmp Library
A Kotlin Multiplatform library that provides unified in-app purchase functionality for Android and iOS platforms. This library abstracts Google Play Billing (Android) and StoreKit 2 (iOS) into a single, easy-to-use API.
Features
- Cross-platform in-app purchase support for Android and iOS
- Google Play Billing v6 integration for Android
- StoreKit 2 support for iOS
- Suspend function support for async operations
- Flow-based purchase updates
- Product querying and purchase management
- Purchase acknowledgment and consumption
- Purchase restoration support
- Dependency injection ready (Koin integration included)
Installation
Add the following dependency to your
implementation("io.github.aditya-gupta99:inAppPurchase-kmp:1.0.12")
Setup
Dependency Injection Configuration
Create IAPManager object to inject into activity.
Common Payment Module:
val PaymentModule = module {
singleOf(::IAPManager)
singleOf(::InAppPurchaseProvider)
}
Android Setup
For Android, you need to provide both context and activity to the IAPManager. Set this up in your main activity:
class MainActivity : ComponentActivity() {
private val iapManager: IAPManager by inject()
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
iapManager.setContext(context = this, activity = this)
setContent {
MainApp()
}
}
}
Usage
Basic Implementation
(
inAppPurchaseManager: IAPManager
) : PaymentProvider {
{
inAppPurchaseManager.initialize()
}
{
getProductState = inAppPurchaseManager.getProducts(
listOf()
)
(getProductState) {
IAPResult.Error -> {
}
IAPResult.Success -> {
getProductState..getOrNull()?.let { product ->
inAppPurchaseManager.launchPurchaseFlow(product)
}
}
}
}
}
Detailed API Usage
The following sections provide detailed examples of how to use each method from the IAPManager class that you saw in the basic implementation above.
Initialize the Library
val result = iapManager.initialize()
when (result) {
is IAPResult.Success -> {
// Library initialized successfully
}
is IAPResult.Error -> {
// Handle initialization error
}
}
Query Available Products
val productsResult = iapManager.getProducts(listOf("product_id_1", "product_id_2"))
when (productsResult) {
is IAPResult.Success -> {
val products = productsResult.data
// Display products to user
}
is IAPResult.Error -> {
// Handle error
}
}
Launch Purchase Flow
val purchaseResult = iapManager.launchPurchaseFlow(selectedProduct)
when (purchaseResult) {
is IAPResult.Success -> {
// Purchase flow launched successfully
}
is IAPResult.Error -> {
// Handle error
}
}
Monitor Purchase Updates
iapManager.getPurchaseUpdates().collect { purchase ->
// Handle new purchase
// Verify purchase on your server
// Acknowledge or consume the purchase
}
Acknowledge Purchase
For non-consumable products:
val acknowledgeResult = iapManager.acknowledgePurchase(purchase)
when (acknowledgeResult) {
is IAPResult.Success -> {
// Purchase acknowledged
}
is IAPResult.Error -> {
// Handle error
}
}
Consume Purchase
For consumable products:
val consumeResult = iapManager.consumePurchase(purchase)
when (consumeResult) {
is IAPResult.Success -> {
// Purchase consumed, user can buy again
}
is IAPResult.Error -> {
// Handle error
}
}
Get Existing Purchases
val purchasesResult = iapManager.getPurchases()
when (purchasesResult) {
is IAPResult.Success -> {
val purchases = purchasesResult.data
// Process existing purchases
}
is IAPResult.Error -> {
// Handle error
}
}
Restore Purchases
val restoreResult = iapManager.restorePurchases()
when (restoreResult) {
is IAPResult.Success -> {
val restoredPurchases = restoreResult.data
// Handle restored purchases
}
is IAPResult.Error -> {
// Handle error
}
}
📐 Interface Overview
The IAPManager is the core interface of the library that provides all necessary functions to handle in-app purchases in a cross-platform manner.
⚠️ Each method returns an
IAPResult, which can be eitherSuccessorError, making it safe and predictable to handle results.
🙋♂️ Support
Need help with integration or found an issue?
- 📘 Documentation: Refer to the usage and API sections above for examples.
- 🐞 Bug Reports: Submit an issue on GitHub with as much detail as possible.
- 💡 Feature Requests: Have an idea to improve the library? We’re open to suggestions—feel free to open a discussion or issue.
If you're using this in a commercial project and need priority support, feel free to reach out via GitHub or email.