Skip to main content

Request a sandbox

Sandbox is a separate ChainIT environment. Use it to try Admin Portal flows, APIs, and Developer Portal work without touching live production data.

You request it from production Admin. After ChainIT approves, you create a new sandbox ChainIT ID and sign in to sandbox Admin. Your production login will not open that console.

Two environments, two logins

Production and sandbox do not share accounts. A phone number or session that works on

production Admin

will not sign you in to

sandbox Admin

. Plan on a new ChainIT ID for sandbox.

One request · isolated sandbox · first Admin login

Production Admin

Request sandbox

Sandbox ready

Isolated environment

Signed in

Sandbox Admin

RequestReviewEmailAccountSigned in

Your journey at a glance

Follow these five steps in order. The rest of this page walks each one.

StepYou are hereWhat you doYou are done when
1. RequestProduction AdminOpen Administration → Request Sandbox and click Initialize SandboxStatus shows Request Submitted
2. ReviewWaitChainIT reviews and provisions your sandbox orgStatus shows Environment Ready, or you get the approval email
3. EmailInboxOpen Your sandbox request has been approved and click ContinueYou are back in production Admin for that org
4. AccountSandbox PWA / ChainIT IDCreate a new sandbox ChainIT IDYou can complete OTP on sandbox-pwa.chainit.online
5. Sign inSandbox AdminOpen the sandbox Admin QR page and scan with that new IDSandbox Admin loads

Step 1 of 5

Request

In production Admin, open Administration → Request Sandbox and click Initialize Sandbox. You should see Request Submitted and Awaiting approval.

admin-react.chainit.online
Request

Before you start

Check these first so you do not get stuck on the first screen.

  • Your organization already exists in production.
  • Your organization is verified. Unverified orgs cannot be approved for sandbox.
  • You can sign in to production Admin as an organization admin.
  • You can install ChainIT ID on a phone, or use the sandbox PWA in a browser.

If Administration → Request Sandbox is missing, you are either not an org admin, or you are already looking at sandbox Admin. Ask your ChainIT contact if the menu still does not appear.

You are inAdminChainIT ID / PWA
Production — send the requestadmin-react.chainit.onlinepwa.chainit.online
Sandbox — create your account and sign insandbox-admin-react.chainit.onlinesandbox-pwa.chainit.online

Install ChainIT ID for iOS or Android before you reach the sign-in step. You can also start in the browser at sandbox-pwa.chainit.online.

Step 1 — Request sandbox from production Admin

Where: Production Admin

  1. Sign in to production Admin with your existing production ChainIT ID.
  2. Open Administration → Request Sandbox.
  3. Read the short intro. The first time, you should see Initialize a sandbox environment to safely test your integrations.
  4. Click Initialize Sandbox.

What you should see next

  • The stepper moves to Request.
  • Title changes to Request Submitted.
  • Message: Your request has been received and is under review by our administration team.
  • Footer shows Awaiting approval...

Nothing is created in sandbox yet. You are only asking ChainIT to provision an isolated copy of your organization.

Need to retry?

If a previous attempt failed, the same page shows Request Failed and a Retry Request button. Use that instead of opening a new ticket.

Step 2 — Wait while ChainIT reviews and builds sandbox

Where: stay on Administration → Request Sandbox in production Admin.

You do not approve this yourself. ChainIT reviews the request, then builds a new organization in the sandbox environment (same business details and product lines, new sandbox org id).

While you wait, the page moves through two states

Screen titleMeaningWhat you do
Request SubmittedRequest is queuedWait. Do not click Initialize again.
Provisioning in ProgressSandbox org is being createdWait a few minutes. Keep this tab or come back later.
Environment ReadySandbox org existsGo to Step 3 and Step 5.
Request FailedProvisioning did not finishClick Retry Request, or contact support@chainit.com.
Why this takes a few minutes

Sandbox is a full environment: a new organization, verification, product lines, and folders. Production data is not copied as live records — you get an isolated org you can test against.

Step 3 — Open the approval email

Where: the email inbox on your organization record.

When provisioning succeeds you receive Your sandbox request has been approved.

  • The email names your organization.
  • It confirms the sandbox organization is ready.
  • Click Continue. That opens production Admin for your org (…/{orgId}/organization).
  • From there, go back to Administration → Request Sandbox.
  • You should now see Environment Ready and buttons Go to sandbox / Access Your environment.

If the email never arrives, check spam, then confirm the org email on the organization profile. You can still open sandbox from the Request Sandbox page once status is Environment Ready.

Step 4 — Create a sandbox ChainIT ID

Where: sandbox-pwa.chainit.online or the ChainIT ID app pointed at sandbox.

Production users do not exist in sandbox. Create a new identity before you try Admin.

  1. Open the sandbox PWA (or the mobile app).
  2. Start Sign up with a phone number you can receive SMS on.
  3. Complete the OTP. This call goes to sandbox (sandbox-api.chainit.online), not production.
  4. Finish any checkout or promo step the sandbox flow shows you.
  5. Keep this session. You will scan a QR with it in the next step.
Do not reuse your production account

Signing in on sandbox PWA with the same phone as production can still fail or create a different user. Treat sandbox as a new registration. Your production password, session, and org membership do not transfer.

Step 5 — Sign in to sandbox Admin

Where: sandbox-admin-react.chainit.online

  1. From production Request Sandbox, click Go to sandbox or Access Your environment.
    Or open sandbox Admin directly.
  2. On the sandbox Admin sign-in page, leave the QR code on screen.
  3. On your phone (or sandbox PWA), open the new sandbox ChainIT ID.
  4. Scan the QR and approve the session.
  5. You are in when sandbox Admin loads for your sandbox organization.

That is the finish line for this guide. You can now use sandbox Admin, invite teammates, and continue to the Developer Portal.

Invite a teammate (optional)

After you can sign in to sandbox Admin:

  1. Open Administration → User Management.
  2. Invite the person with the developer role (or org admin, if they should request more access).
  3. Ask them to create their own sandbox ChainIT ID (Step 4).
  4. They sign in the same way (Step 5).

They cannot skip the new sandbox account. Sharing your production QR or production invite will not work.

If something looks wrong

What you seeLikely causeWhat to do
No Request Sandbox menuNot an org admin, or you are in sandbox AdminUse production Admin. Ask an org admin to grant access.
Request Submitted for a long timeStill waiting on ChainIT reviewWait, or email support@chainit.com with your org name.
Request FailedSandbox provisioning errorClick Retry Request. If it fails again, contact support.
Approval email missingWrong org email, or still provisioningConfirm org email. Use Go to sandbox once status is Environment Ready.
Sandbox Admin says login failed / 500You scanned with a production ChainIT IDCreate a new ID on sandbox PWA, then scan again.
Sandbox Admin loads but you see no orgNew user is not on the sandbox org yetAsk the org admin who requested sandbox to invite you from sandbox User Management.

What to do next

Once sandbox Admin is open:

Next: Developer Portal — Getting Started