Wave Webhooks

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.

API entry from apis.yml

apis.yml Raw ↑
aid: wave-mobile-money:wave-webhooks
name: Wave Webhooks
description: 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.
humanURL: https://docs.wave.com/webhook
baseURL: https://api.wave.com
tags:
- Webhooks
- Events
- HMAC
- Asynchronous
properties:
- type: Documentation
  url: https://docs.wave.com/webhook
- type: Documentation
  url: https://docs.wave.com/business