Development purchase mode

Development purchase mode lets a React Native 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 App Store Connect or 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 include test 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 App Store Connect or Google Play Console.

Then turn on the dev option when you create the client.

import { createVoidhashClient } from "@voidhash/react-native";

export const voidhash = createVoidhashClient("vh_pk_...", {
  dev: true,
});

With the option on, a purchase shows a confirmation sheet instead of the store 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 SDK only honors dev: true in a debug build. Release builds always use the real store adapter, and the fake-store adapter is dynamically loaded only from the internal debug branch. Set dev: false if you want a debug build to use the real store.

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 analytics revenue pages have an Include test data switch.

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.

Development purchase mode is currently React Native-only. The web SDK has no purchase adapter, so web paywalls continue to use their existing checkout integration.