Skip to content

Take donations and payments for services on your WordPress site using Rave.

License

Notifications You must be signed in to change notification settings

Flutterwave/WordPress-v2

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Flutterwave Payments

Introduction

The WordPress Plugin makes it very easy and quick to add Flutterwave Payment options on your eCommerce site, Donation Page or a list of Payment Subscriptions you want your clients to subscribe to.

Take donations and payments for services on your WordPress site using Flutterwave.

Description

Available features include:

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

Table of Contents

  1. Requirements
  2. Installation
  3. Initialization
  4. Best Practices
  5. Debugging Errors
  6. Support
  7. Contribution guidelines
  8. License
  9. Changelog

Requirements

  1. Flutterwave for business API Keys
  2. Supported PHP version: 7.4 or higher
  3. For Elementor: Elementor version: 2.8.0 or higher

Installation

Automatic Installation

  • Login to your WordPress Dashboard.
  • Click on "Plugins > Add New" from the left menu.
  • In the search box type Flutterwave Payments.
  • Click on Install Now on Flutterwave Payments to install the plugin on your site.
  • Confirm the installation.
  • Activate the plugin.
  • Go to "Rave > Settings" from the left menu to configure the plugin.

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.
  • Go to "Rave > Settings" from the left menu to configure the plugin.

For FTP manual installation, check here.

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 WooCommerce 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 😊.

Configure the plugin

To configure the plugin, go to Rave > Settings from the left menu.

Rave Settings Screenshot

  • Pay Button Public Key - Enter your public key which can be retrieved from "Pay Buttons" page on your Rave account dashboard.
  • Recurring Payments - To enable recurring payments/subscription for your users, click the Enable Recurring Payment 'checkbox' to enable it. Go to your Rave Dashboard, navigate to 'Payment Plans' and click the 'Create Payment Plan' button to create a payment plan with an interval. The intervals accepted for this plugin are WEEKLY, MONTHLy, QUARTERLY, ANNUALLY/YEARLY.
  • Modal Title - (Optional) customize the title of the Pay Modal. Default is FLW PAY.
  • Modal Description - (Optional) customize the description on the Pay Modal. Default is FLW PAY MODAL.
  • Modal Logo - (Optional) customize the logo on the Pay Modal. Enter a full url (with 'http'). Default is Rave logo.
  • Success Redirect URL - (Optional) The URL the user should be redirected to after a successful payment. Enter a full url (with 'http'). Default: "".
  • Failed Redirect URL - (Optional) The URL the user should be redirected to after a failed payment. Enter a full url (with 'http'). Default: "".
  • Pay Button Text - (Optional) The text to display on the button. Default: "PAY NOW".
  • Charge Currency - (Optional) The currency the user is charged. Default: "NGN".
  • Charge Country - (Optional) The country the merchant is serving. Default: "NG: Nigeria".
  • Form Style - (Optional) Disable form default style and use the activated theme style instead.
  • Click Save Changes to save your changes.

Styling

You can enable default theme's style to override default form style from the Settings page. Or you can override the form class .flw-simple-pay-now-form from your stylesheet.

Usage

####1. Shortcode

Insert the shortcode anywhere on your page or post that you want the form to be displayed to the user.

Basic: requires the user to enter amount and email to complete payment

[flw-pay-button]

With button text:

[flw-pay-button]Button Text[/flw-pay-button]

With attributes: email or use_current_user_email with value "yes", amount

[flw-pay-button amount="1290" email="customer@email.com" ]

or

[flw-pay-button amount="1290" use_current_user_email="yes" ]

With attributes and button text: email, amount

[flw-pay-button amount="1290" email="customer@email.com" ]Button Text[/flw-pay-button]

or

[flw-pay-button amount="1290" email="customer@email.com" split_name=1 ]Button Text[/flw-pay-button]


With custom and excluded fields.

[flw-pay-form amount=1234 fullname="Abraham Olaobaju" currency="USD,UGX,NGN" custom_fields='age:number,color:select|black:#000|white:#fff' exclude="phone"]

With order rearranged.

[flw-pay-form amount=1234 fullname="Abraham Olaobaju" currency="USD,UGX,NGN" order="currency,fullname,amount,phone,email"]

Donation Form.

[flw-donation-form]

####2. Visual Composer

The shortcode can be added via Visual Composer elements.

  • On Visual Composer Add Element dialog, click on "Rave Forms" and select the type of form you want to include on your page. Visual Composer Screenshot 1

  • On the "Form Settings" dialog, fill in the form attributes and click "Save Changes". Visual Composer Screenshot 2

  • Payment Form successfully added to the page. Visual Composer Screenshot 3

Transaction List

All the payments made through the forms to Rave can be accessed on Rave > Transactions page.

Rave Transactions Screenshot

Contribution guidelines

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

License

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

Copyright (c) Flutterwave Inc.

About

Take donations and payments for services on your WordPress site using Rave.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 75.5%
  • CSS 8.6%
  • Shell 7.2%
  • JavaScript 7.1%
  • HTML 0.6%
  • Dockerfile 0.5%
  • Other 0.5%