Requirements
NOTE: If you were using a previous version of this plugin, this version (3.0) was completely rewritten to improve the user experience and the security.
Plugin installation
- Get started by signing up for a BitPay merchant account
- Look for the BitPay plugin via the WordPress Plugin Manager. From your WordPress admin panel, go to Plugins > Add New > Search plugins and type BitPay
- Select BitPay for WooCommerce and click on Install Now and then on Activate Plugin
After the plugin is activated, BitPay will appear in the WooCommerce > Settings > Payments section.
Plugin configuration
After you have installed the BitPay plugin, the configuration steps are:
- Create an API token from your BitPay merchant dashboard:
- Login to your BitPay merchant account and go to the API token settings
- click on the Add new token button: indicate a token label (for instance: WooCommerce), uncheck "Require Authentication" and click on the Add Token button
- Copy the token value
- Log in to your WordPress admin panel, select WooCommerce > Payments and click on the Set up button next to the BitPay Payment methods
- Paste the token value into the appropriate field: Development Token for token copied from the sandbox environment (test.bitpay.com) and Production Token for token copied from the live environment (bitpay.com)
- select the endpoint - Test or Production
- Click "Save changes" at the bottom of the page
Order fulfilment
This plugin also includes an IPN (Instant Payment Notification) endpoint that will update your WooCommerce order status. An order note will automatically be added with a link to the BitPay invoice
(will open in a new window):
- When the customer decides to pay with BitPay, he is presented with a BitPay invoice while the WooCommerce order will be set to "Pending"
- The customer initiates a transaction from his wallet to pay the BitPay invoice, the status of the WooCommerce order will change to Processing or Completed depending how the merchant configured the status in the plugin settings.
- If a BitPay invoice expires before the customer completed the payment, the merchant has the possibility to automatically mark the WooCommerce order as Cancelled via the plugin settings.