Environments
Live and test
There is a single base URL for all traffic:
https://api.subthingy.io/v1All paths in this documentation are relative to that base, for example:
https://api.subthingy.io/v1/transactions/airtime/syncLive and test are not separate hosts. Every merchant profile is provisioned with two credential pairs — one live, one test — both valid against the same base URL:
| Credential | Purpose |
|---|---|
Test X-Merchant-Key / X-Merchant-Secret | Integration testing, UAT, and credential validation |
Live X-Merchant-Key / X-Merchant-Secret | Real customer traffic |
Which environment a request runs in is resolved from the credential pair you send — not from the URL. Contact your account manager to receive your live and test API keys during onboarding.
Do not use your live credentials for integration testing (or your test credentials for real traffic). Keys issued for one environment are not valid for the other, even though the URL is identical.
IP whitelisting (production)
Production access requires your outbound IP addresses to be whitelisted before go-live.
- Collect the public egress IPs used by your servers, jobs, or integration platform.
- Send the list to your account manager.
- Wait for confirmation that whitelisting is active before switching live traffic.
Requests using live credentials from non-whitelisted IPs are rejected. Test-credential traffic may use a separate policy — confirm with your account manager during onboarding.
Reconciliation reporting
Transaction reconciliation reports are delivered by email on a T+1 schedule: reports for a given calendar day are sent on the next business day.
To receive reports, provide one or more reconciliation email addresses to your account manager, for example:
recon@yourcompany.comfinance@yourcompany.com
Include:
- Primary recipient(s) for daily files
- Optional CC addresses for your finance or operations team
- Any naming convention you need in the email subject (if supported for your merchant)
Reports typically cover settled transactions, totals by product, and status breakdowns. Contact your account manager if you need a custom format or additional delivery schedule.