Development purchase mode

Development purchase mode lets a debug build buy from a fake store while Voidhash processes the purchases for real. Use it to test your purchase flow, entitlement checks, and subscription lifecycle handling before you connect Google Play Console.

Everything the fake store creates is tagged as development: purchases, subscriptions, grants, and revenue events. Tagged records never appear in production customer state or revenue unless you explicitly ask for development data.

Enable it

Start in Studio. Create a product and attach its perks. Subscription products need a billing duration, because the duration controls their simulated renewal and expiry dates. You do not need to connect Google Play Console.

Then set the dev option when you configure the SDK.

val voidhash = Voidhash.configure(
    context = this,
    publishableKey = "vh_pk_...",
    options = VoidhashOptions(dev = BuildConfig.DEBUG),
)

With the option on, a purchase shows a confirmation sheet instead of the Google Play sheet. The SDK waits briefly to simulate processing. Once the backend accepts the purchase, the SDK refreshes the person snapshot, so your entitlement checks see the new grant.

The option is only honored in a debug build. Release builds always use the real Play Billing adapter. Set dev = false if you want a debug build to use the real store.

Development purchases start from purchase(...) or a paywall like any other purchase, so they need the default owner mode. In observer mode they fail with READ_ONLY_PURCHASE_NOT_ALLOWED.

Fixed test prices

Development purchases use fixed USD prices, so you do not need store pricing to test.

Legacy subscriptions without a duration are simulated as monthly and return a warning.

Simulate lifecycle events

Open a person in Studio to move a development subscription through its lifecycle. You can renew, expire, revoke, or refund it, or place it into a three-day grace period. Each action is idempotent: applying it twice has the same effect as applying it once.

Test data stays easy to tell apart. Development badges mark every test row, and the dashboard's environment switcher next to the project name shows Development data on its own.

Project settings let you disable new development purchases. They also let you reset all development purchases, subscriptions, grants, transactions, and purchase-ledger records. A reset never touches production or sandbox data.