Skip to main content

​
Payouts

Mavapay allows you to send money to bank accounts and mobile money accounts in supported countries using Bitcoin Lightning Network. We currently support payouts to:
  1. Nigerian Naira (NGN)
  2. South African Rand (ZAR)
  3. Kenyan Shilling (KES)

​
Overview

The payout process generally involves:
  1. Creating a quote for the amount you want to pay out
  2. Paying the generated lightning invoice
  3. Receiving webhook notifications for payment status

​
Currency-Specific Requirements

​
Nigerian Naira (NGN)

  • Amounts are denominated in Kobo (1 NGN = 100 Kobo)
  • Minimum payout amount: 2000 NGN
  • Requires bank account validation before payout
  • Supports customer internal fees
  • View NGN Payout Documentation

​
South African Rand (ZAR)

  • Amounts are denominated in cents (1 ZAR = 100 cents)
  • No bank account validation required
  • Customer internal fees currently disabled
  • View ZAR Payout Documentation

​
Kenyan Shilling (KES)

  • Amounts are denominated in cents (1 KES = 100 cents)
  • All payments processed through M-Pesa
  • Supports three M-Pesa payment modes:
    1. Mobile Money (pay to phone number)
    2. Pay to Bill (business payments)
    3. Pay to Account/Till
  • View KES Payout Documentation

​
Webhook Events

For all payouts, you’ll receive two webhook events:
  1. payment.received - When we receive the lightning payment
  2. payment.sent - When the money is sent to the recipient
For detailed webhook implementation, see our webhook documentation.

​
Testing

Use our staging environment for testing: 
https://staging.api.mavapay.co/api/v1
Note: All test environment invoices are signet invoices.

​
Support

If you need help with integration: