# 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

1. In Wave: open a **Wave Business** account in the Wave Business app or portal with your company documents.
2. 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).
3. In Dropify, go to **Apps → Discover**, open **Wave** and click **Install and connect**.
4. 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.
5. 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.
6. Go to **Store settings → Payment methods** and switch **Wave** on. Optionally set a **Discount for prepaid orders**.
7. 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 page → add 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**.
