Wave Mobile Money API

Automate Wave business payment APIs for checkout, payouts, and balance management.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/AfricanDigitalAssetFramework/africa-stack-skills --skill wave-mobile-money-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Wave Mobile Money API
Source: https://github.com/AfricanDigitalAssetFramework/africa-stack-skills/tree/main/pan-african/uemoa/wave
Command: npx skills add https://github.com/AfricanDigitalAssetFramework/africa-stack-skills --skill wave-mobile-money-api

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Wave provides a comprehensive suite of business APIs for checkout, payouts, and balance management, enabling developers to integrate mobile money payments in West Africa without building core payment infrastructure from scratch.

Core Features & Use Cases

  • Checkout API to create payment sessions for customer payments
  • Payout API to transfer funds to recipients identified by phone numbers
  • Balance API to check wallet balances and transaction history
  • Webhooks for real-time notifications of checkout and payout events
  • Onboarding notes and multi-country considerations for currency handling (XOF in WA region)

Quick Start

Create a checkout session for a customer payment and configure webhook handling to finalize the order.

Frequently Asked Questions about Wave Mobile Money API

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate Wave mobile money payments into my application?

You can integrate Wave mobile money by using the business payment APIs for checkout, payouts, and balance management. This allows your application to collect customer payments, disburse funds to phone numbers, and query wallet balances securely.

How do I handle real-time Wave checkout and payout events in my workflow?

You handle real-time Wave checkout and payout events by configuring webhooks. Webhooks deliver real-time notifications to your application, allowing you to automatically finalize orders and confirm transaction statuses without polling.

Can I use the Wave payouts API to send mobile money to recipients in West Africa?

Yes, the Wave payouts API supports transferring funds to recipients identified by phone numbers across Senegal and other supported West African countries, requiring attention to currency handling considerations like XOF.

Do I need API keys to authenticate Wave mobile money API requests?

Yes, you need API keys to authenticate requests to the Wave mobile money API. The integration process includes API key authentication to ensure secure access to checkout, payout, and balance endpoints.

What is the best way to manage multi-country currency considerations when using Wave mobile money APIs?

The best way to manage multi-country currency considerations is to follow the onboarding notes provided for handling currencies like XOF in the WA region. The API includes specific error handling and multi-country considerations for supported countries.