How do I accept Wave mobile money payments on my store?
Wave lets customers in Senegal and Côte d'Ivoire pay from the Wave app: they scan a QR code on a computer or open the Wave app on their phone and approve the payment. Payments are in West African CFA francs (XOF); if your store uses another currency, the order total is converted to XOF at checkout. The money goes straight to your Wave Business wallet.
Steps
- In Wave: open a Wave Business account in the Wave Business app or portal with your company documents.
- As an admin, open the Developer section of the Wave Business Portal and create an API key with the Checkout permission. Copy it (Wave shows it once).
- In Dropify, go to Apps → Discover, open Wave and click Install and connect.
- On the app page, click Connect Wave (or Add account), name the account, paste the API key and click Add account. We test the key with Wave before saving.
- Recommended: copy the address under Webhook URL (Copy webhook URL), add it as a webhook in the same Developer section of the Wave portal, then edit your account in Dropify and paste the Webhook secret Wave gives you. Orders then turn paid even if the customer never comes back to your store.
- Go to Store settings → Payment methods and switch Wave on. Optionally set a Discount for prepaid orders.
- Test with a small real amount: Wave has no test mode, so every payment is real.
Common problems
- "Wave rejected these keys…"the key was revoked, copied incompletely, or lacks the Checkout permission. Create a new key and paste it again.
- Paid orders stay unpaid when the customer closes the pageadd the Webhook URL in the Wave portal and paste its secret in your account.
- "Wave can only refund the whole payment…"refund the full amount, or refund part of it outside Wave and record it as manual.
- Customers see "This payment method is temporarily unavailable"edit the account, paste a working key and click Test keys.