​

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:

• Email: info@mavapay.co
• Documentation: https://docs.mavapay.co
• API Reference: https://docs.mavapay.co/api-reference