Add the ability to accept bitcoin in WooCommerce via BitPay.
Bitcoin is a powerful new peer-to-peer platform for the next generation of financial technology. The decentralized nature of the Bitcoin network allows for a highly resilient value transfer infrastructure, and this allows merchants to gain greater profits.
This is because there are little to no fees for transferring Bitcoins from one person to another. Unlike other payment methods, Bitcoin payments cannot be reversed, so once you are paid you can ship! No waiting days for a payment to clear.
- Wordpress >= 3.8 (Older versions will work, but we do not test against those)
- WooCommerce >= 2.2
- GMP You may have to install this as most servers do not come with it.
- mcrypt
- OpenSSL Must be compiled with PHP
- PHP >= 5.4
Merchants who have a previous version of the WooCommerce BitPay Payment Gateway will need to remove it. This can be done by going to the Wordpress's Adminstration Panels > Plugins. Deactivate the old plugin, then delete it.
Visit the Releases page of this repository and download the latest version. Once this is done, you can just go to Wordpress's Adminstration Panels > Plugins > Add New > Upload Plugin, select the downloaded archive and click Install Now. After the plugin is installed, click on Activate.
WARNING It is good practice to backup your database before installing plugins. Please make sure you create backups.
Configuration can be done using the Administrator section of Wordpress. Once Logged in, you will find the configuration settings under WooCommerce > Settings > Checkout > BitPay. Alternatively, you can also get to the configuration settings via Plugins and clicking the Settings link for this plugin.
Here your will need to create a pairing code using
your BitPay merchant account. Once you have a Pairing Code, put the code in the
Pairing Code field:
On success, you'll receive a token:
NOTE Pairing Codes are only valid for a short period of time. If it expires before you get to use it, you can always create a new one and pair with it.
NOTE You will only need to do this once since each time you do this, the extension will generate public and private keys that are used to identify you when using the API.
You are also able to configure how BitPay's IPN (Instant Payment Notifications) changes the order in your WooCommerce store.
Save your changes and you're good to go!
Once enabled, your customers will be given the option to pay with Bitcoins. Once they checkout they are redirected to a full screen BitPay invoice to pay for the order.
As a merchant, the orders in your WooCommerce store can be treated as any other order. You may need to adjust the Invoice Settings depending on your order fulfillment.
##Setup
- NodeJS & NPM
- Grunt
- Composer
Clone the repo:
$ git clone https://github.com/bitpay/woocommerce-plugin
$ cd woocommerce-pluginInstall the dependencies:
$ npm install
$ curl -sS https://getcomposer.org/installer | php
$ ./composer.phar install##Build Perform the setup, then:
$ ./node_modules/.bin/grunt build
# Outputs plugin at dist/woocommerce-plugin
# Outputs plugin archive at dist/woocommerce-plugin.zip- GitHub Issues
- Open an issue if you are having issues with this plugin.
- Support
- BitPay merchant support documentation
- 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 web server is not blocking POSTs from servers it may not recognize. Double check this on your firewall as well, if one is being used.
- Check the version of this plugin against the official plugin repository to ensure you are using the latest version. Your issue might have been addressed in a newer version! See the Releases page for the latest.
- If all else fails, send an email describing your issue in detail to support@bitpay.com
TIP: When contacting support it will help us is you provide:
- WordPress and WooCommerce Version
- Other plugins you have installed
- Some plugins do not play nice
- Configuration settings for the plugin (Most merchants take screen grabs)
- Any log files that will help
- Web server error logs
- Screen grabs of error message if applicable.
To contribute to this project, please fork and submit a pull request.
The MIT License (MIT)
Copyright (c) 2011-2014 BitPay, Inc.
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
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.