/woo-paystack

Paystack payment gateway for WooCommerce.

Primary LanguagePHP

Paystack WooCommerce Payment Gateway

Contributors: tubiz

Donate link: https://bosun.me/donate

Tags: paystack, woocommerce, payment gateway, interswitch, tubiz plugins, verve, ghana, nigeria, mastercard, visa

Requires at least: 4.4

Tested up to: 4.9

Stable tag: 5.1.0

License: GPLv2 or later

License URI: http://www.gnu.org/licenses/gpl-2.0.html

Paystack WooCommerce Payment Gateway allows you to accept online payments from local and international customers

Description

This is a Paystack payment gateway for WooCommerce.

Paystack is on a mission to deliver a safe and convenient payment experience for customers and merchants. Paystack provide Nigerian & Ghanaian merchants with the tools and services needed to accept online payments from local and international customers using Mastercard, Visa, Verve Cards and Bank Accounts.

To signup for a Paystack Merchant account visit their website by clicking here

Paystack WooCommerce Payment Gateway allows you to accept payment on your WooCommerce store using MasterCard, Visa, Verve Cards and bank accounts.

With this Paystack WooCommerce Payment Gateway plugin, you will be able to accept the following payment methods in your shop:

  • MasterCard
  • Visa
  • Verve Card
  • Bank Account

Note

This plugin is meant to be used by merchants in Nigeria and Ghana.

Plugin Features

  • Accept payment via Mastercard, Visa, Verve Card and Bank Accounts.
  • Seamless integration into the WooCommerce checkout page. Accept payment directly on your site
  • Recurring payment using WooCommerce Subscriptions plugin

WooCommerce Subscriptions Integration

  • The WooCommerce Subscriptions integration only works with WooCommerce v2.6 and above and WooCommerce Subscriptions v2.0 and above.

  • No subscription plans is created on Paystack. The WooCommerce Subscriptions plugin handles all the subscription functionality.

  • If a customer pays for a subscription using a MasterCard or Visa card, their subscription will renew automatically throughout the duration of the subscription. If an automatic renewal fail their subscription will be put on-hold and they will have to login to their account to renew the subscription.

  • For customers paying with a Verve Card, their subscription can't be renewed automatically, once a payment is due their subscription will be on-hold. The customer will have to login to his account to manually renew his subscription.

  • If a subscription has a free trial and no signup-fee, automatical renewal is not possible for the first payment because the initial order total will be 0, after the free trial the subscription will be put on-hold. The customer will have to login to his account to renew his subscription. If a MasterCard or Visa card is used to renew the subscription subsequent renewals will be automatic throughout the duration of the subscription, if a Verve card is used automatic renewal isn't possible.

Suggestions / Feature Request

If you have suggestions or a new feature request, feel free to get in touch with me via the contact form on my website here

You can also follow me on Twitter! @tubiz

Installation

Automatic Installation

  • Login to your WordPress Admin area
  • Go to "Plugins > Add New" from the left hand menu
  • In the search box type Paystack Woocommerce Payment Gateway
  • From the search result you will see Paystack Woocommerce Payment Gateway click on Install Now to install the plugin
  • A popup window will ask you to confirm your wish to install the Plugin.
  • After installation, activate the plugin.
  • Open the settings page for WooCommerce and click the "Checkout" tab.
  • Click on the Paystack link from the available Checkout Options
  • Configure your Paystack Payment Gateway settings. See below for details.

Manual Installation

  1. Download the plugin zip file
  2. Login to your WordPress Admin. Click on "Plugins > Add New" from the left hand menu.
  3. Click on the "Upload" option, then click "Choose File" to select the zip file from your computer. Once selected, press "OK" and press the "Install Now" button.
  4. Activate the plugin.
  5. Open the settings page for WooCommerce and click the "Checkout" tab.
  6. Click on the Paystack link from the available Checkout Options
  7. Configure your Paystack Payment Gateway settings. See below for details.

Configure the plugin

