Use BitPay’s plugin to accept Bitcoin payments from customers anywhere on earth.

Key features:

  • Support all bitcoin and bitcoin cash wallets that support payment protocol
  • Price in your local currency, let customers pay with bitcoin and bitcoin cash
  • Have an overview of all your bitcoin and bitcoin cash payments in your BitPay merchant dashboard at
  • Refund your customers in bitcoin or bitcoin cash in your BitPay merchant dashboard at


This plugin requires Woocommerce. Please make sure you have Woocommerce installed.

  1. Get started by signing up for a BitPay merchant account.
  2. Search for the BitPay plugin: Plugins -> Add New -> Search plugins and type BitPay
  3. Select bitpay-for-woocommerce and click on ‘Install Now’ and then on Activate Plugin

Connecting BitPay and Woocommerce

After you have installed the BitPay plugin, you can configure the plugin:

  1. Create a BitPay pairing code in your BitPay merchant dashboard:
    • Login to your BitPay merchant account and select Payment Tools -> Manage API Tokens -> Add New Token -> Add Token
    • Copy the 7 character pairing code
  2. Log in to your WordPress admin panel and select « Plugins » -> « Settings » link for the BitPay plugin.
    • Paste the 7 character pairing code into the « Pairing Code » field in your BitPay plugin and click « Find »
    • Click « Save changes » at the bottom

Pairing codes need to be used once and are only valid for 24 hours. If a code expires before you get to use it, you can always create a new one and pair with it.

Nice work! Your customers will now be able to check out with bitcoin on your WordPress site.

Captures d’écran


How do I pay a BitPay invoice?

You can pay a BitPay invoice with a Bitcoin wallet. You can either scan the QR code or copy/paste the payment link in your Bitcoin wallet.

More information about paying a BitPay invoice can be found here.

Does BitPay have a test environment?

BitPay allows you to create a test merchant account and a testnet Bitcoin wallet.

More information about the test environment can be found here.

The BitPay plugin does not work

If BitPay invoices are not created, please check the following:

  • The minimum invoice amount is USD 5. Please make sure you are trying to create a BitPay invoice for USD 5 or more (or your currency equivalent).
  • Please make sure your BitPay merchant account is enabled for your transaction amounts. In your BitPay merchant account, go to Settings -> General -> Increase Processing Volume
I need support from BitPay

When contacting BitPay support, please describe your issue and attach screenshots and the BitPay logs.

BitPay logs can be retrieved in your WordPress / Woocommerce environment:

  • Enable logging in your BitPay plugin: Plugins -> Settings -> Debug Log -> Enable logging
  • Download the logs from Plugins -> Logs

You can email your issue report to


Can’t get pairing code

I created an API token, and then copied that token and pasted it into the pairing code field in the Bitpay plugin, and clicked find, but it gives back the error that it was "unable to pair with Bitpay". I tried it using Livenet and Testnet. I've triple checked the token, and it is accurate. Any suggestions?

Not working

Not working in newest Version. Shows Error: "Sorry, but Bitcoin checkout with BitPay does not appear to be working."

Works (but may require extra work)

It took me a couple of iterations to get this plugin working. Turns out both mcrypt and bcmath are required. Install these and restart your webserver before attempting to pair, like so (on Debian'ish machines running Apache). apt install php-mcrypt php-bcmath service apache2 restart
Lire les 12 avis

Contributeurs & développeurs

« bitpay-for-woocommerce » est un logiciel libre. Les personnes suivantes ont contribué à cette extension.


Traduisez « bitpay-for-woocommerce » dans votre langue.

Le développement vous intéresse ?

Parcourir le code, consulter le SVN dépôt, ou s’inscrire au journal de développement par RSS.


[2.2.16] – 2018-08-20

  • Fixed expired (unpaid) invoices should not decrease the stock (#88)
  • Fixed the Bitpay payment plugin was called to process an IPN message but could not retrieve the order details for order_id (#87)
  • Fixed unclear error message when doing payments below BitPay minimum (#85)
  • Fixed after installation of the BitPay Woocommerce plugin v2.2.12, an openssl_decrypt error pops up (#82)
  • Set transactionSpeed to medium for all invoices. This simplifies the plugin configuration.

[2.2.15] – 2018-04-12

  • Fixed Compatibility with BitPay’s upcoming API changes (May 1st 2018)


  • (fixed via PHP package update) Price must be formatted as a float (#78)
  • Fixed WC 2.5 compatibility, with get_billing_email() error (#83)


  • Fixed wrong function call resulting in undefined wc_reduce_stock_levels() (#84)
  • Fixed syntax error in class-wc-gateway-bitpay.php (#80)
  • Fixed price must be formatted as a float (#78)
  • Added redirect page, displaying ‘payment successful’ even for unpaid invoices (#81)


  • Removed non-working option to disable BitPay from the BitPay plugin config page
  • Populate buyer email when creating BitPay invoice
  • WC v3 compatibility fixes
  • Change Mcrypt to OpenSSL (#77)
  • Improve logging around updating order states