Flutterwave GiveWP

Accept donations on your WordPress website using Flutterwave via the GiveWP donation plugin.

This plugin allows nonprofits and organizations using GiveWP to securely collect donations through Flutterwave’s global payment infrastructure.

Flutterwave supports multiple payment methods including cards, bank transfers, mobile money, USSD, and wallets, enabling donors across Africa and globally to donate easily.

---

Table of Contents

1. Introduction
2. Features
3. Requirements
4. Installation
5. Configuration
6. Best Practices
7. Debugging Errors
8. Support
9. Contribution Guidelines
10. License
11. Changelog

---

Introduction

The Flutterwave GiveWP Plugin enables organizations using GiveWP to accept donations directly through the Flutterwave payment gateway.

Flutterwave provides a secure and reliable payment infrastructure trusted by businesses across Africa and globally.

With this plugin, donors can make payments using multiple local and international payment methods without leaving your donation page.

---

Features

• Accept donations via Credit & Debit Cards
• Support for Bank Transfers
• Mobile Money payments
• USSD payments
• Global payment support
• Secure payment processing via Flutterwave APIs
• Compatible with GiveWP donation forms
• Easy configuration within WordPress admin

---

Requirements

Before installing the plugin, ensure the following:

1. A Flutterwave Business Account
2. Your Flutterwave API Keys
3. WordPress
4. GiveWP Plugin 4.5.0 or later
5. Supported PHP Version: >= 7.4

---

Installation

1. Install the plugin from a release zip. Do not clone this repository into wp-content/plugins on a live site: it contains development files (tests/, compose.yml with local database credentials, Composer files) that should not be web-accessible. Build a release zip with wp dist-archive ., which honours .distignore.
2. Activate the Flutterwave GiveWP plugin from the WordPress admin > Plugins screen.
3. Install and activate the GiveWP plugin if you haven’t already.

Configuration

1. Go to Donations > Settings > Payment Gateways in WordPress.
2. Enable Flutterwave and enter your Flutterwave Live Secret Key and Test Secret Key. GiveWP test mode decides which one is used; a key that does not match the mode is refused.
3. Copy the webhook URL shown under Webhook Secret Hash into the Flutterwave dashboard, and set the same secret hash in both places. Webhooks are rejected without it.

Running Tests

This project includes a PHPUnit test suite covering core gateway logic.

1. Install dependencies:

   composer install

2. Run the full test suite:

   ./vendor/bin/phpunit

Best Practices

• Keep your Flutterwave keys secure and never commit them to source control.
• Use a separate Flutterwave sandbox account for development/testing.

Debugging Errors

• Enable WordPress debugging in wp-config.php:

  define('WP_DEBUG', true);
  define('WP_DEBUG_LOG', true);
  define('WP_DEBUG_DISPLAY', false);

• Check wp-content/debug.log for errors generated by the plugin.

Support

If you run into issues, open an issue in this repository with as much detail as possible (PHP version, WordPress version, GiveWP version, and steps to reproduce).

Contribution Guidelines

Contributions are welcome! Please:

• Fork the repo and create a feature branch.
• Add tests for new behavior.
• Submit a pull request with a clear description of changes.

License

This project is licensed under the MIT License. See LICENSE for details.

Changelog

See CHANGELOG.md for release notes.