Environments
Omniware exposes the same API surface in test and live modes. You toggle between them by changing the mode parameter on requests that support it, and by using the test credentials issued to you alongside your live keys.
Base URLs
| Environment | Base URL |
|---|---|
| Live | https://pgbiz.omniware.in |
| Test | Provided to you at onboarding |
All endpoints in this documentation are written against the live base URL. Substitute the test base when integrating, then promote to live once you have signed off on the test transactions.
Switching modes on a single endpoint
The Payment Request API accepts a mode parameter (LIVE or TEST). When set to TEST, the request is processed against the sandbox even on the live base URL.
-d "mode=TEST"
What you'll need in each environment
Separate api_key, salt, encryption_key, and decryption_key from your live set. Test card numbers and UPI VPAs are issued at onboarding.
Your real merchant credentials. Whitelist your server IP for endpoints like Payment Status, which require IP allow-listing.
IP whitelisting
A handful of read-only endpoints (most notably Payment Status) only respond to requests from IPs you have whitelisted with Omniware. If you receive Unauthorized errors, contact your relationship manager to add the originating server IP.