Skip to main content
Start with the QR Payments quickstart or Platform Payouts quickstart to run a complete sandbox flow. Use the endpoint pages in API Reference to inspect request fields and responses.

Send a sandbox request

  1. Use https://api.sandbox.zennopay.com and your sandbox credentials.
  2. Build the exact JSON body you will send. Generate a fresh timestamp and nonce, then compute the HMAC signature on your backend or in a trusted local script.
  3. Send the body with the four HMAC headers. Keep your idempotency key stable when retrying the same operation.
  4. Save the resource ID and retrieve its status to verify the result.
Keep your HMAC signing secret on your backend. An OpenAPI client does not compute Zennopay signatures automatically: provide the signed headers for each request, and avoid changing the body after signing. For SDK requests, use the returned session_token as Authorization: Bearer and send your registered X-Zennopay-Package. The native SDK supplies these headers when you use PaymentSheet.

Download the OpenAPI spec

Import the OpenAPI 3.1 document into Postman, Insomnia, or your client tools to inspect payment-intent, beneficiary, and payout endpoints.
Funding requests, conversions, and balance reads are documented in Fund your payout balance.

Troubleshoot a request

See Environments for live configuration and supported alternate hosts.