https://github.com/pranavpandey/dynamic-billing
Implement Google Play in-app products and subscriptions on Android.
https://github.com/pranavpandey/dynamic-billing
android billing in-app library payment product purchase subscription
Last synced: about 1 year ago
JSON representation
Implement Google Play in-app products and subscriptions on Android.
- Host: GitHub
- URL: https://github.com/pranavpandey/dynamic-billing
- Owner: pranavpandey
- License: apache-2.0
- Created: 2022-07-03T15:42:45.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2025-03-05T19:40:05.000Z (over 1 year ago)
- Last Synced: 2025-04-12T20:27:41.621Z (about 1 year ago)
- Topics: android, billing, in-app, library, payment, product, purchase, subscription
- Language: Java
- Homepage: https://dynamic.pranavpandey.com
- Size: 932 KB
- Stars: 10
- Watchers: 3
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Dynamic Billing
[](https://www.apache.org/licenses/LICENSE-2.0.html)
[](https://search.maven.org/artifact/com.pranavpandey.android/dynamic-billing)
**A library to implement Google Play in-app products and subscriptions on Android
4.1 (API 16) and above.**
> [!IMPORTANT]
> It uses [AndroidX][androidx] so, first [migrate][androidx-migrate] your project to AndroidX.
It is dependent on Java 8 due to the dependency on [Dynamic Utils][dynamic-utils].
Since v1.1.0, it is targeting Java 17 to provide maximum compatibility.
Since v1.2.0, the minimum SDK is Android 4.4 (API 19) to comply with the latest policies.
---
## Contents
- [Installation](#installation)
- [Usage](#usage)
- [Initialize](#initialize)
- [Listener](#listener)
- [Sponsor](#sponsor)
- [Dependency](#dependency)
- [License](#license)
---
## Installation
It can be installed by adding the following dependency to your `build.gradle` file:
```groovy
dependencies {
// For AndroidX enabled projects.
implementation 'com.pranavpandey.android:dynamic-billing:1.2.0'
}
```
---
## Usage
It provides an `interface` that can be implemented by the `application` or `activity` class to
perform various operations accordingly. It also has support to create an in-app `product`
or `subscription` that can be linked to a `feature` so that it can be enabled on-demand after
a successful purchase.
> For a complete reference, please read the [documentation][documentation].
### Initialize
`DynamicBilling` must be initialized once before accessing its methods.
> Please make sure that you have enabled [Google Play Billing][google play billing] for your app
and have in-app products or subscriptions properly setup within the console.
```java
// Initialize with application context.
DynamicBilling.initializeInstance(applicationContext);
```
### Listener
`DynamicBillingListener` is an `interface` that can be implemented by the `application` or
`activity` class to perform various operations and receive `billing` callbacks.
```java
/**
* An activity implementing the dynamic billing listener.
*/
public class BillingActivity extends Activity implements DynamicBillingListener {
...
@Override
public void onBillingServiceDisconnected() { }
@Override
public void onBillingSetupFinished(@NonNull BillingResult billingResult) {
// Try to query available products from the billing library.
DynamicBilling.getInstance().queryProductDetailsAsync(
QueryProductDetailsParams.newBuilder()
.setProductList(Arrays.asList(
QueryProductDetailsParams.Product.newBuilder()
.setProductId(Feature.ID)
.setProductType(Feature.TYPE)
.build()
)).build());
// Try to query the user purchases.
DynamicBilling.getInstance().queryPurchasesAsync(Subscription.QUERY_PURCHASES_PARAMS);
}
@Override
public void onPurchasesUpdated(@NonNull BillingResult billingResult,
@Nullable List purchases) {
// Update products state according to the user purchases.
}
@Override
public void onProductDetailsResponse(@NonNull BillingResult billingResult,
@NonNull List productDetails) {
// Show available products to the user.
}
@Override
public void onQueryPurchasesResponse(@NonNull BillingResult billingResult,
@NonNull List purchases) {
// Update products state according to the user purchases.
}
@Override
public void onConsumeResponse(@NonNull BillingResult billingResult,
@NonNull String purchaseToken) { }
@Override
public void onAcknowledgePurchaseResponse(@NonNull BillingResult billingResult) {
// Automatically acknowledge purchases if required.
DynamicBilling.getInstance().acknowledgePurchases(billingResult, purchases);
}
}
```
### Sponsor
Please become a [sponsor][sponsor] to get a detailed guide and priority support.
### Dependency
It depends on the [dynamic-utils][dynamic-utils] to perform various internal operations.
So, its functions can also be used to perform other useful operations.
---
## Author
Pranav Pandey
[](https://github.com/pranavpandey)
[](https://twitter.com/intent/follow?screen_name=pranavpandeydev)
[](https://paypal.me/pranavpandeydev)
---
## License
Copyright 2022-2024 Pranav Pandey
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
[androidx]: https://developer.android.com/jetpack/androidx
[androidx-migrate]: https://developer.android.com/jetpack/androidx/migrate
[documentation]: https://pranavpandey.github.io/dynamic-billing
[google play billing]: https://developer.android.com/google/play/billing/integrate
[sponsor]: https://github.com/sponsors/pranavpandey
[dynamic-utils]: https://github.com/pranavpandey/dynamic-utils
[dynamic-support]: https://github.com/pranavpandey/dynamic-support