From 2631572aae6bc23262c0b51e57cf3b309890b74e Mon Sep 17 00:00:00 2001 From: Rich Morgan Date: Thu, 6 Mar 2014 13:13:46 -0500 Subject: [PATCH 1/6] Improved documentation --- README | 39 -------------------------------- README.md | 67 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 67 insertions(+), 39 deletions(-) delete mode 100644 README create mode 100644 README.md diff --git a/README b/README deleted file mode 100644 index 24f33ff..0000000 --- a/README +++ /dev/null @@ -1,39 +0,0 @@ -Bitpay plugin for Ecwid - -Instructions: -In config.php: - Set $storeURL to the URL of your store's homepage. - Set $storeID to your ecwid store ID found in the bottom-right of the Ecwid control panel. - Set $bitpayURL to the URL of the bitpay/ folder which you extracted from this plugin. - Set $apiKey to the key you created at bitpay.com in the "My Account > API Access Keys" section. - Adjust $speed if desired. - -In your Ecwid control panel: - Click System Settings > Payment, then click Authorize. Rename this to "Bitpay" or whatever you'd prefer. - Change Payment Processor to Credit Card: Authorize.net SIM - Click Account Details - API Login ID: choose something random here and copy it to config.php's $login variable. - Transaction Key: choose something random - MD5 Hash value: choose something random here and copy it to config.php's $hashValue variable. - Transaction Type: Authorize and Capture. - Click Advanced Settings. - Type in the url to bitpay/redirect2bitpay.php on your server. - Click Save - Click Save - - Click Design > CSS Themes - Either click "New CSS Theme" or edit your own theme. - Add this to the text area of your custom theme: - /* bitpay checkout image */ - img.defaultCCImage { - padding: 25px 263px 0px 0px; - background: url('http://fde.minethings.com/ecwid/bitpay/bitcoin25.png'); - background-size:auto; - background-repeat:no-repeat; - width:0px; - height: 0px; - } - Click Save - -Bitpay plugin version 1.0 -Tested against Ecwid version 13.0.1629 diff --git a/README.md b/README.md new file mode 100644 index 0000000..907fbf6 --- /dev/null +++ b/README.md @@ -0,0 +1,67 @@ +©2011,2012,2013,2014 BITPAY, INC. + +Permission is hereby granted to any person obtaining a copy of this software and associated documentation for use and/or modification in association with the bitpay.com service. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +Bitcoin plugin for Ecwid using the bitpay.com service. + + + +Instructions +------------ +In config.php: + - Set $storeURL to the URL of your store's homepage. + - Set $storeID to your ecwid store ID found in the bottom-right of the Ecwid control panel. + - Set $bitpayURL to the URL of the bitpay/ folder which you extracted from this plugin. + - Set $apiKey to the key you created at bitpay.com in the "My Account > API Access Keys" section. + - Adjust $speed if desired. + +In your Ecwid control panel: + - Click System Settings > Payment, then click Authorize. Rename this to "Bitpay" or whatever you'd prefer. + - Change Payment Processor to Credit Card: Authorize.net SIM + - Click Account Details + - API Login ID: choose something random here and copy it to config.php's $login variable. + - Transaction Key: choose something random + - MD5 Hash value: choose something random here and copy it to config.php's $hashValue variable. + - Transaction Type: Authorize and Capture. + - Click Advanced Settings. + - Type in the url to bitpay/redirect2bitpay.php on your server. + - Click Save + -Click Save + + - Click Design > CSS Themes + - Either click "New CSS Theme" or edit your own theme. + - Add this to the text area of your custom theme: + 
+		/* bitpay checkout image */
+		img.defaultCCImage {
+			padding: 25px 263px 0px 0px; 
+			background: url('http://fde.minethings.com/ecwid/bitpay/bitcoin25.png'); 
+			background-size:auto; 
+			background-repeat:no-repeat;
+			width:0px; 
+			height: 0px;
+		}
+
+ - Click Save + + +Troubleshooting +--------------- +The official BitPay API documentation should always be your first reference for development: https://bitpay.com/downloads/bitpayApi.pdf + +- Verify that your "notificationURL" for the invoice is "https://" (not "http://") +- Ensure a valid SSL certificate is installed on your server. Also ensure your root CA cert is updated. If your CA cert is not current, you will see curl SSL verification errors. +- Verify that your callback handler at the "notificationURL" is properly receiving POSTs. You can verify this by POSTing your own messages to the server from a tool like Chrome Postman. +- Verify that the POST data received is properly parsed and that the logic that updates the order status on the merchants web server is correct. +- Verify that the merchants web server is not blocking POSTs from servers it may not recognize. Double check this on the firewall as well, if one is being used. +- Use the logging functionality to log errors during development. If you contact BitPay support, they will ask to see the log file to help diagnose any problems. +- Check the version of this plugin against the official repository to ensure you are using the latest version. Your issue might have been addressed in a newer version of the library. +- If all else fails, send an email describing your issue in detail to support@bitpay.com + + +Version +------- +Bitpay plugin version 1.0 +Tested against Ecwid version 13.0.1629 From 2887aa75b80b3482556745ad648a5de5d55d5692 Mon Sep 17 00:00:00 2001 From: Rich Morgan Date: Thu, 6 Mar 2014 13:15:02 -0500 Subject: [PATCH 2/6] Update README.md --- README.md | 45 ++++++++++++++++++++++----------------------- 1 file changed, 22 insertions(+), 23 deletions(-) diff --git a/README.md b/README.md index 907fbf6..2081591 100644 --- a/README.md +++ b/README.md @@ -11,29 +11,28 @@ Bitcoin plugin for Ecwid using the bitpay.com service. Instructions ------------ In config.php: - - Set $storeURL to the URL of your store's homepage. - - Set $storeID to your ecwid store ID found in the bottom-right of the Ecwid control panel. - - Set $bitpayURL to the URL of the bitpay/ folder which you extracted from this plugin. - - Set $apiKey to the key you created at bitpay.com in the "My Account > API Access Keys" section. - - Adjust $speed if desired. +- Set $storeURL to the URL of your store's homepage. +- Set $storeID to your ecwid store ID found in the bottom-right of the Ecwid control panel. +- Set $bitpayURL to the URL of the bitpay/ folder which you extracted from this plugin. +- Set $apiKey to the key you created at bitpay.com in the "My Account > API Access Keys" section. +- Adjust $speed if desired. In your Ecwid control panel: - - Click System Settings > Payment, then click Authorize. Rename this to "Bitpay" or whatever you'd prefer. - - Change Payment Processor to Credit Card: Authorize.net SIM - - Click Account Details - - API Login ID: choose something random here and copy it to config.php's $login variable. - - Transaction Key: choose something random - - MD5 Hash value: choose something random here and copy it to config.php's $hashValue variable. - - Transaction Type: Authorize and Capture. - - Click Advanced Settings. - - Type in the url to bitpay/redirect2bitpay.php on your server. - - Click Save - -Click Save - - - Click Design > CSS Themes - - Either click "New CSS Theme" or edit your own theme. - - Add this to the text area of your custom theme: - 
+- Click System Settings > Payment, then click Authorize.  Rename this to "Bitpay" or whatever you'd prefer.  
+- Change Payment Processor to Credit Card: Authorize.net SIM
+- Click Account Details
+- API Login ID: choose something random here and copy it to config.php's $login variable.
+- Transaction Key: choose something random
+- MD5 Hash value: choose something random here and copy it to config.php's $hashValue variable.
+- Transaction Type: Authorize and Capture.
+- Click Advanced Settings.
+- Type in the url to bitpay/redirect2bitpay.php on your server.
+- Click Save
+- Click Save 
+- Click Design > CSS Themes
+- Either click "New CSS Theme" or edit your own theme.
+- Add this to the text area of your custom theme:
+
 		/* bitpay checkout image */
 		img.defaultCCImage {
 			padding: 25px 263px 0px 0px; 
@@ -43,8 +42,8 @@ In your Ecwid control panel:
 			width:0px; 
 			height: 0px;
 		}
