Sandbox and live
One host, two environments. The API key chooses: sk_test_ keys work on the sandbox, sk_live_ keys on the live service. Nothing else changes between them, so code written against the sandbox runs unchanged with a live key.
https://gp.useyona.com
What the sandbox does
- Invoices are validated, signed and submitted for real, to the authority’s test system, under Yona’s own test taxpayer. You see every state an invoice goes through, with no legal effect.
- You do not need a tax connection of your own to submit on the sandbox.
- Sandbox data is separate from live data: buyers, items, invoices and webhook endpoints created with a sandbox key are only visible to sandbox keys.
- Credits are separate too. Sandbox actions draw on a sandbox allowance, and you can top it up for free in the Yona app. Costs per action are the same as live, so sandbox usage shows you what live will cost.
Nothing on the sandbox is a tax invoice
Documents issued on the sandbox carry test identifiers and are not reported for your business. Do not send them to customers.
What live needs
| Requirement | Where |
|---|---|
| Live access approved for your organisation | Request it in the Yona app; Elyonar reviews it |
| Your business connected to the tax authority, with your crypto key installed | The Yona app, under Tax authority; see Tax connection |
A sk_live_ key | The Yona app, under API keys, from a session with a second factor |
| Credits | Your plan’s monthly credits, plus any top-up; see Credits and billing |
Until the first two are in place, a live key is refused with BIZ006, and a live submission cannot be signed as your business.
Side by side
| Sandbox | Live | |
|---|---|---|
| Key prefix | sk_test_ | sk_live_ |
| Submissions | Real flow, to the authority’s test system, as Yona’s test taxpayer | Real, as your business, irreversible once registered |
| Tax connection | Not needed | Required, with your crypto key |
| Credits | Sandbox allowance and free top-ups | Plan credits and paid top-ups |
| Data | Separate | Separate |
Moving to live
Use the Going live checklist. The code change is one line: the key.