Skip to main content
Zennopay exposes two partner-facing environments. Both speak the same API; they differ only in which keys, FBO accounts, and payout-provider rails they point at.

Base URLs

EnvironmentBase URLUse it for
Productionhttps://api.zennopay.comLive partner traffic. Real money. Production HMAC keys.
Sandboxhttps://api.sandbox.zennopay.comIntegration, QA, and demos. Sandbox HMAC keys only — production keys are rejected by the sandbox host.
All endpoints are mounted under /v1. Example: https://api.zennopay.com/v1/payment_intents.

Picking the right one

  • During integration, point every example in this documentation at the sandbox base URL. Code snippets default to the production URL for copy-paste readiness in your final integration — swap the host while you’re building.
  • Sandbox issues a separate X-Zennopay-Key-Id (e.g. wizz_sandbox_2026q2) and a separate signing secret from production. Never cross the streams.
  • The OpenAPI playground is hard-wired to the sandbox host.

Checkout and dashboard hosts

These are shared across environments — the API host you call determines which backend the flow lands on.
SurfaceURL
Hosted checkout (mobile SDK target)https://checkout.zennopay.com
Partner dashboardhttps://dashboard.zennopay.com

What about staging?

Zennopay also runs an internal staging environment for pre-production verification of our own deploys. It is not exposed to partners and has no public hostname. Partners test against sandbox.

Promotion path

your code  --->  api.sandbox.zennopay.com  --(graduation review)-->  api.zennopay.com
Graduation from sandbox to production is gated on:
  1. A signed partner agreement and operational runbook on file.
  2. A pre-funded USD float at the Zennopay FBO account.
  3. KYC / sanctions attestation flow verified end-to-end in sandbox.
Email partners@zennopay.com to start the graduation review.