> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tabby.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenCart Plugin Installation

<Note>
  Tabby works on the OpenCart platform for all supported countries. OpenCart versions 2.x, 2.1.x, and 3.x with the Journal Theme are supported.
</Note>

## Installation Steps

<Steps>
  <Step
    stepNumber={1}
    title={(
  <span>
    <a href="https://merchant.tabby.ai/">
      Register with Tabby
    </a>
    <span style={{ fontWeight: 'normal', fontSize: '0.9em' }}>
      &nbsp;(KSA: <a href="https://merchant.tabby.sa/">merchant.tabby.sa</a>)
    </span>
    <span style={{ fontWeight: 'normal' }}>
      &nbsp;and fill all required business details
    </span>
  </span>
)}
  />

  <Step
    stepNumber={2}
    title={(
  <span style={{ fontWeight: 'normal' }}>
    Receive test API keys from your Tabby account manager
  </span>
)}
  />

  <Step
    stepNumber={3}
    title={(
  <span>
    To download Tabby Plugin,&nbsp;
    <a href="https://storage.googleapis.com/plgns/opencart-latest.zip">
      click here
    </a>
  </span>
)}
  />

  <Step
    stepNumber={4}
    title={(
  <span>
    <a href="/e-commerce-platforms/opencart/opencart-plugin-installation#install-the-opencart-extension">
      Install the plugin
    </a>
    <span style={{ fontWeight: 'normal' }}>
      &nbsp;and&nbsp;
    </span>
    <a href="/e-commerce-platforms/opencart/opencart-plugin-installation#configure-tabby-as-a-payment-method">
      configure Tabby as a payment method
    </a>
  </span>
)}
  />

  <Step
    stepNumber={5}
    title={(
  <span>
    <a href="/e-commerce-platforms/opencart/opencart-plugin-installation#test-your-integration">
      Test your integration
    </a>
  </span>
)}
  />

  <Step
    stepNumber={6}
    title={(
  <span>
    <span style={{ fontWeight: 'normal' }}>
      Receive live API keys and&nbsp;
    </span>
    <a href="/e-commerce-platforms/opencart/opencart-plugin-installation#connect-to-live-tabby-environment">
      deploy to production
    </a>
  </span>
)}
  />
</Steps>

### Install the OpenCart Extension

1. Go to ***Extensions -> Installer*** and install the extension.
2. Go to ***Extensions -> Modifications*** and click the refresh button under your profile (without re-loading this page in the browser).
3. Check the Tabby payment in the modification list.
4. Go to ***Extensions -> Extensions -> Modules*** in your OpenCart admin panel and activate Tabby Module.

The example of Tabby Module settings:

<img className="product-shot" alt="Tabby settings 1" src="https://mintcdn.com/tabby-5f40add6/Mdf68_F2fROQ9Weu/images/opencart-settings-1.webp?fit=max&auto=format&n=Mdf68_F2fROQ9Weu&q=85&s=0b41cf07ed33e64b35f1c614817307d0" width="2304" height="1305" data-path="images/opencart-settings-1.webp" />

<img className="product-shot" alt="Tabby settings 2" src="https://mintcdn.com/tabby-5f40add6/Mdf68_F2fROQ9Weu/images/opencart-settings-2.webp?fit=max&auto=format&n=Mdf68_F2fROQ9Weu&q=85&s=501809d8add92a5ef078493c5c11e2d6" width="2304" height="1315" data-path="images/opencart-settings-2.webp" />

#### Optional: Updating the OpenCart Extension

When you want to update your current version with the new one.

1. Go to ***Extensions -> Modifications*** and delete the Tabby payment
2. Go to ***Extensions -> Installer*** and delete all files named oc3-tabby-x.x.x.ocmod.zip from install history
3. Upload and install the extension
4. Go to ***Extensions -> Modifications*** and click the refresh button under your profile (without reloading the page in the browser)
5. Check the Tabby payment in the modification list;
6. Go to ***Extensions -> Extensions -> Modules*** in your Opencart admin panel and activate Tabby Module
7. Open **Tabby Module** settings and click on Save changes button

### Configure Tabby as a Payment Method

1. Go to ***Extensions -> Extensions -> Modules*** in your OpenCart admin panel, find Tabby Module, click "Edit" and enter the **Public API Key** and **Secret API Key** for testing.
2. Go to ***Extensions -> Extensions -> Payments*** in your OpenCart admin panel and enable Tabby Installments (Split in 4).
3. Make sure the following settings are configured in any Tabby option Installments: – **Capture on – order\_placed**
4. Go to ***Design -> Layouts -> Checkout*** and add Tabby Module to Content Top

**For Journal theme only:** Go to Journal → Layouts → Checkout, choose Top+, choose OpenCart (the last one) and choose Tabby Module →Tabby Checkout → Save changes.

### Test Your Integration

After completing your integration, make an order and refund it to ensure that everything works as expected.

**Coordinate Testing with Tabby**

Before deploying Tabby integration to your production site, Tabby needs to validate the correctness of the integration. Contact your account manager to coordinate this test.

### Connect to live Tabby environment

1. Get your public and secret keys for the live environment. Ask you account manager to share the keys.
2. Set your live public and secret keys in the OpenCart admin panel, for this go to ***Extensions -> Extensions -> Modules -> Tabby Module*** in your OpenCart admin panel.
3. **Launch to Production**<br />
   After you’ve connected to the live environment and we’ve tested your integration, you’re ready to deploy to your production environment and offer Tabby payment methods to your customers.

## Specific settings

### No Price snippet

It is possible to turn on non standard Tabby snippets in ***Extensions -> Extensions -> Modules -> Tabby module (Tabby Checkout),*** parameter ***Tabby Promo theme*** should have **:non standard** specified:

<div className="product-shot-figure">
  <img className="product-shot" alt="Tabby promo theme" src="https://mintcdn.com/tabby-5f40add6/Mdf68_F2fROQ9Weu/images/opencart-non-standard.avif?fit=max&auto=format&n=Mdf68_F2fROQ9Weu&q=85&s=0d4e621cc6f873edbd25de5925ec65ce" width="2304" height="949" data-path="images/opencart-non-standard.avif" />

  <p className="product-shot-caption">Promotions theme</p>
</div>

<img className="product-shot" alt="No price snippet" src="https://mintcdn.com/tabby-5f40add6/P693KbtvGHftcJLw/images/no-price-0625.png?fit=max&auto=format&n=P693KbtvGHftcJLw&q=85&s=d10ddd5c2bb788afd5d06f5d3460ee21" width="2530" height="1548" data-path="images/no-price-0625.png" />

<div className="product-shot-figure">
  <img className="product-shot" alt="No price pop-up" src="https://mintcdn.com/tabby-5f40add6/P693KbtvGHftcJLw/images/no-price-pop-up-0625.png?fit=max&auto=format&n=P693KbtvGHftcJLw&q=85&s=5ace8b39cfa5c09b95742d70df1af926" style={{ width: '200px', height: 'auto' }} width="456" height="1686" data-path="images/no-price-pop-up-0625.png" />

  <p className="product-shot-caption">No price snippet</p>
</div>