Skip to content

Pesepay overview

Pesepay is a payment gateway for Zimbabwe. One integration gives your application access to EcoCash, InnBucks, O’mari, Zimswitch, PayGo and Visa and Mastercard, in US dollars and ZiG (Zimbabwe Gold).

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.

Hosted checkout

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

Embedded checkout

You initiate a transaction and mount Pesepay Elements on your own page. The customer pays there with any method, cards with 3-D Secure included, and card details never reach your servers.

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

Direct API

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

All three return a referenceNumber you use to check status, and all three can notify your server automatically via the result callback instead of you having to poll. Not sure which to use? Choose your integration.

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.