Switch to LIVE Environment

All fiskaly organizations start in the TEST environment by default. The TEST environment provides full API functionality with sandbox data, allowing you to build and validate your integration before going to production.

When you are ready to process real transactions, you need to activate the LIVE environment.

TEST vs LIVE

Feature	TEST	LIVE
API endpoints	Sandbox URLs (middleware)	Production URLs
TSS certificates	Test certificates	Legally valid certificates
Transactions	Not legally binding	Legally compliant and signed
Data retention	Temporary	Full legal retention period
Rate limits	Same as production	Production limits
Cost	Free during development	Per your contract terms

⚠️TEST and LIVE are separate

Data does not transfer between environments. TSS instances, clients, and transactions created in TEST do not exist in LIVE. You will need to create new resources in the LIVE environment.

Activating LIVE Access

1. Check your integration readiness

   Before requesting LIVE access, verify that your integration:

   • Successfully creates and initializes a TSS in TEST
   • Signs transactions end-to-end without errors
   • Handles timeouts and error cases gracefully
   • Generates correct receipt data with QR codes (for SIGN DE)
   • Produces valid DSFinV-K exports (if applicable)
2. Request LIVE activation

   In the fiskaly HUB, a test mode banner is displayed while you are in the TEST environment. As the Account Owner, click the “Go Live” button in this banner to start your activation request. A short form will ask you to confirm your company details and contact information before submitting.

3. Complete the contract

   After your request, the fiskaly sales team will contact you to finalize a contract covering your production usage. This typically includes:

   • Volume tier selection
   • Country module activation
   • Billing and payment setup
4. Receive LIVE access

   While your request is being processed, the banner displays a “LIVE access pending” badge. Once your account has been approved and activated, you will gain access to the LIVE environment.

5. Create LIVE resources

   Switch to the LIVE environment and create your production resources:

   1. Create a new LIVE organization that mirrors your production structure
   2. Generate a new LIVE API Key — TEST keys do not work in LIVE
   3. Create and initialize your production TSS instances
   4. Register clients against the LIVE TSS

📘New API Key required

You must create a new API Key in the LIVE environment. Your TEST API Key will not authenticate against production endpoints.

Switching Between Environments

Once LIVE is activated, you can switch between TEST and LIVE at any time. Each environment is accessed via its own URL, so you can have both open simultaneously. This is useful for:

• Continuing development and testing in TEST while running production in LIVE
• Debugging issues by reproducing them in TEST first
• Training new team members without affecting production data

💡Separate credentials per environment

Store your TEST and LIVE API credentials separately. Use environment variables in your application to switch between them — never hardcode production credentials.

Common Issues

Issue	Cause	Resolution
”Go Live” button not visible	Only the Account Owner can request LIVE	Log in as the Account Owner and complete all onboarding steps
401 errors in LIVE	Using TEST API credentials	Generate new API credentials in the LIVE environment
TSS not found in LIVE	TSS only exists in TEST	Create new TSS instances in the LIVE environment
Missing data after switch	Environments are isolated	Resources must be recreated in each environment

Next Steps

HUB Navigation

Learn the HUB interface and menu structure

First Steps

Complete your organization setup

New Customers Guide

Full integration walkthrough for SIGN DE