Skip to content

Overview

Pesepay is a payment gateway for Zimbabwe. One integration gives your application access to EcoCash, InnBucks, Omari, Zimswitch, PayGo and Visa/Mastercard, in US dollars and Zimbabwe dollars.

Every request and response that carries payment details is encrypted with AES-256-CBC using a key unique to your application. See the Encryption Guide for the full spec.

Redirect (checkout) flow

You initiate a transaction and redirect the customer to a hosted Pesepay payment page, where they choose a method and pay. Simplest to build — Pesepay’s page handles the payment method UI for you.

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

Seamless (direct) flow

You collect the payment method and its required fields (for example a phone number for EcoCash) in your own UI and call make payment directly. More control, more UI to build.

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

Both flows return a referenceNumber you use to check status, and both can notify your server automatically via the result callback instead of you having to poll.

Move to production

Work through the checklist before you switch to live keys.

Using an AI coding assistant? Read Building with AI tools first — it links machine-readable versions of these docs and gives you a prompt that keeps assistants from inventing Pesepay endpoints, fields and currency codes.