IAP AI skill capabilities reference
Explore the migration and integration tasks the In-App Purchasing AI skill can perform, including what each task changes and its limitations.
Read time 8 minutesLast updated a day ago
The In-App Purchasing (IAP) AI skill supports the following tasks. The skill scans your project to determine which task applies, then follows one task path. Before you run any task, review how the skill works and how to prompt it safely in Introduction to the IAP AI skill.
Each task uses an example prompt to show how to start. Adapt the product IDs, types, and grant logic to your project. For migrations and conversions, ask the skill for a report before it changes any code.
Add IAP to a project
The skill sets up Unity IAP v5 in a project that has no purchasing logic yet, such as a project with a shop scene UI but no purchase handling. The skill installs the package and creates an class that matches your project's patterns. It implements the two-step purchase flow, connects that flow to your shop buttons, and integrates it with your save system. If your project has non-consumables or subscriptions, the skill also adds a Restore Purchases button.
IAPManagerThe following limitations apply:
- You create your products in App Store Connect and Google Play Console manually.
- Local Google Play validation requires that you run the Receipt Validation Obfuscator (Services > In-App Purchasing > Receipt Validation Obfuscator).
Use the following example prompt:
Add Unity IAP 5 to my game. Products: coins100 (Consumable) grants 100 coins toPlayerData.coins; removeads (NonConsumable) removes ads. Use my SaveManager topersist. Android and iOS. Show a plan first.
Migrate from v4 to v5
The skill migrates a project from the IAP v4 API to v5. It replaces , , and with the event-driven pattern. The skill moves your logic into and , and converts ownership checks from to .
IStoreListenerUnityPurchasing.InitializeConfigurationBuilderStoreControllerProcessPurchaseOnPurchasePendingOnPurchasesFetchedproduct.hasReceiptstore.CheckEntitlement(product)The following limitations apply:
- and
product.receiptare removed, so verify your entitlement logic after migration.product.hasReceipt - The developer payload argument is removed, which requires a backend change if you relied on it.
- Apple local validation does nothing under StoreKit 2. Move Apple validation server-side with the JWS representation ().
order.Info.Apple.jwsRepresentation
Use the following example prompt:
Migrate my IAP code from Unity IAP v4 to v5. Work on a branch and show thev4-to-v5 mapping before you edit anything.
Convert a Google Play billing integration
The skill converts Android purchases that go through a custom Java integration to Unity IAP v5. It builds a Unity IAP adapter behind a compatibility facade, so your gameplay code changes little. The skill wraps the previous calls in guards for rollback and maps the acknowledge and consume operations to a single call after the grant.
BillingClient#ifConfirmPurchaseThe following limitations apply:
- Unity IAP v5 doesn't support multiple subscription base plans or offer tokens, personalized pricing, alternative billing, or multi-quantity purchases. The skill can't convert an integration that relies on these features.
- The receipt format changes to , which requires a backend update if your server parses raw fields.
order.Info.Receipt
Warning
Don't run a custom billing integration and Unity IAP at the same time. Both contend for the same purchase callback. Use the guard to switch between them.
#ifUse the following example prompt:
My project calls Google Play BillingClient through a custom Java integration.Convert it to Unity IAP 5. Provide the migration report and detect any blockersfirst. Keep the old code behind #if guards.
Convert an iOS StoreKit plugin
The skill replaces a custom Objective-C or Swift StoreKit plugin with Unity IAP v5, and keeps your game-facing C# purchase API stable through a facade. The skill converts the bridge to Unity IAP and adds handling for promotional purchases and Ask to Buy deferred purchases.
The following limitations apply:
- The receipt format is a breaking backend change: per-transaction JWS replaces the StoreKit 1 receipt bundle. Backends that use must move to the App Store Server API.
/verifyReceipt - Unity IAP v5 doesn't support promotional-offer signing or StoreKit 2 win-back offers. The skill can't convert a plugin that relies on these features.
- Objective-C and Swift files can't use guards, so the skill guards only the C# call sites.
#if
Use the following example prompt:
I have a custom StoreKit plugin that uses SKPaymentQueue. Replace it with UnityIAP 5 and keep my C# purchase API stable through a facade.
Convert Essential Kit billing
The skill disables VoxelBusters Essential Kit billing and replaces it with Unity IAP v5, while all other Essential Kit features keep working. The skill turns off the billing service flag in , removes the conflicting billing Gradle dependency, and implements Unity IAP v5 with the product IDs from the Essential Kit settings.
EssentialKitSettings.assetThe following limitations apply:
- Essential Kit source files aren't deleted. The skill only disables the billing flag.
- If you use server-side validation, the receipt format changes. Document the backend change.
Note
After the skill edits your project, run Assets > External Dependency Manager > Android Resolver > Force Resolve, then confirm that billing is disabled in the Essential Kit settings.
Use the following example prompt:
Disable Essential Kit billing and replace it with Unity IAP 5. Keep all otherEssential Kit features working.
Assess and convert a RevenueCat project
The skill assesses whether Unity IAP v5 can handle store purchases while your project keeps most RevenueCat features, then sets up the conversion if it's viable. The recommended result is observer mode, in which Unity IAP performs the purchase and RevenueCat continues to validate it through .
SyncPurchases()The following limitations apply:
- Unity IAP v5 doesn't support the Amazon Appstore, so the skill can't convert a project that publishes to Amazon.
- Remote Offerings and paywalls, A/B experiments, cross-platform entitlement sync, and webhook events have no Unity IAP equivalent. Keep RevenueCat for these features, or rebuild them in your project.
Note
If you omit after a purchase, RevenueCat never validates it and becomes stale. Both SDKs bundle . The skill removes RevenueCat's copy (not a project-wide exclude, which would strip Unity IAP's own billing client) and runs Force Resolve.
SyncPurchases()CustomerInfocom.android.billingclientUse the following example prompt:
My project uses RevenueCat. Assess whether Unity IAP 5 can handle store purchasesin observer mode while RevenueCat keeps validation and subscription tracking. Listwhat I'd lose, then set it up if it's viable.
Assess and convert an Adapty project
The skill assesses whether Unity IAP v5 can take over store purchases in observer mode while Adapty keeps validating and tracking purchases, then sets up the conversion if you approve. In observer mode, the skill calls after each confirmed purchase.
Adapty.ReportTransaction()The following limitations apply:
- The Adapty Paywall Builder has no Unity IAP equivalent and is also unavailable in Adapty's observer mode, so you can't convert the Paywall Builder. You must build the shop UI in Unity instead.
- A/B testing, cross-platform entitlements, and webhook events have no Unity IAP equivalent. Keep Adapty for these features, or rebuild them in your project.
Note
If you omit , Adapty doesn't validate the purchase. On Android, also call at startup to capture missed purchases.
Adapty.ReportTransaction()Adapty.RestorePurchasesUse the following example prompt:
My project uses Adapty with the Paywall Builder. Assess whether Unity IAP 5 cantake over store purchases in observer mode. Tell me exactly what I lose, then setit up if I approve.
Assess a UniPay project
The skill assesses whether a UniPay (FLOBUK) project needs to migrate. Because UniPay already wraps Unity IAP for Apple and Google, a project that publishes only to those stores usually needs no conversion. The skill confirms your Unity IAP version and whether D2C payments are available.
The following limitations apply:
- Unity IAP v5 doesn't support the Amazon Appstore. If your UniPay project publishes to Amazon, you can't carry that store forward to v5.
- UniPay's Steam, Meta Quest, PayPal, and Facebook Instant Games integrations have no Unity IAP equivalent. Keep UniPay for those stores.
- D2C payments require the IAP package version 5.4 or later. Upgrade if you're on version 5.0 to 5.3.
Note
This assessment often concludes that no action is needed, which is a valid result.
Use the following example prompt:
My project uses UniPay. Assess whether I need to migrate to Unity IAP, and whetherI can add a third-party payment provider.
Integrate D2C payment providers
The skill adds Direct-to-Consumer (D2C) payments with a third-party provider (Stripe or Coda) so players can pay through web checkout. The skill creates a separate for the payment provider, a Remote Catalog, deep-link configuration, and the built-in payment picker UI. The new controller coexists with your existing Apple and Google controller.
StoreControllerThe following limitations apply:
- Requires the IAP package version 5.4 or later, Unity Editor 2022.3 or later, Authentication 3.7.1 or later, a Unity Cloud project, and a connected Stripe or Coda account.
- Subscriptions aren't supported in D2C v5.4. Only consumables and non-consumables are.
- Web payments are permitted in select regions only, and you're responsible for compliance.
Warning
Configure a routing rule in the Unity Dashboard before you test. Without a routing rule, returns an empty list and the purchase UI never appears.
GetEligiblePaymentProviders()Use the following example prompt:
Add Unity IAP D2C payments with Stripe so players can pay through web checkout.Consumables and a Remove Ads unlock.
For the full D2C workflow, refer to Integrate D2C payment providers workflow.
Work with Codeless IAP
The skill explains how Codeless IAP works and helps you decide between Codeless and scripted setups. For projects that use Codeless IAP, the skill also edits to add products, change prices, and update descriptions, so you don't have to edit the file by hand.
Assets/Resources/IAPProductCatalog.jsonUse one of the following example prompts:
Explain how Codeless IAP works and whether I should use it instead of a scripted setup.
Add a $1.99 consumable 'gems_50' to my IAP product catalog.