Going live checklist

Each item below matches a check the Backend or the viewer makes. If an item is missing, the visitor sees an empty box or an error card, not a slower page.

Before the switch

1. Your shop is active. Comnoira activates it after you request production. Before that, POST /api/v1/viewer/session answers SHOWCASE_NOT_ACTIVATED.
2. The Showcase is in production mode. A Preview Showcase or a demo is refused with SHOWCASE_NOT_IN_PRODUCTION. When Comnoira approves your shop, the Preview becomes the production Showcase.
3. The code on your page is the production code. The Preview code uses a preview key and no server, and it stops being the right code once the shop is in production. Replace it with the code from the Showcase's page in the Dashboard.
4. Your production domains are in the Showcase's allowed domains. Add every host the page can load from, for example www.example.com and example.com, or *.example.com for all subdomains. A domain on a staging site is a separate entry. The Open mode accepts any domain and is meant for testing only.
5. The License key lives on your server only, for example in an environment variable. The Dashboard snippets read it from THREEDHUB_LICENSE_KEY. It is not in page code, a theme file, a repository or a log.
6. Your license has not passed its end date. A License key past its end date is refused with LICENSE_INACTIVE.

What to know about traffic

• Every page view that shows the viewer makes one request from your server to Comnoira and one from the visitor's browser. Request a new code for each page view, and do not serve cached page HTML that contains a code, because a code works once and for 60 seconds.
• Comnoira limits one server address to 2000 License key requests in 15 minutes. It limits one visitor address to 30 code exchanges in 15 minutes, so many visitors behind one office address share that.
• The session length comes from your license plan. When your shop passes the monthly views of its plan, sessions keep being issued and the viewer shows a notice at the bottom: "Trial/plan expired, renew soon".

Check it in the browser

Open your production page with the browser's network tab. You should see, in this order:

1. A call to your own route, answered with HTTP 200 and a body that holds the code.
2. POST https://api.comnoira.com/api/v1/viewer/session/exchange, answered with HTTP 200.
3. A frame loading viewer.comnoira.com.

If one of the three is missing or fails, Troubleshooting lists the cause for each code.