Flutterwave WooCommerce

Installation

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.

Webhooks

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.

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

License

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