Skip to content

Pesepay API Sandbox request

Accept payments across Zimbabwe

EcoCash, InnBucks, O'mari, Zimswitch, PayGo and cards — one encrypted API, one integration.

One integration
  • EcoCash
  • InnBucks
  • O'mari
  • Zimswitch
  • Visa and Mastercard
  • PayGo
POST /payments/initiate
curl -X POST https://api.test.sandbox.pesepay.com/payments-engine/v1/payments/initiate \
-H "authorization: YOUR_INTEGRATION_KEY" \
-H "content-type: application/json" \
-d '{"payload": "ENCRYPTED_BASE64_STRING"}'
200 OK decrypted response
{
"referenceNumber": "20260901103214123-A1B2C3D4",
"redirectUrl": "https://checkout.pesepay.com/...",
"pollUrl": "https://api.test.sandbox.pesepay.com/payments-engine/v1/payments/check-payment?referenceNumber=20260901103214123-A1B2C3D4"
}

Start building

Everything you need to take your first payment

Four places to start, depending on how you like to learn.

Quickstart

Zero to your first sandbox payment in about five minutes, with copy-paste code in Node.js, Python, PHP and Java.

Payment methods

One page per channel, each with its required fields, currencies and test credentials.

REST API reference

Every endpoint, every field, with request and response examples you can copy straight into your codebase.

Webhooks

Get notified the moment a payment completes, instead of polling for status.

Integration styles

Three ways to integrate

All three return a reference number you can track, and all three notify your server when the payment ends.

Hosted checkout

Send your customer to the Pesepay-hosted payment page and get notified when they are done. The fastest way to launch, with no payment UI to build.

  1. 1 Initiate
  2. 2 Pesepay page
  3. 3 Result callback

Embedded checkout

Mount Pesepay Elements on your own page and the customer pays there, cards and 3-D Secure included. Card details never touch your servers.

  1. 1 Initiate
  2. 2 Elements on your page
  3. 3 Result callback

Direct API

Collect the details in your own UI and charge from your server. For places with no browser: USSD, WhatsApp bots, POS terminals and kiosks.

  1. 1 Collect details
  2. 2 Make payment
  3. 3 Result callback

Coverage

Every major Zimbabwean channel

Supported in US dollars and ZiG (Zimbabwe Gold). One integration covers all of them.

Libraries

Official server libraries

Native clients that handle encryption, request signing and response decryption for you.

Tools

Build faster, with or without an assistant

Machine-readable docs for AI coding tools, and a spec you can generate clients from.

Building with AI tools

Point Cursor, Copilot or Claude at machine-readable versions of this site, and use a prompt that stops them inventing Pesepay endpoints and fields.

OpenAPI spec & Postman

An OpenAPI 3.1 description of every endpoint, plus a ready-made Postman collection for trying the API by hand.