forked from tubiz/woo-paystack
-
Notifications
You must be signed in to change notification settings - Fork 0
/
readme.txt
159 lines (96 loc) · 8.65 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
=== Paystack WooCommerce Payment Gateway ===
Contributors: tubiz
Donate link: http://bosun.me/donate
Tags: paystack, woocommerce, payment gateway, interswitch, tubiz plugins, verve, nigeria, mastercard, visa
Requires at least: 4.4
Tested up to: 4.6
Stable tag: 3.0.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 merchants with the tools and services needed to accept online payments from local and international customers using MasterCard, Visa and Verve Cards.
To signup for a Paystack Merchant account visit their website by clicking [here](https://paystack.com)
Paystack Woocommerce Payment Gateway allows you to accept payment on your Woocommerce store using MasterCard, Visa and Verve Cards.
With this Paystack Woocommerce Payment Gateway plugin, you will be able to accept the following payment methods in your shop:
* __MasterCard__
* __Visa__
* __Verve Card__
= Note =
This plugin is meant to be used by merchants in Nigeria.
= Plugin Features =
* __Accept payment__ via MasterCard, Visa and Verve Card.
* __Seamless integration__ into the WooCommerce checkout page. Accept payment directly on your site
* __Recurring payment__ using [WooCommerce Subscriptions](https://woocommerce.com/products/woocommerce-subscriptions/) plugin
= WooCommerce Subscriptions Integration =
* The [WooCommerce Subscriptions](https://woocommerce.com/products/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](https://woocommerce.com/products/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](http://bosun.me/get-in-touch/)
You can also follow me on Twitter! **[@tubiz](http://twitter.com/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](https://paystack.com)
= WooCommerce Subscriptions Integration =
* The [WooCommerce Subscriptions](https://woocommerce.com/products/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](https://woocommerce.com/products/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 ==
= 3.0.0, November 11, 2016 =
* New: Add support for recurring payment using [WooCommerce Subscriptions](https://woocommerce.com/products/woocommerce-subscriptions/) plugin.
= 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 ==
= 3.0.0 =
* Add support for recurring payment using WooCommerce Subscriptions plugin
== Screenshots ==
1. Paystack WooCommerce Payment Gateway Setting Page
2. Paystack WooCommerce Payment Gateway on the checkout page
3. Paystack payment field displayed directly on your site
4. Manage saved cards from your account page