Sandbox Setup

Sandbox lets you run tiun end-to-end against test data and simulated payments without touching live customers. You enable it in two places: the dashboard and the SDK. Using both together avoids mismatches between what your app calls and what the dashboard shows.

1. Dashboard: enable Sandbox Mode

In the tiun.business dashboard, find the Sandbox toggle in the bottom-left of the sidebar and turn it on. When sandbox is active, an orange banner appears at the top so you always know you are viewing sandbox data.

Sandbox toggle in the dashboard sidebar.

First-time domain setup

The first time you activate sandbox, a dialog asks you to enter the domain of your test environment. This lets tiun associate requests from your staging site with the sandbox workspace. You can add more domains later.

Entering your test-environment domain on first activation.

Once sandbox mode is on, you can create test products, test users, and run test checkouts — all separate from production data.

2. SDK: set sandbox: true

In your app, pass sandbox: true when initializing tiun so the SDK talks to the sandbox API:

import { tiun } from '@tiun/sdk';

tiun.init({
  snippetId: 'YOUR_SNIPPET_ID',
  language: 'en', // set to your site's language
  sandbox: true,
});

This points the SDK to the sandbox base URL:

https://api-sandbox.tiun.live/live_api

That keeps checkout, sessions, and user state on the same backend slice as the sandbox dashboard.

Keep them aligned

Both the dashboard and the SDK need to be in sandbox mode at the same time. If one is live and the other sandbox, product IDs and sessions will not match what you see in the UI.

Questions about sandbox or domain setup? Email [email protected].