Skip to main content
Rate this article:

OpenCart plugin configuration 

Due to the large number of errors that can appear either in the installation, requests, platform incompatibility and so on, this guide will not attempt to cover them all.

It’s highly recommended to visit the help center for more in depth troubleshooting.

All errors that may be logged will be logged in the System-> Tools-> Error Logs section.

Release date Build Release notes
  • Hosted checkout support
  • 3DS support
  • Refund Support

If for whatever reason they’re not logged there then the option to view the apache or nginx logs always remains a possibility.

Common errors include:

  • Not having the currency of opencart set to the one that the payment contract supports.
  • Entity ID, payment contract ID, or 3DS contract ID don’t match the correct entity that they were created for.
  • Enable/Disable cURL verify host and peer being checked but the host server doesn’t have proper TLS certificates.
  • In remote cases not having the correct opencart version installed.
  • Make sure that the credentials are correct.
  • This includes payment contract ID, Username, Password, Realm, Entity ID, Client ID, etc.
  • If you’re using 3DSmake sure that the card actually supports 3DS.

In most cases the error may not be caused by the plugin itself as much as various other PHP errors and/or warnings.

In any case if the error is caused by a request to the dimebox server then the error message received when the request fails is very informative.

Example below:

    "code": 116,
    "details": {},
    "timestamp": 1608705038970,
    "message": "Access is restricted to authenticated users only. The query can't be made without a valid JWT (check the Authorization header of your request)."

The above request was denied because the user wasn’t authorized. This is due to an invalid token being present in the Authorization bearer.

This kind of error format will be present on almost all requests that fail and will deliver a concrete error message along with it which it turn will pinpoint the problem precisely.

Most of the time it’s enough to simply check the OpenCart error logs for such errors.


After the installation is done the plugin also needs to be configured with the correct credentials:

  • Enabled - Enables the payment method
  • Title - The customer facing payment method label
  • Test Mode - Targets the test environment or live environment
  • Invoice - Invoice the order automatically when successful
  • New Order Status - Status for new orders (processing or complete should be selected)
  • Region - Region to target
  • 3DS - Enable 3DS for transactions
  • CVV on Payment - Require CVV
  • Enable/Disable cURL verify host and peer - Enable host/SSL verification
  • Credentials (see below)

Tracking down the credentials

The credentials needed to be able to accept payments via the connector can be also found in Common Portal. 

Username and password

The username and password used to login to the Common Portal. 

Client ID

The client ID is always Common Portal.

Entity ID

The payment contract can be found in the Common Portal / Administration / Organizations. When accessing this page, the Entity ID will be available in the URL:

OpenCart entity ID

Payment Contract Id

The payment contract can be found in the Common Portal / Administration / Payment Contract Providers. When accessing the correct payment contract, the Payment Contract Id can be found in the URL:

OpenCart payment contract



3DS Contract Id

The 3DS Contract Id is not displayed in the common portal and needs to be provided by support. 


Rate this article:
Logo of Verifone