In-App Billing Plugin for .NET MAUI and Windows
Project status: Android and Windows are actively maintained and track the current Google Play Billing Library and Microsoft Store APIs. iOS and Mac Catalyst use StoreKit 2, while native macOS still uses the original StoreKit APIs. Contributions are welcome, and you can always fork the library or pull the source into your project.
A simple In-App Purchase plugin for .NET MAUI and Windows to query item information, purchase items, restore items, and more.
Subscriptions are supported on iOS, Android, Mac, and Windows.
Important Version Information
- iOS and Mac Catalyst now default to StoreKit 2 and require iOS/Mac Catalyst 15+ (macOS 12+ for Catalyst). Purchase tokens and restore behavior have changed. A legacy StoreKit opt-out is available, see StoreKit 2.
- Windows now uses
Windows.Services.Store and supports WinUI 3 and Windows App SDK apps, subscriptions, and consumables. This changes some Windows behavior, see the migration notes
- v10.1 uses Android Billing v9 and requires Android API 23+ (see AndroidX versions)
- v10 now supports .NET 10+ and Android Billing v8
- v9 now supports .NET 9+ and Android Billing v7
- v8 now supports .NET 8+ .NET MAUI and Windows Apps.
- v7 now supports .NET 6+, .NET MAUI, UWP, and Xamarin/Xamarin.Forms projects
- v7 is built against Android Billing Library 6.0
- See migration guides below
Documentation
Get started by reading through the In-App Billing Plugin documentation.
NuGet
Platform Support
| Platform | Version |
|---|
| iOS for .NET | 10+ |
| macCatlyst for .NET | All |
| Android for .NET | 23+ |
| Windows App SDK (WinUI 3) | 10+ |
| .NET MAUI | All |
AndroidX versions for Android Billing v9
Android Billing v9 needs newer AndroidX libraries than .NET MAUI 10 brings in, so restoring can fail with NU1107 on Xamarin.AndroidX.Lifecycle.*. If it does, reference these from your app:
<ItemGroup Condition="$(TargetFramework.Contains('-android'))">
<PackageReference Include="Xamarin.AndroidX.Activity.Ktx" Version="1.13.0.1" />
<PackageReference Include="Xamarin.AndroidX.Collection.Ktx" Version="1.6.0.1" />
<PackageReference Include="Xamarin.AndroidX.Fragment.Ktx" Version="1.9.1" />
<PackageReference Include="Xamarin.AndroidX.Lifecycle.LiveData" Version="2.11.0.1" />
<PackageReference Include="Xamarin.AndroidX.Lifecycle.LiveData.Core.Ktx" Version="2.11.0.1" />
<PackageReference Include="Xamarin.AndroidX.Lifecycle.Process" Version="2.11.0.1" />
<PackageReference Include="Xamarin.AndroidX.Lifecycle.Runtime.Ktx" Version="2.11.0.1" />
<PackageReference Include="Xamarin.AndroidX.Lifecycle.Runtime.Ktx.Android" Version="2.11.0.1" />
<PackageReference Include="Xamarin.AndroidX.Lifecycle.ViewModel.Ktx" Version="2.11.0.1" />
<PackageReference Include="Xamarin.AndroidX.SavedState.SavedState.Ktx" Version="1.5.0.1" />
</ItemGroup>
Version 8 Major Updates
- Nice new re-write and re-implementation of APIs!
- Built against .NET 8
- Now using latest Android Billing v6.2.1
Version 7 Major Updates
- Android: You must compile and target against Android 12 or higher (or Android 13 if v7.1)
- Android: Now using Android Billing v6
- Android: Major changes to Android product details, subscriptions, and more
- Android: Please read through: https://developer.android.com/google/play/billing/migrate-gpblv6
- Android:
AcknowledgePurchaseAsync is now FinalizePurchaseAsync
- All: There are now "Extras" for all products that give you back tons of info for each platform
If you receive an error in Google Play you may need to add this to your AndroidManifest.xml inside the application node:
<meta-data
android:name="com.google.android.play.billingclient.version"
android:value="X.X.X" />
Update X.X.X with the version of the Billing Library that is a dependency on the NuGet package.
Pending Transactions:
- If the result of PurchaseAsync is PurchaseState.PaymentPending, store the order details locally and inform the user that they will have access to the product when the payment completes
- When the user starts the app (and/or visits a particular page), if the stored PurchaseState is PaymentPending, call GetPurchasesAsync and query the result for a purchase that matches the stored purchase.
- If the PurchaseState for this purchase is still PaymentPending, show the same no-access message
- If the PurchaseState is Purchased, call ConsumePurchaseAsync or AcknowledgePurchaseAsync, depending on the product type
To respond to pending transactions you can subscribe to a listener in your Android project startup:
// Connect to the service here
await CrossInAppBilling.Current.ConnectAsync();
// Check if there are pending orders, if so then subscribe
var purchases = await CrossInAppBilling.Current.GetPurchasesAsync(ItemType.InAppPurchase);
if (purchases?.Any(p => p.State == PurchaseState.PaymentPending) ?? false)
{
Plugin.InAppBilling.InAppBillingImplementation.OnAndroidPurchasesUpdated = (billingResult, purchases) =>
{
// decide what you are going to do here with purchases
// probably acknowledge
// probably disconnect
};
}
else
{
await CrossInAppBilling.Current.DisconnectAsync();
}
This is the beginning of the README. Read the rest at the original. Read the full README ↗
