# Wave Webhooks

**Canonical:** https://apis.io/apis/wave-mobile-money/wave-webhooks/  
**Provider:** Wave Mobile Money — https://apis.io/providers/wave-mobile-money/  
**Base URL:** https://api.wave.com  
**Documentation:** https://docs.wave.com/webhook

Wave Webhooks is one of 5 APIs that [Wave Mobile Money](https://apis.io/providers/wave-mobile-money/) publishes on the [APIs.io](https://apis.io/) network. Tagged areas include Webhook, Event, HMAC, and Asynchronous. The published artifact set on APIs.io includes API documentation.

Outbound event delivery channel for asynchronously notifying merchant systems when state changes on the Wave platform. Events include checkout.session.completed, checkout.session.payment_failed, b2b.payment_received, b2b.payment_failed, merchant.payment_received, and test.test_event for portal-triggered smoke tests. Every delivery carries a Wave-Signature header containing a Unix timestamp and one or more HMAC-SHA256 signatures over the raw body; receivers must validate the signature and reject deliveries older than five minutes to prevent replay. Event payloads use a Stripe-style envelope (id, type, data) and the id field should be used to enforce at-least-once-delivery idempotency.

## Machine-readable artifacts (2)

- **Documentation** — https://docs.wave.com/webhook
- **Documentation** — https://docs.wave.com/business

## Other Wave Mobile Money APIs (4)

- [Wave Checkout API](https://apis.io/apis/wave-mobile-money/wave-checkout-api/)
- [Wave Payout API](https://apis.io/apis/wave-mobile-money/wave-payout-api/)
- [Wave Balance & Reconciliation API](https://apis.io/apis/wave-mobile-money/wave-balance-reconciliation-api/)
- [Wave Aggregated Merchants API](https://apis.io/apis/wave-mobile-money/wave-aggregated-merchants-api/)

## Tags

Webhook, Event, HMAC, Asynchronous

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/wave-mobile-money/wave-webhooks/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/wave-mobile-money/.