To configure the plugin, go to WooCommerce > Settings from the left hand menu, then click Checkout from the top tab. You will see Paystack as part of the available Checkout Options. Click on it to configure the payment gateway.

  • Enable/Disable - check the box to enable Paystack Payment Gateway.
  • Title - allows you to determine what your customers will see this payment option as on the checkout page.
  • Description - controls the message that appears under the payment fields on the checkout page. Here you can list the types of cards you accept.
  • Test Mode - Check to enable test mode. Test mode enables you to test payments before going live. If you ready to start receving real payment on your site, kindly uncheck this.
  • Test Secret Key - Enter your Test Secret Key here. Get your API keys from your Paystack account under Settings > Developer/API
  • Test Public Key - Enter your Test Public Key here. Get your API keys from your Paystack account under Settings > Developer/API
  • Live Secret Key - Enter your Live Secret Key here. Get your API keys from your Paystack account under Settings > Developer/API
  • Live Public Key - Enter your Live Public Key here. Get your API keys from your Paystack account under Settings > Developer/API
  • Click on Save Changes for the changes you made to be effected.

Frequently Asked Questions

What Do I Need To Use The Plugin

  1. You need to have WooCommerce plugin installed and activated on your WordPress site.
  2. You need to open a Paystack merchant account on Paystack

WooCommerce Subscriptions Integration

  • The WooCommerce Subscriptions integration only works with WooCommerce v2.6 and above and WooCommerce Subscriptions v2.0 and above.

  • No subscription plans is created on Paystack. The WooCommerce Subscriptions handles all the subscription functionality.

  • If a customer pays for a subscription using a MasterCard or Visa card, their subscription will renew automatically throughout the duration of the subscription. If an automatic renewal fail their subscription will be put on-hold and they will have to login to their account to renew the subscription.

  • For customers paying with a Verve Card, their subscription can't be renewed automatically, once a payment is due their subscription will be on-hold. The customer will have to login to his account to manually renew his subscription.

  • If a subscription has a free trial and no signup-fee, automatical renewal is not possible because the order total will be 0, after the free trial the subscription will be put on-hold. The customer will have to login to his account to renew his subscription. If a MasterCard or Visa card is used to renew subsequent renewals will be automatic throughout the duration of the subscription, if a Verve card is used automatic renewal isn't possible.

Changelog

5.1.0, March 27, 2018

  • New: Add support for GHS (Ghanaian cedi) currency
  • Fix: Deprecated WooCommerce 2.X functions

5.0.2, September 15, 2017

  • Fix: Illegal string offset warnings when plugin is newly installed

5.0.1, September 14, 2017

  • Fix: Fatal error on the checkout page if WooCommerce 2.6.14 and below is installed

5.0.0, August 29, 2017

  • New: Add support for Paystack custom filters
  • New: Create additional Paystack gateways (max of 5) using different custom filters. You can create a gateway that accepts only Verve cards, a gateway that accepts only bank account payments, a gateway that accepts only GTB issued Mastercard.

4.1.0, July 7, 2017

  • Fix: Deprecated WooCommerce 2.X functions

4.0.1, April 10, 2017

  • Fix: Fatal error if WooCommerce 2.6.14 and below is installed

4.0.0, April 10, 2017

  • New: Add support for Paystack Inline Embed.
  • New: Add support for sending additional order details to Paystack

3.1.1, February 13, 2017

  • New: Changed Paystack payment methods icon.

3.1.0, January 10, 2017

  • New: Add support for USD and GBP currency. Note this has to be enabled by Paystack for your account before it can be used on your site.

3.0.0, November 11, 2016

2.1.0, October 15, 2016

  • New: Add support for confirming payment using the webhook url

2.0.1, July 5, 2016

  • Fix: Paystack payment option and settings not available if Paystack WooCommerce Payment Gateway version 2.0.0 is installed and WooCommerce version 2.5.5 and below is installed

2.0.0, June 28, 2016

  • New: Saved cards - allow store customers to save their card details and pay again using the same card. Card details are saved on Paystack servers and not on your store.
  • Fix: Change payment icon

1.1.0, April 22, 2016

  • Fix: Fatal error if the WooCommerce plugin is deactivated while the Paystack plugin is active

1.0.0, February 3, 2016

  • First release

Upgrade Notice

5.1.0

  • Add support for GHS (Ghanaian cedi) currency for merchants in Ghana

Screenshots

1. Paystack WooCommerce Payment Gateway Setting Page

Screenshot 1

2. Paystack WooCommerce Payment Gateway on the checkout page

Screenshot 2

3. Paystack inline payment page

Screenshot 3

4. Paystack inline embed payment page

Screenshot 4

5. Manage saved cards from your account page

Screenshot 5