Developer Documentation

Sandbox

Sandbox Mode

Sandbox mode is enabled with APP_MODE=sandbox. Sandbox endpoints and CLI tools are blocked when APP_MODE=production.

Safety Rules

• Sandbox transactions do not call real PSP, bank, GhIPSS, or telco providers.
• Sandbox records are marked with is_sandbox = 1 on users, customers, merchants, wallets, payments, withdrawals, transactions, provider transactions, webhooks, settlements, and disputes.
• Sandbox provider references use SHB-SBX-*.
• Sandbox webhook event IDs use SBX_EVT_*.
• Sandbox wallets can be credited, debited, or reset by admins only.

Test Accounts

Run php api/cli/seed-sandbox.php.

Default password: Sandbox123!

Default transaction PIN: 1234

Customers:

• +233590000101 verified customer
• +233590000102 unverified customer
• +233590000103 locked customer
• +233590000104 suspended customer
• +233590000105 low balance customer
• +233590000106 high balance customer

Merchants:

• SHB-MER-900001 active merchant with active QR token SBX_QR_ACTIVE
• SHB-MER-900002 pending merchant
• SHB-MER-900003 suspended merchant
• SHB-MER-900004 rejected merchant
• SHB-MER-900005 active QR rotation merchant
• SHB-MER-900006 merchant with revoked QR

Admins:

• super_admin@sandbox.sikaahub.com
• admin@sandbox.sikaahub.com
• finance@sandbox.sikaahub.com
• compliance@sandbox.sikaahub.com
• support@sandbox.sikaahub.com
• risk@sandbox.sikaahub.com

Reset

Run php api/cli/reset-sandbox.php --force to clear sandbox-only financial, provider, webhook, dispute, wallet, merchant, customer, and user data, then recreate seed data.