Get started
Sandbox and production
How the sandbox and production environments differ, and how to go live.
Last updated
Every merchant account has two fully separate environments. Each has its own API keys, wallet, webhooks and shipment history, and nothing created in one ever appears in the other.
Compare the environments
| Sandbox | Production | |
|---|---|---|
| API keys | SB_… | PROD_… |
| Base URL | https://api.7feastr.com/api/v1/logistics/v1 | https://api.7feastr.com/api/v1/logistics/v1 |
| Available | Immediately after onboarding | After business verification (KYB) and go-live approval |
| Wallet | Prefunded with ₦500,000 of test credit. No real money | Funded by card or bank transfer from the dashboard |
| Deliveries | Booked on a test delivery network. No rider is dispatched and nothing is collected | Real pickups and deliveries |
| Prices | From a test rate table, indicative only | Live prices |
| Webhook URLs | HTTP or HTTPS | HTTPS only |
Sandbox
Use sandbox to build and test your whole integration end to end: quotes, shipment creation, cancellation, refunds and webhooks.
- Sandbox shipments are booked on a test delivery network. Their statuses can move as test events arrive, but no real rider is dispatched and nothing is physically collected or delivered.
- Sandbox prices come from a test rate table and are indicative only. See the example sandbox quotes.
- The sandbox wallet cannot be topped up through the API.
Production
- Production is unlocked once your business verification (KYB) is approved and your account is enabled to go live. Until then,
PROD_keys return403 permission_error. - Shipments are prepaid. Fund your production wallet by card or bank transfer from the merchant dashboard before you create shipments.
- Production webhook URLs must use HTTPS.
Going live checklist
- Complete business verification in the dashboard and wait for approval.
- Create a production API key and store it as a secret on your server.
- Fund your production wallet.
- Register your production webhook endpoint (HTTPS) and copy its signing secret.
- Swap the sandbox key for the production key. No other code changes are needed.