Development mode

Development mode lets a debug build buy from a simulated store while Voidhash processes the purchase for real: products, perks, receipts and analytics all behave as in production. Use it to build your purchase flow before you connect a store. Its purchases are recorded in the test environment and never unlock production; see Environments.

Turn it on

Create the client with dev: true and the test publishable key in debug builds:

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

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

• dev only works in debug builds. Release builds ignore it and use the real store.
• Voidhash refuses simulated purchases made with the production key.
• Enable simulated purchases in Settings → General must be on. It is on for new projects.
• Subscription products need a billing duration, which sets their renewal and expiry dates. No store mapping is needed.
• Observer mode blocks simulated purchases like any other, with READ_ONLY_PURCHASE_NOT_ALLOWED.

A purchase shows a confirmation sheet instead of the store sheet. After you confirm, the SDK records the purchase with Voidhash and refreshes the person, so useHasPerk sees the new perk.

Test prices

Simulated products use fixed USD prices:

A subscription without a duration is simulated as monthly, with a warning.

Simulate renewals and refunds

Move a person's simulated purchases through their lifecycle with the CLI. Each action applies once, however often you run it.

voidhash sandbox view user_123
voidhash sandbox renew user_123
voidhash sandbox grace-period user_123 pro_monthly

The CLI isn't published to a package registry yet. The same actions work through the MCP server and the HTTP API; see Simulate renewals, expiry and refunds.

<person> is a distinct ID, email or person ID. Pass [product] when the person has several.

In Studio, choose Test in the environment switcher to see simulated purchases and their revenue. Delete simulated purchases in Settings → General does the same as sandbox reset; it never touches production, store sandbox, Stripe test mode or payment source test purchases.

Next steps

• Test with store sandboxes (Help center)
• Connect the App Store (Help center)
• Connect Google Play (Help center)
• Go-live checklist