Source Files

You can download the latest extension version here.

Requirements

OpenCart 4.1.x
Valid SSL certificate
PHP 8.1 or later with the cURL extension enabled
Ecom merchant account with E_API credentials
KWD configured as an available OpenCart currency

Installation Steps

Configure OpenCart and add KWD as an available currency before installing
Ecom Payments.
Log in to the OpenCart admin panel.
Go to Extensions → Installer.
Click the upload button and upload the downloaded ecom.ocmod.zip file.
Wait until OpenCart confirms that the extension was installed.
Go to Extensions → Extensions.
Select Payments from the extension type list.
Find Ecom and click the Install button.
Click the Edit button to configure the extension.

Merchant Configurations

In the OpenCart admin panel, configure the extension under
Extensions → Extensions → Payments → Ecom → Edit.

Add your Ecom credentials from the Ecom portal. You can get them from
Account → API Credentials.

Configuration	Description
API Token	Your API token from the Ecom portal.
Merchant ID	Your merchant MID from the Ecom portal.
Environment	Select Sandbox for testing or Production for live payments. Environment and credentials must match.
Webhook Secret	Your webhook secret from the Ecom portal API Credentials tab.
Geo Zone	Select All Zones or limit Ecom Payments to a specific customer location.
Status	Select Enabled to display Ecom Payments during checkout.
Sort Order	Controls the position of Ecom Payments among the available checkout methods.

Click Save after entering the configuration.

The extension displays a webhook URL below the Webhook Secret field. Copy this
URL and add it as the transaction webhook endpoint in the Ecom portal. The URL
must be public, use HTTPS, and must not be blocked by authentication, maintenance
mode, a firewall, or a proxy.

All charges use the Ecom-hosted payment page in INDIRECT mode. The extension
is available only for KWD orders and does not support subscription carts.

Order statuses are updated automatically:

INITIATED or PENDING uses the OpenCart pending status.
CAPTURED uses the OpenCart complete status.
Other terminal payment statuses use the OpenCart failed status.

Before switching to Production, complete a Sandbox payment and confirm that the
customer returns to the OpenCart success page and the order changes to the
complete status.

If an integration error occurs, open System → Maintenance → Error Logs.
Search for Ecom gateway error or Ecom callback verification failed. Gateway
error logs include the request body and Ecom response but never include the API
token.