Open-source mobile money payment APIs

Connect directly to M-Pesa Mozambique, EcoCash Zimbabwe and MTN MoMo South Africa through one self-hosted API layer. Build collections, payouts and cross-border payment flows while using your own provider accounts, regulated infrastructure and settlement relationships.

vafey.api
POST /transfers
{
  "source": "mpesa_mz",
  "destination": "ecocash_zw",
  "source_amount": 2500,
  "source_currency": "MZN",
  "recipient": "+263•••••••••",
  "reference": "transfer_1024"
}

202 ACCEPTED
{
  "status": "processing",
  "quote_id": "qt_8f24",
  "settlement": "pending",
  "payout": "queued"
}
M-Pesa · MozambiqueResearch
EcoCash · ZimbabweResearch
MTN MoMo · South AfricaResearch

Everything needed to build on mobile money rails.

Vafey gives developers a common software layer for provider integration, transaction orchestration, settlement logic and payment operations without replacing the regulated institutions that hold or move funds.

Collections and payouts

Create payment requests, initiate disbursements, receive provider callbacks and track transaction status through one API.

FX

Quotes and FX logic

Calculate source and destination amounts, apply configured rates and fees, and preserve the quote used for each transfer.

Settlement orchestration

Coordinate collection, treasury, settlement and destination payout steps across your own accounts and regulated partners.

{ }

Provider adapters

Plug in provider credentials while Vafey handles provider-specific authentication, payloads, callbacks and status mapping.

Retries and reversals

Manage failed transactions, retry rules, timeouts, reversals and compensation workflows without rebuilding them per provider.

Reconciliation

Match collections, settlements and payouts across providers using consistent references, ledgers and transaction records.

Webhooks and events

Receive normalized events for payment success, failure, expiry, settlement completion, payout and reversal status.

Audit and controls

Maintain transaction histories, configuration records, approval rules and operational logs within your own infrastructure.

Three markets. One research programme.

Vafey is researching all three provider integrations in parallel. We have access to the relevant APIs and are validating how they can operate through one common architecture.

Research stage

M-Pesa Mozambique

Collections, payouts, authentication, callbacks, transaction status and the role of MZN accounts in cross-border payment flows.

Research stage

EcoCash Zimbabwe

Collections, disbursements, wallet operations and how EcoCash can participate in transfers originating from or terminating in Zimbabwe.

Research stage

MTN MoMo South Africa

Provider capabilities, account structures, transaction flows and interoperability within a differently regulated payments market.

Cross-border orchestration

Build the complete flow between two mobile money systems.

Use Vafey to connect your own regulated infrastructure to both sides of a payment corridor and coordinate everything required between collection and final payout.

1. Collect

Initiate and confirm payment from the sender through the source mobile money provider.

2. Quote

Calculate the exchange rate, fees, destination amount and quote validity using your own pricing rules.

3. Settle

Trigger and track settlement through your own treasury accounts, banking relationships or regulated settlement partners.

4. Pay out

Release the destination payment after the required settlement and operational conditions are satisfied.

Open Payments

Compatible payment flows across mobile money rails.

Vafey is researching how Open Payments resources can sit above provider-specific mobile money operations while the underlying accounts, compliance controls and settlement infrastructure remain under the operator’s control.

  • Wallet-address-based payment experiences.
  • Incoming payments, quotes and outgoing payments mapped to provider actions.
  • Explicit authorization for access to protected payment resources.
  • Rafiki-compatible integration patterns for Open Payments implementations.
100% self-hosted

Run Vafey on your own infrastructure.

Vafey is free and open source. You provide the provider credentials, regulated accounts, compliance controls, treasury arrangements and settlement partners. Vafey provides the software layer that connects and orchestrates the payment flow.

  • Source code and provider-adapter framework
  • Collections, payouts, transfer orchestration and reconciliation
  • FX quotes, fees, settlement states and payout controls
  • API documentation, sample flows and local deployment instructions
  • Open Payments and Rafiki integration components