How payments work
Every Pesepay payment — regardless of method — follows the same shape:
- Your server → Pesepay Create the transaction encrypted payload
- Pesepay → Your server referenceNumber store it now
- Customer → Pesepay Customer pays hosted page, elements, or your UI
- Pesepay → Payment provider Processes the payment
- Payment provider → Pesepay Outcome
- Pesepay → Your server Result callback
- Your server → Pesepay Confirm the status
- Pesepay Settles to your account
- Your server creates a transaction with an amount, currency, and reason for payment, encrypts it, and sends it to Pesepay.
- The customer pays in one of three places: on a Pesepay-hosted page (Hosted checkout), in Pesepay Elements on your own page (Embedded checkout), or in your own UI, which submits their details to the Direct API.
- Pesepay processes the payment with the relevant provider (EcoCash, a card network, a bank, etc).
- Your server finds out the result — either pushed to you via the
result callback, or pulled by
checking status with the
referenceNumber. - Funds settle to your payout account roughly T+2 days after the transaction completes.
Reference number: your source of truth
Section titled “Reference number: your source of truth”Every transaction gets a referenceNumber the moment it’s created. Store it
against your order/invoice immediately — it’s what ties together the
initiation request, the result callback, and any status checks you make
later. See the transaction result fields.
Picking a flow
Section titled “Picking a flow”| Hosted checkout | Embedded checkout | Direct API | |
|---|---|---|---|
| Where the customer enters payment details | Pesepay’s hosted page | Pesepay Elements on your page | Your own UI |
| Payment methods | All, cards included | All, cards included | EcoCash, InnBucks, O’mari, PayGo |
| PCI/compliance surface on your servers | Minimal | Minimal: card fields run on a Pesepay origin | Larger — you handle method-specific fields |
| Best for | Fastest to ship | Your own checkout on the web | No browser: USSD, bots, POS |
Hosted checkout → · Embedded checkout → · Direct API →
For the full comparison, see Choose your integration.
Any of the three can settle part of each payment to a second merchant automatically — see Split payments.