=== WithinWeb WordPress PHP-KeyCodes ===
Contributors: paulvgibbs
Donate link:  https://www.withinweb.com/wordpresskeycodes/donation.php
Tags: license keys, software license codes, key codes, pin codes, sell pin codes, mobile phone pins, digital goods with PayPal
Requires at least: 4.7.0
Tested up to: 4.8.2
Stable tag: 1.0.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Sell software license key codes or pin numbers automatically using PayPal.


== Description ==

This Plugin enables you to sell software license key codes, pin numbers, mobile phone key codes or similar codes, automatically when someone makes a PayPal purchase.

The pin numbers are listed in the database one entry per line and when a purchase is made, PayPal sends an IPN notification to the plugin which then extracts the first pin number, sends it to the purchaser and then removes that pin number from the list.

The email sent to the purchaser contains the pin number, and you should receive a copy of the email.

A local test system is included which allows you to test without connecting to PayPal.

Setting a value in the Lower Limit entry box causes an email to be sent to the administrator when the minimum number of key codes has been reached.

The system has a high level of security in that the key code will not be sent out until the correct PayPal return code is received with the correct purchase values.  The system checks that the database value is the same as the amount that has been spent, and the currency code is the correct value.  This ensures that any alteration to the button code will not work.

== Installation ==

This section describes how to install the plugin and get it working.

1. In the admin area of your WordPress site, click on 'New Plugin' and then click on 'Upload Plugin'.  Browse for the 'withinweb_wwkc_keycodes.zip' on your computer and click on 'Install now'.
2.  Activate the plugin once it has been uploaded and un-zipped.
3.  In the 'Settings' of the KeyCodes menu, you must enter in your <strong>PRIMARY</strong> PayPal email address for payments, and an appropriate admin email address.
4.  Create an item and enter in the key codes in the key codes field one line at a time.
5.  You may test the system using a local test without connecting to PayPal.
6.  In 'Settings' make sure you have selected the PayPal enviromment that you want to use, as either PayPal live or PayPal sandbox.
7.  To display the PayPal button on your WordPress page, use the short code [keycodesbutton recid='x'] where x is the record id of the product item.  Or you can use the HTML code displayed from the 'Item List' Page.  You can get the record id of the product by going to 'Item List'.

PayPal activation

Make sure that you have enabled IPN in your PayPal account.  You may also have to enter in the IPN Call Back URL which you can get from the 'Settings' menu of the plugin.

The call back url is acutally sent to PayPal as part of the button submission, which means that the url entered in PayPal setup can be different to the url needed for this plugin.</p><p>Hence it is possible to have multiple PayPal IPN systems without any conflicts.

Testing

The best way to test the product is to use a second live PayPal account as that tests the complete system.

To open a second PayPal account you need a second bank account which some people may find difficult but you will find it worth doing in the long run.

PHP-KeyCodes has a local test facility which will test all the set up and email details, but does not go through PayPal.

Note that the PayPal email address you enter into the application must be the Primary PayPal email address.  You can set up multiple email addresses in PayPal but only the Primary PayPal address will work with the IPN system.

Also note that if you receive a purchase which has a currency that is not the same as your default currency, then you have to accept the currency code before the transaction is completed.  To overcome this, you can set your account to accept a range of different currencies.


== Changelog ==

= 1.0.2 =
First Version


== Upgrade Notice ==
No upgrades at present