Developer Documentation

Deployment

Deployment

Point api.sikaahub.com to:

/var/www/html/Kalajha/api/public

For this checkout, the local path is:

/var/www/html/SikaaHub/api/public

Requirements

• PHP 8.2 or 8.3
• PDO MySQL extension
• OpenSSL
• mbstring
• JSON
• MySQL or MariaDB
• HTTPS certificate

Setup

1. Copy .env.example to .env.

2. Set APP_ENV=production and APP_DEBUG=false.

3. Set strong JWT_SECRET, WEBHOOK_SECRET, and ENCRYPTION_KEY.

4. Import database/schema.sql or run migrations through deploy/run-migrations.php.

5. Make storage/logs and storage/cache writable by the web server.

6. Configure SSL and force HTTPS.

7. Add cron jobs for queue, health, reconciliation, settlement, and cleanup scripts.

Cloudflare DNS can proxy the API domain, but SSL mode must be full/strict and webhook provider IP allowlists should be reviewed.

Sandbox/Staging

• Set APP_MODE=sandbox for internal QA and staging.
• Set APP_MODE=production for live environments; sandbox endpoints are blocked in production.
• Run php api/cli/seed-sandbox.php to create safe test accounts.
• Run php api/cli/reset-sandbox.php --force to clear and recreate sandbox data.
• Do not configure real provider credentials for sandbox simulations.