Magento 2

Accept blockchain payments on your Magento-based e-commerce site with BitPay's open source Plugin.

Integration Requirements

Plugin Installation

  1. Upload all files to your Magento 2 installation root
  2. Login to your server, and in the root of your Magento 2 install, run the following commands:
    • php bin/magento setup:upgrade
    • php bin/magento module:enable BitpayCheckout_BPCheckout
    • php bin/magento setup:static-content:deploy -f
  3. Flush your Magento 2 Caches
    • php bin/magento cache:flush

You can now activate BitPay in the Sales->Configuration->Sales->Payment Methods

Plugin Configuration

After you have installed the BitPay plugin, the configuration steps are:

  1. 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: Magento 2), uncheck "Require Authentication" and click on the Add Token button
    • Copy the token value
  1. Log in to your Magento admin panel, click on Stores and then click on Configuration (under settings). Under the drop down Sales menu, click on Payment Methods. This will give you access to the BitPay plugin settings:
    • Paste the token value into the appropriate field: Development Token for token copied from the sandbox environment ( and Production Token for token copied from the live environment (
    • select the endpoint - Test or Production
    • Payment from Specific Countries - You MUST select the countries to enable BitPay to appear in the checkout.
    • Click Save config at the bottom of the page