Test flows

Use this checklist while validating a tiun integration in sandbox — the parallel test environment with its own domain, snippet ID, product IDs (p-test-...), and API keys. Items are grouped by product type so you can focus on what applies to your integration.

General (all product types)

• Overlay opens when triggered (tiun.checkout() for subscriptions, tiun.start() for time-based).

• Test payment methods complete successfully.

• Overlay closes cleanly after success or cancel.

• Failures surface through the SDK error event so you can log or show UI.

• If you verify purchases or sessions on your server, requests use the sandbox base URL and a sandbox API key (not shared with live). Replace both with live URL and key when you ship.

Subscriptions

• userChange fires after checkout with event: 'checkout' and updated productAccess.

• Login and logout behave correctly (see authenticating your user).

• After a successful purchase, productAccess includes the expected product ID.

• Returning to the app restores the user session without forcing login (userChange with event: 'init').

• Removing or expiring access (where testable) updates productAccess and triggers userChange.

Time-based billing

• paywallShow fires when the user doesn't have access.

• paywallHide fires when access is granted and a session is active — payload includes a sessionId.

• setContent() pauses and resumes sessions correctly across content types.

• Switching between paid and free content updates the session state as expected.

---

For sandbox vs. live setup, see setting up your environment. For how the two environments differ, see Sandbox in Reference.