FAQ

For merchants

What is the "Webhook Secret Hash"?

A value you choose and enter in two places: the Flutterwave dashboard (Settings → Webhooks) and the plugin configuration. Flutterwave sends it back with every webhook so the plugin knows the request is genuine. It is not an API key. Use a different value for test and live.

Which payment options will customers see?

The options enabled on your Flutterwave account for the currency and country. The plugin's Payment Options setting has no effect in 0.9.0-beta.1.

Why does Flutterwave's page show "Developed with ❤️ by Kommandhub"?

That is the default description when the Description setting is empty. Enter your own text under Configuration → Customization.

My logo does not appear on Flutterwave's page.

Known issue in 0.9.0-beta.1: the logo setting sends a media ID where Flutterwave expects an image URL.

How long do refunds take?

Flutterwave states refunds usually take 3–15 working days. The Shopware refund stays pending until Flutterwave's refund.completed webhook arrives.

Can I refund from the Flutterwave dashboard?

Yes. The plugin reads Flutterwave's live refund history when calculating what is still refundable, so dashboard refunds are counted. They are not added to the Shopware order as refund records, though — only refunds started from the order's Flutterwave tab are.

Is the BVN verified?

Only its format (11 digits). Full BVN verification needs separate approval from Flutterwave and is planned for a later release.

Are split payments supported?

Not yet; planned for 1.0.0.

Can I use different Flutterwave accounts per sales channel?

Payments and refunds use the keys of the order's sales channel, but webhooks are verified with the secret hash saved on All Sales Channels. Webhooks from a second account with a different hash are rejected, so those orders are only settled when the customer returns. One Flutterwave account (or the same hash on every account) is the supported setup.

Is it in the Shopware Store?

Not yet. Install with Composer or a ZIP — see Installation.