Payment methods overview
These are the payment methods live on Pesepay today. Codes and limits are configured per method and currency, so the same wallet has a different code — and a different amount range — in each currency it supports.
US dollars
Section titled “US dollars”Send USD as the currency code.
| Method | Code | Amount range | Required fields | Integrations |
|---|---|---|---|---|
| EcoCash | PZW211 | $1 – $500 (collected in parts above) | customerPhoneNumber | Hosted, Embedded, Direct API |
| InnBucks | PZW212 | $1 – $1,000 | none | Hosted, Embedded, Direct API |
| O’mari | PZW216 | $0.50 – $500 | customerPhoneNumber | Hosted, Embedded, Direct API (two-step OTP) |
| Zimswitch | PZW215 | $0.10 – $5,000 | none | Hosted, Embedded |
| Visa | PZW204 | $0.10 – $10,000 | none | Hosted, Embedded |
| Mastercard | PZW205 | $0.10 – $20,000 | none | Hosted, Embedded |
ZiG (Zimbabwe Gold)
Section titled “ZiG (Zimbabwe Gold)”| Method | Code | Currency code to send | Amount range | Required fields | Integrations |
|---|---|---|---|---|---|
| EcoCash | PZW201 | ZiG | 2 – 8,000 (collected in parts above) | customerPhoneNumber | Hosted, Embedded, Direct API |
| PayGo | PZW210 | ZiG | 1 – 2,400 | none | Hosted, Embedded, Direct API |
| Zimswitch | PZW213 | ZWG | 1 – 100,000 | none | Hosted, Embedded |
| O’mari | PZW217 | ZWG | 0.10 – 100,000 | customerPhoneNumber | Hosted, Embedded, Direct API (two-step OTP) |
Choosing which to support
Section titled “Choosing which to support”Start with the mobile money methods your customers actually use day to day — EcoCash has the broadest reach in Zimbabwe — then add cards and Zimswitch for higher-value customers. You don’t need to support everything on day one.
Watch the amount ranges when you decide. They differ sharply per method: Visa tops out at $10,000 where Mastercard allows $20,000, and only EcoCash collects payments above its ceiling in several parts rather than rejecting them.
Methods by integration
Section titled “Methods by integration”Hosted checkout and Embedded checkout take every method in the tables above. On the hosted page Pesepay shows whichever methods are enabled for your application. With Embedded checkout the same methods appear in elements on your own page, and card details are typed into a frame served from a Pesepay origin, so they never touch your systems.
The Direct API is where you collect each method’s required fields yourself and submit them with Make Payment. It takes the mobile money and scan methods only. Cards — Visa, Mastercard and Zimswitch — are not available through the Direct API; take them with Hosted or Embedded checkout.
Phone numbers
Section titled “Phone numbers”Two methods take the customer’s phone number as customerPhoneNumber, in
different formats:
| Method | Format | Example |
|---|---|---|
| EcoCash | Local form of an Econet number, starting 077 or 078 | 0771234567 |
| O’mari | International form without a +: twelve digits starting 2637 | 263771234567 |
InnBucks, PayGo, Zimswitch and cards take no phone number. Elements collects the number for you in Embedded checkout.