Environments
Korven One provides two fully isolated environments: sandbox for development and live for real money movement.
Sandbox vs live
| Field | Type | Description |
|---|---|---|
Data | isolation | Sandbox and live share no database records. IDs never collide. |
Money | movement | Sandbox uses simulated balances. Live moves real funds through partner rails. |
Rate limits | quota | Sandbox: 100 rpm/key. Live: 1,000 rpm/key (higher on request). |
Webhook delivery | delivery | Both environments deliver signed events with retries. Signatures differ. |
KYC | compliance | Sandbox has no KYC. Live requires completed Go Live activation. |
Switching environments
The environment is determined by the API key prefix, not by the URL. sk_test_* hits sandbox, sk_live_* hits live — the base URL is identical.
Safety guarantees
- You cannot accidentally send a sandbox payment to a live customer.
- Cross-environment references (e.g. a sandbox customer on a live payment) return 400.
- The dashboard displays a persistent `SANDBOX` banner whenever a test key is in use.
