Prevail Group · internal payments platform

One payments gateway for every Prevail SBU

PrevailPay sits on top of ZB Smile&Pay and gives each sub-business unit a single API for Ecocash, InnBucks, Omari, SmileCash, cards and hosted checkout — with group-wide reporting for head office.

Read the API reference →Open the dashboard24 endpoints · 6 sections

Quick start

Terminal

# 1. Head office registers your SBU (once) and hands you the key
curl -X POST https://13-247-53-102.sslip.io/api/v1/admin/sbus \
  -H 'X-Admin-Key: <admin key>' -H 'Content-Type: application/json' \
  -d '{ "code": "PMICRO", "name": "Prevail Microfinance" }'

# 2. Initiate a hosted checkout with your SBU key
curl -X POST https://13-247-53-102.sslip.io/api/v1/payments/checkout/initiate \
  -H 'X-SBU-Key: sbu_...' -H 'Content-Type: application/json' \
  -d '{
    "amount": 10.00,
    "currencyCode": "840",
    "itemName": "Invoice INV-1042",
    "returnUrl": "https://yourapp.example/payment/return"
  }'

# 3. Redirect the customer to the returned paymentUrl, then poll:
curl 'https://13-247-53-102.sslip.io/api/v1/payments/{orderReference}?refresh=true' -H 'X-SBU-Key: sbu_...'

How it fits together

Head office registers SBUs with the X-Admin-Key and hands each team its own X-SBU-Key.
SBUs initiate payments — hosted checkout for a redirect flow, or express checkout (Ecocash USSD push, InnBucks code, Omari/SmileCash OTP, card 3DS) to keep customers in their own UI.
Smile&Pay posts the final result to our webhook; SBUs can also poll with ?refresh=true.
Reports show who receives how much and which methods are used most — per SBU or group-wide.