Funsol Billing Helper is a simple, straight-forward implementation of the Android v7.0 In-app billing API
Support both IN-App and Subscriptions.
No extra dependencies required
Add maven repository in project level build.gradle or in latest project setting.gradle file
repositories {
google()
mavenCentral()
maven { url "https://jitpack.io" }
}
Add Funsol Billing Helper dependencies in App level build.gradle.
dependencies {
implementation 'com.github.Funsol-Projects:Funsol-Billing-Helper:v1.0.9'
}
Finally initialise Billing class and setup Subscription Ids
FunSolBillingHelper(this)
.setSubKeys(mutableListOf("Subs Key", "Subs Key 2"))
.initialize()
if both subscription and In-App
FunSolBillingHelper(this)
.setSubKeys(mutableListOf("Subs Key", "Subs Key 2"))
.setInAppKeys(mutableListOf("In-App Key"))
.initialize()
if consumable in-App
FunSolBillingHelper(this)
.setInAppKeys(mutableListOf("In-App Key, In-App consumable Key"))
.setConsumableKeys(mutableListOf("In-App consumable Key"))
.initialize()
Note: you have add consumable key in both func setInAppKeys() and setConsumableKeys()
Call this in first stable activity or in App class
FunSolBillingHelper(this)
.setSubKeys(mutableListOf("Subs Key", "Subs Key 2"))
.setInAppKeys(mutableListOf("In-App Key"))
.enableLogging().setBillingClientListener(object : BillingClientListener {
override fun onPurchasesUpdated() {
Log.i("billing", "onPurchasesUpdated: called when user latest premium status fetched ")
}
override fun onClientReady() {
Log.i("billing", "onClientReady: Called when client ready after fetch products details and active product against user")
}
override fun onClientInitError() {
Log.i("billing", "onClientInitError: Called when client fail to init")
}
})
.initialize()
FunSolBillingHelper(this)
.setSubKeys(mutableListOf("Subs Key", "Subs Key 2"))
.setInAppKeys(mutableListOf("In-App Key"))
.enableLogging(isEnableLog = true)
.initialize()
Subscribe to a Subscription
FunSolBillingHelper(this).buyInApp(activity,"In-App Key",false)fasle value used for isPersonalizedOffer attribute:
If your app can be distributed to users in the European Union, use the isPersonalizedOffer value true to disclose to users that an item's price was personalized using automated decision-making.
Note: it auto acknowledge the In-App and give callback when product acknowledged successfully.
Subscribe to a Subscription
FunSolBillingHelper(this).subscribe(activity, "Base Plan ID")Subscribe to a offer
FunSolBillingHelper(this).subscribe(activity, "Base Plan ID","Offer ID")Note: it auto acknowledge the subscription and give callback when product acknowledged successfully.
FunSolBillingHelper(this).upgradeOrDowngradeSubscription(this, "New Base Plan ID", "New Offer Id (If offer )", "Old Base Plan ID", ProrationMode)
ProrationMode is a setting in subscription billing systems that determines how proration is calculated when changes are made to a subscription plan. There are different proration modes, including:
1. DEFERRED
Replacement takes effect when the old plan expires, and the new price will be charged at the same time.
2. IMMEDIATE_AND_CHARGE_FULL_PRICE
Replacement takes effect immediately, and the user is charged full price of new plan and is given a full billing cycle of subscription, plus remaining prorated time from the old plan.
3. IMMEDIATE_AND_CHARGE_PRORATED_PRICE
Replacement takes effect immediately, and the billing cycle remains the same.
4. IMMEDIATE_WITHOUT_PRORATION
Replacement takes effect immediately, and the new price will be charged on next recurrence time.
5. IMMEDIATE_WITH_TIME_PRORATION
Replacement takes effect immediately, and the remaining time will be prorated and credited to the user.
6. UNKNOWN_SUBSCRIPTION_UPGRADE_DOWNGRADE_POLICY
Example :
FunSolBillingHelper(this).upgradeOrDowngradeSubscription(this, "New Base Plan ID", "New Offer Id (If offer )", "Old Base Plan ID", BillingFlowParams.ProrationMode.IMMEDIATE_AND_CHARGE_FULL_PRICE)Interface implementation to handle purchase results and errors.
FunSolBillingHelper(this).setBillingEventListener(object : BillingEventListener {
override fun onProductsPurchased(purchases: List<Purchase?>) {
//call back when purchase occured
}
override fun onPurchaseAcknowledged(purchase: Purchase) {
//call back when purchase occur and acknowledged
}
override fun onPurchaseConsumed(purchase: Purchase) {
//call back when purchase occur and consumed
}
override fun onBillingError(error: ErrorType) {
when (error) {
ErrorType.CLIENT_NOT_READY -> {
}
ErrorType.CLIENT_DISCONNECTED -> {
}
ErrorType.PRODUCT_NOT_EXIST -> {
}
ErrorType.BILLING_ERROR -> {
}
ErrorType.USER_CANCELED -> {
}
ErrorType.SERVICE_UNAVAILABLE -> {
}
ErrorType.BILLING_UNAVAILABLE -> {
}
ErrorType.ITEM_UNAVAILABLE -> {
}
ErrorType.DEVELOPER_ERROR -> {
}
ErrorType.ERROR -> {
}
ErrorType.ITEM_ALREADY_OWNED -> {
}
ErrorType.ITEM_NOT_OWNED -> {
}
ErrorType.SERVICE_DISCONNECTED -> {
}
ErrorType.ACKNOWLEDGE_ERROR -> {
}
ErrorType.ACKNOWLEDGE_WARNING -> {
}
ErrorType.OLD_PURCHASE_TOKEN_NOT_FOUND -> {
}
ErrorType.CONSUME_ERROR -> {
}
else -> {
}
}
}
})
Get all products prices list include both In-App and Subs
FunSolBillingHelper(this).getAllProductPrices()Get In-App Product price
FunSolBillingHelper(this).getProductPriceByKey("In-App Key").priceGet specific subscription price (without offer)
FunSolBillingHelper(this).getProductPriceByKey("Base Plan ID","").priceGet specific subscription price (with offer)
FunSolBillingHelper(this).getProductPriceByKey("Base Plan ID","Offer ID").priceThis method return ProductPriceInfo object that contain complete detail about subscription. To get only price just call .Price.
For In-App Product
FunSolBillingHelper(this).getProductDetail("In-App Key","",BillingClient.ProductType.INAPP)For Subs Product
FunSolBillingHelper(this).getProductDetail("Base Plan ID","Offer ID",BillingClient.ProductType.SUBS)Above methods return ProductPriceInfo object that contain complete detail about Product.
For check if user buy any In-App Product
FunSolBillingHelper(this).isInAppPremiumUser()
For check specific In-App Product
FunSolBillingHelper(this).isInAppPremiumUserByInAppKey("In-App Key")
For check if any subscription is subscribe
FunSolBillingHelper(this).isSubsPremiumUser()
For check if any specific subscription is subscribe (by Base Plan ID)
FunSolBillingHelper(this).isSubsPremiumUserByBasePlanKey("Base Plan ID")
For check if any specific subscription is subscribe (by Subscription ID)
FunSolBillingHelper(this).isSubsPremiumUserBySubIDKey("Subscription ID")
FunSolBillingHelper(this).unsubscribe(this,"Subscription ID")to check and handle pending purchase call this below method on activity OnResume() method.
FunSolBillingHelper(this).fetchActivePurchases()Note: Call this method in background thread. Use Coroutine to run this method in background.
FunSolBillingHelper(this).areSubscriptionsSupported()
FunSolBillingHelper(this).isClientReady()
Call this method when app close or when billing not needed any more.
FunSolBillingHelper(this).release()
This Method used for Releasing the client object and save from memory leaks
- 14-06-2023
- Billing lib 6.0.0 updated
- Implemented consumable one-time products
- Billing Client Ready/Error Callbacks Added
- Set Logging for Release or Debug (By default only logs on debug mode)
- Now initialize billing lib in App class (if you want)
- Billing client ready check issue solved
- 13-06-2024
- Billing library updated to 7.0.0
- Threading consumption improved
- Billing client ready call back issue resolved
- Products price fetching issues resolved
- onPurchasesUpdated callback added to fetch updated premium status
- Proper logging implemented
- Price fetch missing related issues solved
- 02-07-2024
- Must Call .initialize() after initial setup (Read documentation again for clarity)
- ProductList empty crash resolved
- 12-09-2024
- Micro Price variable added in product price info
- price currency code added
- Bugs solved
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.