Flutterwave WooCommerce


Accept Credit card, Debit card and Bank account payment directly on your store with the official Flutterwave Plugin for WooCommerce.

Plugin Features

  • Collections: Card, Account, Mobile money, Bank Transfers, USSD, Barter, 1voucher.
  • Recurring payments: Tokenization and Subscriptions.
  • Split payments: Split payments between multiple recipients.


  1. Flutterwave for business API Keys
  2. WooCommerce
  3. Supported PHP version: 7.4.0 — 8.1.0



Automatic Installation

  • Login to your WordPress Dashboard.
  • Click on «Plugins > Add New» from the left menu.
  • In the search box type Flutterwave Woocommerce.
  • Click on Install Now on Flutterwave Woocommerce to install the plugin on your site.
  • Confirm the installation.
  • Activate the plugin.
  • Click on «WooCommerce > Settings» from the left menu and click the «Checkout» tab.
  • Click on the Flutterwave link from the available Checkout Options
  • Configure your Flutterwave Woocommerce settings accordingly.

Manual Installation

  1. Download the plugin zip file.
  2. Login to your WordPress Admin. Click on «Plugins > Add New» from the left menu.
  3. Click on the «Upload» option, then click «Choose File» to select the zip file you downloaded. Click «OK» and «Install Now» to complete the installation.
  4. Activate the plugin.
  5. Click on «WooCommerce > Settings» from the left menu and click the «Checkout» tab.
  6. Click on the Flutterwave link from the available Checkout Options
  7. Configure your Flutterwave WooCommerce settings accordingly.

For FTP manual installation, check here.

Configure the plugin

To configure the plugin, go to WooCommerce > Settings from the left menu, click Checkout tab. Click on Flutterwave.

  • Enable/Disable — check the box to enable Flutterwave WooCommerce.
  • Pay Button Public Key — Enter your public key which can be retrieved from the «Pay Buttons» page on your Flutterwave account dashboard.
  • Modal Title — (Optional) customize the title of the Pay Modal. Default is Flutterwave.
  • Click Save Changes to save your changes.


Handle Webhooks from Flutterwave with two new actions in WooCommerce.
* flw_webhook_after_action : This action is fired after a transaction is completed and returns the transaction details (json).
* flw_webhook_transaction_failure_action : This action is fired when a transaction fails and returns the transaction details (json).

Best Practices

  1. When in doubt about a transaction, always check the Flutterwave Dashboard to confirm the status of a transaction.
  2. Always ensure you keep your API keys securely and privately. Do not share with anyone
  3. Ensure you change from the default secret hash on the WordPress admin and apply same on the Flutterwave Dashboard
  4. Always ensure you install the most recent version of the Flutterwave WordPress plugin

Debugging Errors

We understand that you may run into some errors while integrating our plugin. You can read more about our error messages here.

For authorization and validation error responses, double-check your API keys and request. If you get a server error, kindly engage the team for support.


For additional assistance using this library, contact the developer experience (DX) team via email or on slack.

You can also follow us @FlutterwaveEng and let us know what you think 😊.

Contribution guidelines

We love to get your input. Read more about our community contribution guidelines here


By contributing to the Flutterwave WooCommerce, you agree that your contributions will be licensed under its MIT license.


What Do I Need To Use The Plugin

  1. You need to open an account on Flutterwave for Business


24 Օգոստոսի, 2022 4 replies
After updating your plugin i get A Blank WordPress Admin Panel. This happened immediately i updated to Version 2.3.0. When i disable the plugin, everything works right. When i reinstall the older plugin it works well.
22 Ապրիլի, 2021 1 reply
Activating the plugin caused my dashboard go blank. Please do not install. ZERO RATING
Read all 9 reviews

Contributors & Developers

“Flutterwave WooCommerce” is open source software. The following people have contributed to this plugin.




  • Added: Support for HPOS.
  • Fixed: compatibility with WooCommerce 7.1 to 6.9.1


  • Fix: Webhook Handler Acknowledgement.


  • Added: Support for WooCommerce Blocks.
  • Updated: WooCommerce Checkout Process.


  • Fix: Handled MobileMoney Payment Handler Error.


  • Fixed: PHP 8 support for v3 Webhook Handler.


  • Fixed: Woocommerce Subscription processing function error.
  • New Feat: Switched to WC-Logger class for logging.


  • fix: on payment completion redirect to order reciept page (redirect Method)
  • fix: PHP 8.0 compatibility ( optional method parameter )


  • Use one base URL for live and test mode.

  • Merchants can get their test and live keys here

  • Using test keys keeps you in test mode, to move to live mode add live keys.

  • Support for Woocommerce recurring, this allows merchants to collect recurring payments in woocommerce.


  • Support for Woocommerce recurring, this allows merchants to collect recurring payments in woocommerce.


  • Support for new currencies (ZMW, UGX, RWF, TZS, SLL).


  • Add redirect style with admin toogle for redirect or popup payment style
  • Custom gateway name
  • Bug fixes for country


  • First release