Skip to main content

OpenCart

General information​

OpenCart is a free, open-source e-commerce platform that enables you to create online stores and manage products, customers, and orders through its built-in SEO system. By using the payment plugin from Tranzzo, your online store can accept payments via card methods, as well as Apple Pay and Google Pay™.

Information about the plugin:

Plugin documentation repository: available on GitHub.

Supported OpenCart versions: 3.x and 4.x.

Customization warning: we do not recommend customizing the plugin, as it can complicate updates and maintenance of the integration.

Plugin installation​

You can install the plugin in two ways: via an FTP client or through the OpenCart admin panel.

Installation via FTP Client:

  1. Download the latest version from the repository.
  2. Unzip the archive.
  3. Upload the oc_payment_tp folder to the path/to/project/extension folder via FTP. This package does not overwrite any core files.
  4. In the OpenCart admin panel, select the Extensions section and go to the Extensions page.
  5. Select Payments from the plugin type list, find Tranzzo, and click the green button for adding.

Installation via the OpenCart admin panel:

  1. Download the latest version from the repository.
  2. In the OpenCart admin panel, select the Extensions section and go to the Installer page.
  3. Install the archive (oc_payment_tp.ocmod.zip for version 4 or tranzzo.ocmod.zip for version 3) with the payment plugin.
  4. In the OpenCart admin panel, select the Extensions section and go to the Extensions page.
  5. Select Payments from the plugin type list, find Tranzzo, and click the green button to activate the plugin.

Setup guide​

Configuring the plugin includes the following steps:

  1. Register in the merchant portal: obtain API keys for the test project (refer to the integration checklist for more details).
  2. In the OpenCart admin panel, select the Extensions section and go to the Extensions page.
  3. Select Payments from the plugin type list, find Tranzzo, and click the edit settings button.
  4. Fill in the API keys of your test project.
  5. Choose whether the plugin will operate in test mode or accept live payments. Use the Test Mode (test mode is only available with test project API keys).
  6. Choose payment flow: select the desired payment scenario (one-step or two-step) using the corresponding option.
  7. Set up the correlation between order statuses in OpenCart and transaction statuses and types in Tranzzo. This configuration is required for both one-step and two-step checkout scenarios.
info

For the Ukrainian language, use the OpenCart Ukr Language module.

Classic payment flow for one-step payments:

  1. Start of payment processing (purchase transaction with pending status) - Processing. The order is created, the checkout is generated, and the payer has entered their payment details and initiated the payment. The payment is being processed, or confirmation is expected from the payer (such as passing 3DS verification).
  2. Successful payment (purchase transaction with success status) - Completed. The order has been successfully paid.
  3. Error during payment (purchase transaction with failure status) - Failed. After creating the order, the payer's attempt to make a payment was unsuccessful.
  4. Full refund (either one refund transaction for the entire payment amount with success status or the sum of all partial refunds equals the payment amount) - Refunded. After a successful payment, the funds were returned in full.

Classic payment flow for two-step payments:

  1. Start of funds reservation processing (auth transaction with pending status) - Processing. The order is created, the checkout is generated, and the payer has entered their payment details and initiated the payment. The payment is being processed, or confirmation is expected from the payer (such as passing 3DS verification).
  2. Successful reservation of funds (auth transaction with success status) - Processed. Funds have been successfully held.
  3. Error during funds reservation (auth transaction with failure status) - Failed. An attempt to reserve funds failed after the order was created.
  4. Successful capture of a portion of held funds (capture transaction with success status for a part of held funds) - Complete. Successful payment using part of the amount that was previously reserved.
  5. Successful capture of the full amount of reserve (capture transaction with success status for the full amount of held funds) - Complete. Successful payment using the entire amount that was previously reserved.
  6. Voiding reservation (void transaction with success status) - Voided. The previously created reserve was cancelled.
  7. Full refund (either one refund transaction for the entire payment amount with success status or the sum of all partial refunds equals the payment amount) - Refunded. After a successful payment, the funds were returned in full.

All payments for your orders are displayed in the merchant portal. All payment types in OpenCart are shown in the corresponding entries in the list:

All payment types in OpenCart are shown in the corresponding entries in the list

caution

Secondary operations (capture, void, refund) can only be performed through the merchant portal.