-	

-	- Click Save
+
+- Click Save Troubleshooting From dfe3d0a5e82a555578d76e7bbdd9e1cbbbc223bf Mon Sep 17 00:00:00 2001 From: Rich Morgan Date: Thu, 6 Mar 2014 13:18:35 -0500 Subject: [PATCH 3/6] Fixed reference to broken image link --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 2081591..feb741a 100644 --- a/README.md +++ b/README.md @@ -36,7 +36,7 @@ In your Ecwid control panel: /* bitpay checkout image */ img.defaultCCImage { padding: 25px 263px 0px 0px; - background: url('http://fde.minethings.com/ecwid/bitpay/bitcoin25.png'); + background: url('https://en.bitcoin.it/w/images/en/2/29/BC_Logo_.png'); background-size:auto; background-repeat:no-repeat; width:0px; From 055f79150d4d854529f268115bdb5319469d0e36 Mon Sep 17 00:00:00 2001 From: Rich Morgan Date: Thu, 6 Mar 2014 13:19:52 -0500 Subject: [PATCH 4/6] Added company, copyright & license information --- bitpay/bp_options.php | 19 ++++++++++++++++++- 1 file changed, 18 insertions(+), 1 deletion(-) diff --git a/bitpay/bp_options.php b/bitpay/bp_options.php index d614bd4..09d2913 100644 --- a/bitpay/bp_options.php +++ b/bitpay/bp_options.php @@ -1,5 +1,22 @@ \ No newline at end of file +?> From 88cc8d5bb06091935fceeeed706d928f40f89361 Mon Sep 17 00:00:00 2001 From: Rich Morgan Date: Thu, 6 Mar 2014 13:20:45 -0500 Subject: [PATCH 5/6] Added company, copyright & license information --- bitpay/bp_lib.php | 19 ++++++++++++++++++- 1 file changed, 18 insertions(+), 1 deletion(-) diff --git a/bitpay/bp_lib.php b/bitpay/bp_lib.php index f1a7e95..267b21f 100644 --- a/bitpay/bp_lib.php +++ b/bitpay/bp_lib.php @@ -1,5 +1,22 @@ \ No newline at end of file +?> From e4d6cb7483f99a5ec8fd96b4fce891d8c44880ca Mon Sep 17 00:00:00 2001 From: Rich Morgan Date: Thu, 6 Mar 2014 13:22:06 -0500 Subject: [PATCH 6/6] Update README.md --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index feb741a..b65f61b 100644 --- a/README.md +++ b/README.md @@ -62,5 +62,5 @@ The official BitPay API documentation should always be your first reference for Version ------- -Bitpay plugin version 1.0 -Tested against Ecwid version 13.0.1629 +- Bitpay plugin version 1.0 +- Tested against Ecwid version 13.0.1629