Why is my paywall not loading on Android with Billing Service Unavailable?
Fix Superwall paywalls not loading on Android with Billing Service Unavailable: set subscription status in your PurchaseController or check Google Play Billing.
Context
When implementing Superwall paywalls in Android, you may encounter issues where paywalls fail to show with the error The entitlement status failed to change from "unknown".
In order to properly evaluate your paywall presentation logic, the Superwall SDK must know the exact subscription status of the user, without it we cannot show paywalls.
Answer
If you're using a PurchaseController (advanced):
When using a PurchaseController, you become responsible for setting the subscription status in the Superwall SDK on launch, and updating during the app session. This error means that the subscription status was never updated on launch.
If you're not using a PurchaseController (default):
Android: Check that your device has access to Google Play Billing and is properly configured
- The Superwall SDK requires access to billing services to determine subscription status. When this service is unavailable, the subscription status remains "unknown," preventing paywalls from displaying.
How is this guide?
Why are my products showing 'Unknown' status in Superwall?
Fix products showing 'Unknown' status in Superwall: check the App Store Connect API setup, product IDs, app IDs, API key role, and agreements.
How to Test Paywalls with Local Currency for a Specific Country
Learn how to preview your paywall as a user in a specific country would see it, including local currency and audience matching.