Flutterwave setup

Flutterwave covers pan-African payments as well as international cards, making it a flexible option if your buyers span multiple regions. It’s a Pro and Agency feature.

Connecting Flutterwave

1. Log in to your Flutterwave dashboard and copy your API keys
2. In WordPress, go to Payment Settings → Gateways → Flutterwave and paste in your keys
3. Choose your own secret value, enter it in Flutterwave under Settings → Webhooks → Secret Hash, and also register the webhook URL shown on the Flutterwave tab in Payment Settings (it looks like https://yoursite.com/?acquis_pay_webhook=1&gateway=flutterwave)
4. Paste that same secret value into the Webhook verif-hash Secret field on the Flutterwave tab in Payment Settings, then save
5. Run a small test transaction end to end

Why the webhook step matters

The redirect flow re-verifies a transaction as soon as the buyer returns to your site, but the webhook is what confirms a payment when that redirect doesn’t happen (a closed tab, a network drop). If the Secret Hash doesn’t match on both sides, those webhook confirmations are silently rejected. See Common errors if a payment isn’t completing.

How it works

Like Paystack, Flutterwave uses a redirect checkout flow, with the transaction re-verified server-side after the buyer returns to your site, before the order is marked paid.