OpenCart Extension — Complete Setup Guide

The Partially extension for OpenCart lets you offer payment plans as a payment option at checkout, and optionally display a payment plan widget on product pages.

Before You Start

You need two things in place in Partially before configuring the extension:

A connected Stripe account — Go to Settings → Integrations in Partially and connect Stripe if you haven't already.
An offer — An offer defines your payment plan terms. Go to Offers → New Offer to create one.

Step 1 — Install the Extension

You can install the Partially extension two ways:

Option A — Opencart Marketplace (v3+ recommended)

In your OpenCart admin, go to Extensions → Marketplace.
Search for "Partially" and install directly from there.

Option B — Manual Upload

Download the extension .zip file from the OpenCart marketplace website.
In your OpenCart admin, go to Extensions → Extension Installer.
Click Upload and select the .zip file.
Once uploaded, go to Extensions → Extensions and select Payments from the category dropdown.
Find Partial.ly Payment Plans in the list and click Install.

Step 2 — Configure Gateway Settings

After installing, click Edit next to the Partial.ly extension to open its settings. The Gateway Settings control how Partially appears as a payment option at checkout.

Field	What to enter
Status	Set to Enabled
API Key	Your Partially API key, found in Partially under Settings → General
Offer	The Offer ID for the offer you want to use at checkout (found in the offer's Integration tool)
Order Status (Opened)	The OpenCart order status to assign when a payment plan is opened
Order Status (Paid)	The OpenCart order status to assign when a plan is fully paid
Minimum Order Amount	Optional — only show Partially for orders above this amount
Sort Order	Controls where Partially appears in the payment method list at checkout

Save your settings. Partially will now appear as a payment option on your checkout page.

Step 3 — Configure Widget Settings (Optional)

The Widget Settings control a payment plan widget that can be shown on product pages, giving customers an estimate of plan terms before they reach checkout.

Field	What to enter
Status	Enable or disable the product page widget
Style	Visual style of the widget
Title	Custom heading text for the widget (leave blank for default)
Body	Custom body text — leave blank for the default, dynamic text (recommended)
Trigger Text	The link or button text that opens the widget popup
Show Checkout Button	Whether to include a checkout button inside the widget popup

Step 4 — Add the Widget to Product Pages (Developer Step)

To display the widget on product pages, you need to make two small code changes:

1. Modify the product controller

In your theme's product controller file, add the following call to load the widget data:

$this->load->model('extension/payment/partially');
$data['partiallyWidget'] = $this->model_extension_payment_partially->getWidget($this->request->get['product_id']);

2. Modify the product template

Add the widget output to your product template file:

OpenCart v3.x (product.twig):
```
{{ partiallyWidget }}
```
OpenCart v2.x (product.tpl):
```
<?php echo $partiallyWidget; ?>
```

Place these tags where you want the widget to appear on the product page (typically near the price or add-to-cart button).

Cart-based rules and multiple offers

To apply rules such as minimum order amounts, disabling Partially for certain products, or showing different offers for different cart contents, use Smart Customization — Partial.ly's rules engine, configured in the UI with no code. See Smart Customization.

Advanced Scripting is deprecated. The older Settings → Advanced Scripting feature is no longer recommended — use Smart Customization instead. Any existing Advanced Scripting is written in Lua (not JavaScript); leave legacy scripts in Lua and don't write new ones.

Troubleshooting

Partially not appearing at checkout — Check that Status is set to Enabled in Gateway Settings, and that your API key and Offer ID are correct. Confirm the offer is active in your Partially account.

Widget not showing on product pages — The widget requires the controller and template code changes in Step 4. Check that both files were modified and that the widget Status is Enabled in Widget Settings.

API key not working — Find your API key under Settings → General in your Partially merchant account. Paste the full key with no extra spaces.

Questions? Email support@partial.ly.