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.
Requirements
- Flutterwave for business API Keys
- WooCommerce
- 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
- Download the plugin zip file.
- Login to your WordPress Admin. Click on "Plugins > Add New" from the left menu.
- 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.
- 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.
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
- When in doubt about a transaction, always check the Flutterwave Dashboard to confirm the status of a transaction.
- Always ensure you keep your API keys securely and privately. Do not share with anyone
- Ensure you change from the default secret hash on the Wordpress admin and apply same on the Flutterwave Dashboard
- 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.