Sandbox
Test every outcome without spending money.
Requests made with a sandbox key (flx_test_…) are simulated: no operator is called and no balance is charged. Your sandbox balance is always 100,000 DZD. Sandbox top-ups are kept for 7 days.
Validation is the same as in production, so ERR_VALIDATION, ERR_PHONE, DUPLICATED_REF and READ_ONLY_KEY behave exactly as they will live.
Mobile test numbers
Any other valid number is PENDING for 5 seconds, HANDLING until 15 seconds, then COMPLETED.
| MSSIDN | Result |
|---|---|
0600000001 | REFUNDED after 5 seconds, with a refund_message |
0600000002 | REFUNDED after 5 seconds, with suggested_offers (try a FACTURE_* plan instead) |
0600000003 | UNKNOWN_ERROR after 5 seconds |
0500000004 | DEBT_PENDING after 5 seconds with a 100 DZD SABBAQLI debt. Answer with resolve-debt; each choice then completes 10 seconds later |
0700000004 | Djezzy offers carry a 150 DZD Tranquilo debt (debt_amount: 150) |
01… (any) | Ooredoo Enterprise line: works with *_OOREDOO plans, ERR_PHONE with others |
Sandbox offers from GET /v3/mobile/offers have ids like sbx.mobilis.mix500. They work for any number.
Internet test numbers
Any other valid number is HANDLING for 3 seconds, then COMPLETED with num_trans: "TESTTRANS".
| ADSL | 4G | Result |
|---|---|---|
030000000 | 213400000000 | Refused at once with ERR_PHONE (also on check-number) |
030000001 | 213400000001 | REFUNDED after 3 seconds |
030000002 | 213400000002 | MANUAL_REDEEM after 3 seconds, with card_code: "TESTCARD" |
030000003 | 213400000003 | UNKNOWN_ERROR after 3 seconds |
The 5000 DZD ADSL card and the 6500 DZD 4G card are always out of stock, to test ERR_STOCK.
Checklist before going live
- Every send has a unique
ref, stored before the request is made. - Timeouts and
SERVICE_UNAVAILABLEare followed bycheck-ref, not a blind resend. -
DUPLICATED_REFreads the existing top-up. -
REFUNDEDrefunds your customer and showsrefund_message. -
UNKNOWN_ERRORis not refunded and is re-checked later. -
MANUAL_REDEEMshows the card code to the customer. - Your production key is restricted to your server IPs.