---
updatedAt: 2025-09-22T17:20:51.000Z
agentTools:
  projectIndex: https://developer.bitpay.com/llms.txt
---

# OpenCart

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

## Integration Requirements

* OpenCart 3.x
* A BitPay merchant account:
  * On the [production environment](https://bitpay.com/dashboard/signup)
  * On the [test environment](https://test.bitpay.com/dashboard/signup?_gl=1*7yrygh*_ga*Mzk3NjU2MjYuMTY2MTU0MTE4OA..*_ga_1WSHCPQXN3*MTY3NTcwNTE4OC4xMDYuMS4xNjc1NzA1ODg5LjYuMC4w*_ga_X8H6CLL26F*MTY3NTcwNTE4OC4xMDYuMS4xNjc1NzA1ODg5LjYuMC4w*_ga_JPH7WVZ7B0*MTY3NTcwNTE4OC4xMDUuMS4xNjc1NzA1ODg5LjYuMC4w*_ga_K01TF179SZ*MTY3NTcwNTE4OC4xMDYuMS4xNjc1NzA1ODg5LjYuMC4w*_ga_Y4SP8JSCEZ*MTY3NTcwNTE4OC4xMDYuMS4xNjc1NzA1ODg4LjU4LjAuMA..), for sandbox testing

## Plugin Installation

1. Download the latest release of the plugin from the [OpenCart marketplace](https://www.opencart.com/index.php?route=marketplace/extension/info\&extension_id=20947), 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>
   ```

![](https://files.readme.io/1e3e0c7-image.png)

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

![](https://files.readme.io/b266551-image.png)

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

![](https://files.readme.io/c363c47-image.png)

Additional information can be found on the [BitPay plugin page](https://www.opencart.com/index.php?route=marketplace/extension/info\&extension_id=20947) on the OpenCart Marketplace.