What is sandbox?

Sandbox is a safe, production-like testing environment designed for clients integrating with Fonoa’s products. It allows teams to simulate realistic API interactions without connecting to actual tax authorities or triggering real-world transactions.

With Sandbox environment, you can verify how your software behaves across different scenarios — including success cases, errors, and delays — in a controlled and predictable setting.

Why use it

Enables safe and repeatable testing.
Mirrors production behavior and structure.
Supports development, QA, and integration testing workflows.
Helps simulate both standard and edge-case scenarios.

⚙️ Technical Details

How it works

Sandbox environment mimics the production API interface but substitutes all external integrations and data with predefined responses. These are triggered based on specific input values and follow country-specific rules and formats.

Same public API interface as production.
Responses simulate successful results, delays, errors, and input-related failures.
Internally routed to mock backends without real-time tax authority calls.

Getting started

To use Sandbox environment:

Use the sandbox API base URL: https://sandbox.fonoa.com
Use your sandbox API key provided during onboarding (not your production key).
Send requests as you would in production, using test inputs defined per product