From 9fe450cf4437441453baec703fafd3ef36697920 Mon Sep 17 00:00:00 2001 From: Rich Morgan Date: Fri, 20 Feb 2015 18:09:35 -0500 Subject: [PATCH 1/2] Removed install/config info and added to GUIDE --- README.md | 37 +++++++++---------------------------- 1 file changed, 9 insertions(+), 28 deletions(-) diff --git a/README.md b/README.md index 7dc14df..09ed1c3 100644 --- a/README.md +++ b/README.md @@ -1,50 +1,31 @@ -bitpay/zencart-plugin -===================== +# Description -# Installation +This is the BitPay payment plugin for ZenCart. -Copy these files into the ZenCart directory on your webserver. +## Quick Start Guide -# Configuration +To get up and running with our plugin quickly, see the GUIDE here: https://github.com/bitpay/zencart-plugin/blob/master/GUIDE.md -1. Create an API key at bitpay.com under your My Account section. -2. In Admin panel under "Modules > Payment > Bitcoins" click Install. -3. Fill out all configuration information:
-a. Verify that the module is enabled.
-b. Set the API key to the value you created in step 1.
-c. Select a transaction speed. The high speed will send a confirmation as soon as a transaction is received in the bitcoin network (usually a few seconds). A medium speed setting will typically take 10 minutes. The low speed setting usually takes around 1 hour. See the bitpay.com merchant documentation for a full description of the transaction speed settings: https://bitpay.com/downloads/bitpayApi.pdf
-d. Choose a status for unpaid and paid orders (or leave the default values as defined).
-e. Verify that the currencies displayed correspond to what you want and to those accepted by bitpay.com (the defaults are what bitpay accepts as of this writing).
-f. Choose a sort order for displaying this payment option to visitors. Lowest is displayed first.
+## Support -# Usage - -When a shopping chooses the Bitcoin payment method, they will be presented with an order summary as the next step (prices are shown in whatever currency they've selected for shopping). Upon receiving their order, the system takes the shopper to a bitpay.com invoice where the user is presented with bitcoin payment instructions. Once payment is received, a link is presented to the shopper that will take them back to your website. - -In your Admin control panel, you can see the orders made with Bitcoins just as you would any other order. The status you selected in the configuration steps above will indicate whether the order has been paid for. - -**Note:** This extension does not provide a means of automatically pulling a current BTC exchange rate for presenting BTC prices to shoppers. - -# Support - -## BitPay Support +### BitPay Support * [GitHub Issues](https://github.com/bitpay/zencart-plugin/issues) * Open an issue if you are having issues with this plugin. * [Support](https://support.bitpay.com) * BitPay merchant support documentation -## ZenCart Support +### ZenCart Support * [Homepage](http://www.zen-cart.com) * [Documentation](http://www.zen-cart.com/wiki/index.php/Developers_API) * [Support Forums](http://www.zen-cart.com/forum.php) -# Contribute +## Contribute To contribute to this project, please fork and submit a pull request. -# License +## License The MIT License (MIT) From 7ba7a27c5c8ac46912ef00c455cbbc6cb044066c Mon Sep 17 00:00:00 2001 From: Rich Morgan Date: Fri, 20 Feb 2015 18:11:55 -0500 Subject: [PATCH 2/2] Create GUIDE.md --- GUIDE.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 GUIDE.md diff --git a/GUIDE.md b/GUIDE.md new file mode 100644 index 0000000..81924a5 --- /dev/null +++ b/GUIDE.md @@ -0,0 +1,29 @@ +# Using the BitPay plugin for ZenCart + +## Prerequisites + +You must have a BitPay merchant account to use this plugin. It's free to [sign-up for a BitPay merchant account](https://bitpay.com/start). + +## Installation + +Download the zip file for this plugin, unzip the arcive and copy the files into the ZenCart directory on your webserver. + +## Configuration + +* Create an API key at bitpay.com under your My Account section. +* In Admin panel under "Modules > Payment > Bitcoins" click Install. +* Fill out all configuration information: + * Verify that the module is enabled. + * Set the API key to the value you created in step 1. + * Select a transaction speed. The high speed will send a confirmation as soon as a transaction is received in the bitcoin network (usually a few seconds). A medium speed setting will typically take 10 minutes. The low speed setting usually takes around 1 hour. See the bitpay.com merchant documentation for a full description of the transaction speed settings: https://bitpay.com/downloads/bitpayApi.pdf
+ * Choose a status for unpaid and paid orders (or leave the default values as defined).
+ * Verify that the currencies displayed correspond to what you want and to those accepted by bitpay.com (the defaults are what bitpay accepts as of this writing).
+ * Choose a sort order for displaying this payment option to visitors. Lowest is displayed first.
+ +## Usage + +When a shopping chooses the Bitcoin payment method, they will be presented with an order summary as the next step (prices are shown in whatever currency they've selected for shopping). Upon receiving their order, the system takes the shopper to a bitpay.com invoice where the user is presented with bitcoin payment instructions. Once payment is received, a link is presented to the shopper that will take them back to your website. + +In your Admin control panel, you can see the orders made with Bitcoins just as you would any other order. The status you selected in the configuration steps above will indicate whether the order has been paid for. + +**Note:** This extension does not provide a means of automatically pulling a current BTC exchange rate for presenting BTC prices to shoppers.