Sandbox (test mode)
ما هو Sandbox (test mode)?
هذا المصطلح متوفر حاليًا باللغة الإنجليزية فقط.
A sandbox (test mode) is an isolated sending mode you reach with a test-prefixed API key — a `dv_test_sk_` secret key or a `dv_test_pk_` publishable key — instead of a live `dv_live_*` credential. A send in test mode accepts as normal but terminates at the `test_sent` status with delivery simulated, so you can validate an integration, webhook handling, and flows without spending wallet balance or stamping carrier-side sender reputation.
More detail
Because the same request body and the same webhook shape run in both modes, swapping to the live key is the only change a go-live needs — no retooling of your integration between test and production.
Test mode terminates at a simulated terminal status (`test_sent`) instead of an attempted carrier delivery, so the webhook your integration expects still lands with the right shape and the right status transitions to assert against.
The pre-launch checklist on Orbit walks the go-live gates — wallet top-up, sender approval, quiet hours, DLR webhook — before a live key starts terminating sends on a real carrier.
الأسئلة الشائعة
- Does the sandbox send real messages?
- No — in test mode a send accepts as normal but closes at `test_sent` with delivery simulated, so no carrier connection, no cost, and no sender-reputation side effects. It exists to validate request shape, webhook handling, and flows, not to reach a recipient.
- What changes going live?
- Only the API key — swap a `dv_test_*` credential for a `dv_live_*` one. The SDK, endpoint paths, request bodies, and webhook shapes are identical, so a working test integration cuts over without a code change.
See also
Build it on Orbit
Voice, messaging, email, video, and AI agents on one platform and one pay-as-you-go bill. Start free — no credit card required.