Question 1

What is B4X Purchase Manager?

Accepted Answer

B4X Purchase Manager (BPM) is a hosted monetization platform for B4A and B4i developers. It provides server-side purchase validation, subscription management, built-in purchase screens, restore flows, and analytics through a single B4X library (b4xlib).

Question 2

What is server-side purchase validation?

Accepted Answer

Server-side validation means purchase receipts from Google Play or Apple are verified on a secure server rather than on the device. This prevents tampering and piracy because the validation logic and store credentials never exist in your app code.

Question 3

Does BPM support subscriptions?

Accepted Answer

Yes. BPM fully supports auto-renewing subscriptions on both Android (Google Play Billing) and iOS (Apple StoreKit). The library monitors subscription status, handles renewals, and provides built-in subscription screens.

Question 4

Does BPM work with both B4A and B4i?

Accepted Answer

Yes. The same b4xlib and the same code works on both B4A (Android) and B4i (iOS). You manage all your apps from a single dashboard.

Question 5

Does BPM store my Apple or Google secrets?

Accepted Answer

Your store credentials (Apple Shared Secret and Google Play service account) are stored securely on BPM servers and used only for receipt validation. They never appear in your app code or on the device.

Question 6

How does pricing work?

Accepted Answer

BPM uses credit-based pricing where 1 credit equals 1 validation request. Non-purchasing users cost nothing — only users who have actually bought something generate validation calls. The free tier includes 500 credits/month (enough for around 33 paying users), and paid plans start at just $5/month. The cost of validation is typically less than 1% of what your paying users generate in revenue.

Question 7

Can I use BPM for multiple apps?

Accepted Answer

Yes. You can register and manage multiple apps from a single BPM account and dashboard. Each app gets its own API key and credentials.

Method	Parameters	Returns	Description
Initialize	Parent, BillingKey, AppId, ApiKey	—	Initialize the library. BillingKey is your Google Play license key (ignored on iOS). AppId is your app identifier from the BPM dashboard (not your package name). ApiKey is required (starts with "bpm_").
IsInitialized	—	Boolean	Returns True if Initialize has been called successfully.

Property	Type	Default	Description
DisplayAppName	String	""	Overrides the app name on purchase/subscription screens. Defaults to the app's own name if empty.
DisplayTagline	String	"Unlock the Full Experience"	Tagline displayed below the app name.
DarkMode	Boolean	False	Set to True for dark theme on all screens and overlays.

Property	Type	Default	Description
PolicyCompanyName	String	""	Company name for privacy policy and terms templates. Recommended for subscriptions.
PolicyEmailAddress	String	""	Contact email for privacy policy and terms templates.
PolicyEffectiveDate	String	""	Effective date for legal documents (e.g., "January 1, 2025"). Defaults to today.
CustomPrivacyPolicyInapp	String	""	Custom privacy policy for in-app purchases. URL or raw HTML. Empty = built-in template.
CustomPrivacyPolicySubscription	String	""	Custom privacy policy for subscriptions. URL or raw HTML. Empty = built-in template.
CustomTermsOfService	String	""	Custom terms of service. URL or raw HTML. Empty = built-in template.

Property	Type	Default	Description
DebugValidation	Boolean	False	Uses faster revalidation intervals (minutes instead of hours) for development. Ignored in release builds.
AdvancedDebugMode	Boolean	False	Verbose on-device product-fetch diagnostics for "products not showing" — logs the product IDs requested and what the store returned (id, price, title, description), plus a platform-specific checklist. Talks directly to the store (no backend, no credits). Leave off for production.
AutoInappValidation	Boolean	False	In-app purchases re-validate only for the first 21 days (the refund window) by default, then automatic checks stop — you re-validate on demand with ValidateNow. Set True to keep auto-validating every 14 days instead. Subscriptions are unaffected.

