Environment Setup
These environment details apply to both Payment Gateway and Pay to Merchant integrations. Replace sample values with production credentials when moving to live.
| Context | Variable | Test Value | Notes |
|---|---|---|---|
| Base URL | API_HOST | https://staging.cashia.com | Pre-production cluster for API calls |
| Hosted Checkout | Checkout URL | https://staging.cashia.com/link/{merchantName}/{sessionId} | Returned when you create a hosted checkout session |
| Currency | currency | KES | Default currency for staging data |
| Merchant Identifier | merchantId | 019a06ee-a28c-760a-9d82-669be5c04ddc | Sample merchant ID for sandbox testing |
| Merchant Stika | merchantStika | KES_123456 | Replace with the value assigned to your merchant |
| Static OTP (staging) | otp | 534789 | Used during merchant login confirmation in staging |
Quick Start Checklist
- Credentials – Collect your API key ID and secret from the Cashia dashboard.
- Environment variables – Store host, key ID, secret, merchant info, and callback URLs securely.
- Callback URLs – Expose
successRedirectUrl,errorRedirectUrl, and webhook endpoints over HTTPS. - Sandbox data – Use staging-specific MSISDNs or test accounts when triggering P2M flows.
- Production cutover – Request live credentials from Cashia and update the host/base URLs accordingly.
Need API key generation steps? Visit the dashboard quick start for minting or rotating keys.
Last updated on