OpenCart

Integration Requirements

• OpenCart 3.x
• A BitPay merchant account:
  • On the production environment
  • On the test environment, for sandbox testing

Plugin Installation

1. Download the latest release of the plugin from the OpenCart marketplace, you will obtain a file named bitpay-opencart.ocmod.zip
2. From your OpenCart admin panel, navigate to "Extensions" > "Installer" and upload the file previously retrieved from the OpenCart Marketplace.
3. From your OpenCart admin panel, navigate to "Design > Theme Editor > common > header", add the following before the closing </head> tag:
   HTML

   <script src="https://bitpay.com/bitpay.min.js" type="text/javascript"></script>
   

4. Flush your OpenCart storage to finish the installation

Plugin Configuration

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

1. Create an API token from your BitPay merchant dashboard:
   1. Log in to your BitPay merchant account and go to the API token settings
   2. Click on the Add new token button: indicate a token label (for instance: OpenCart), make sure "Require Authentication" is unchecked and click on the Add Token button
   3. Copy the token value

2. Log in to your OpenCart admin panel, go to "Extensions" > "Extentions" > choose "Payments" as extension type > BitPay checkout:
   1. Set the Extension Status to enabled
   2. Select the endpoint - Test or Production, depending on your current setup. Your matching API Token must be set
   3. 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)
   4. Checkout Flow: BitPay recommends the Modal option as it keeps the user on your site and shows a modal window. To use the Modal option, you will need to configure the bitpay.min.js script as indicated above. We also propose a Redirect option as an alternative.
   5. Click on the save icon in the upper right hand corner

Additional information can be found on the BitPay plugin page on the OpenCart Marketplace.