Method	Parameters	Returns	Description
AddProduct	ProductId, Title, Description	—	Add a non-consumable product for in-app purchase.
AddConsumableProduct	ProductId, Title, Description, Quantity	—	Add a consumable product. Quantity defines how many consumables are automatically awarded per purchase.
ClearProducts	—	—	Remove all configured products.
AddSubscription	ProductId, BasePlanId, Title, Description, BillingPeriod	—	Add a subscription. BasePlanId must match Google Play Console (ignored on iOS).
ClearSubscriptions	—	—	Remove all configured subscriptions.

Method	Parameters	Returns	Description
SetThemeColors	Primary As Int, Secondary As Int, Accent As Int, Background1 As Int, Background2 As Int	—	Set theme colors for purchase/subscription screens. Pass 0 for any color to use defaults. Accepts 0xFFRRGGBB hex literals, xui.Color_RGB(), Colors.Red, etc.
AddFeature	Emoji, Title, Description	—	Add a feature card to purchase/subscription screens.
ClearFeatures	—	—	Remove all configured features.

Method	Parameters	Returns	Description
ShowInAppPurchase	—	Boolean	Show the in-app purchase screen. Returns True if purchase was successful.
ShowSubscriptionPurchase	—	Boolean	Show the subscription screen. Returns True if subscription was successful.
PurchaseProduct	ProductId	Boolean	Purchase a product directly without showing the purchase screen. For custom UI.
PurchaseSubscription	ProductId, BasePlanId	Boolean	Purchase a subscription directly without showing the subscription screen. For custom UI.
RestorePurchases	—	Boolean	Restore previous in-app purchases from the store.
RestoreSubscriptions	—	Boolean	Restore previous subscriptions from the store.
HidePurchaseScreen	—	—	Programmatically close any active purchase/subscription screen.

Method	Parameters	Returns	Description
CheckStatus	—	—	Load cached status and trigger background validation if cache is expired. Instant, non-blocking. Call on page appear.
ValidateNow	—	Boolean	Force immediate live validation (bypasses cache). Costs 1 credit per configured type.
IsUnlocked	—	Boolean	True if user owns a non-consumable product (cached, instant).
IsSubscriptionActive	—	Boolean	True if user has a valid subscription (cached, instant).
GetActiveSubscriptionId	—	String	Active subscription product ID, or "" if none.
GetSubscriptionExpiryDate	—	Long	Subscription expiry date in ticks, or 0 if not available.
IsActive	—	Boolean	True if a purchase/subscription screen is currently showing.
ValidationInProgress	—	Boolean	True if a live backend validation is currently running.

Method	Parameters	Returns	Description
GetConsumableCount	—	Int	Current consumable count (locally tracked on-device only — consider syncing with your own server for cross-device support).
AddConsumables	Count	—	Add consumables after a successful purchase.
SetConsumableCount	Count	—	Set consumable count directly. Use on app launch to sync local count with your server's authoritative count.
UseConsumables	Count	Boolean	Deduct consumables. Returns True if enough available, False otherwise.

Method	Parameters	Returns	Description
ShowPrivacyPolicy	—	—	Show privacy policy in a full-screen overlay. Uses custom content if set, otherwise built-in template.
ShowTermsOfService	—	—	Show terms of service in a full-screen overlay. Uses custom content if set, otherwise built-in template.

Method	Parameters	Returns	Description
ExportPrivacyPolicyInapp	—	Boolean	Export rendered privacy policy (in-app). Logs HTML to IDE log and saves as bpm-privacy-policy-inapp.html.
ExportPrivacyPolicySubscription	—	Boolean	Export rendered privacy policy (subscription). Logs HTML to IDE log and saves as bpm-privacy-policy-subscription.html.
ExportTermsOfService	—	Boolean	Export rendered terms of service. Logs HTML to IDE log and saves as bpm-terms-of-service.html.

Method	Parameters	Returns	Description
ResetPurchaseForTesting	ProductId	Boolean	Android: consumes purchase token. iOS: clears local cache.
ResetSubscriptionForTesting	ProductId	Boolean	Android: consumes subscription token. iOS: not supported (returns False).

b4xlib API Reference