OpenCart

The module is designed to install the bank payment collection system into an online store based on an OpenCart e-commerce platform.

Prerequisites: PHP 5.6 or above

The OpenCart kevin. integration has a number of editions tuned for different OpenCart versions. All the versions from 2.0 to 4.0 are supported.

OpenCart 3

Before installation

You need to have kevin. account to proceed with the integration. Make sure you have received all the required credentials. You can get those after creating the account at kevin. dashboard.

Set up kevin. in your store

1. Download the module OpenCart 3.0.x: Download the latest module here.

2. Log in to the OpenCart admin panel.

3. Navigate to Extensions ➥ Installer.

4. Click Upload and select the zip that you have downloaded in step 1.

5. Navigate to Extensions ➥ Modifications.

6. Click to rebuild your modification cache.

7. Navigate to Extensions ➥ Extensions.

8. Choose Payments (for the extension type), find kevin. payment and click to install the extension.

9. Click to edit module configuration.

10. Enter user data. 1. Credentials: Client ID, Client Secret and Endpoint Secret. (You can find your credentials on https://dashboard.kevin.eu/ after login/registration.). 2. Bank details: Receiver name and Receiver bank account. 3. Order statuses.

11. Save configuration by clicking .

Set up kevin. Refunds in your store

* kevin. refunds functionality is only available under the separate agreement with kevin.

For installing refunds module, you have to:

1. Navigate to Extensions ➥ Extensions

2. Choose Modules (for the extension type), find kevin. Refunds and click to install the extension.

Once you do this, the kevin. Refunds will become available inside the "Sales" section from the side menu.

OpenCart 4

Before installation

You need to have kevin. account to proceed with the integration. Make sure you have received all the required credentials. You can get those after creating the account at kevin. dashboard.

Set up kevin. in your store

1. Download the module OpenCart 4.0.x: Download the latest module here.

2. Log in to the OpenCart admin panel.

3. Navigate to Extensions ➥ Installer.

4. Click Upload and select the zip that you have downloaded in step 1.

5. Once the plugin is uploaded, install it by clicking .
6. Navigate to Extensions ➥ Extensions.

7. Choose Payments (for the extension type), find kevin. payment and click to install the extension.
8. Click to edit module configuration.
9. Enter user data. 1. Credentials: Client ID, Client Secret and Endpoint Secret. (You can find your credentials on https://dashboard.kevin.eu/ after login/registration.). 2. Bank details: Receiver name and Receiver bank account. 3. Order statuses.

10. Save configuration by clicking .

Set up kevin. Refunds in your store

* kevin. refunds functionality is only available under the separate agreement with kevin.

For installing refunds module, you have to:

1. Navigate to Extensions ➥ Extensions.

2. Choose Modules (for the extension type), find kevin. Refunds and click to install the extension.

Once you do this, the kevin. Refunds will become available inside the "Sales" section from the side menu.

OpenCart 2.0-2.3

Before installation

You need to have kevin. account to proceed with the integration. Make sure you have received all the required credentials. You can get those after creating the account at kevin. dashboard.

Set up kevin. in your store

1. Download the module that suits your installation. 1. OpenCart 2.0.x-2.2.x: Download the latest version here 2. OpenCart 2.3.x: Download the latest module here

2. Log in to the OpenCart admin panel.

3. Navigate to Extensions ➥ Installer.

4. Click Upload and select the zip that you have downloaded in step 1.

5. Navigate to Extensions ➥ Modifications.

6. Click to rebuild your modification cache.
7. Navigate to Extensions ➥ Extensions.

8. Choose Payments (for the extension type), find kevin. payment and click to install the extension.
9. Click to edit module configuration.
10. Enter user data. 1. Credentials: Client ID, Client Secret and Endpoint Secret. (You can find your credentials on https://dashboard.kevin.eu/ after login/registration.). 2. Bank details: Receiver name and Receiver bank account. 3. Order statuses.

11. Save configuration by clicking .

Troubleshooting

A blank page is shown when I try access module settings

If you try to configure the module but a blank is shown, try clear the cache. Navigate to Plugins → Modifications and click the blue refresh button on the top right side of the page.

A warning about insecure connection is shown on a checkout page

Such warning is caused because of internal OpenCart insecure HTTP requests which are being executed before kevin’s module request to our system. Make sure that you have right configurations inside your config.php file and all urls are defined as HTTPS:

// HTTP
define('HTTP_SERVER', 'https://your_shop.com/');
// HTTPS
define('HTTPS_SERVER', 'https://your_shop.com/');

Also make sure that you have configured right rewrite rules inside your .htaccess file:

RewriteCond %{HTTP_HOST} ^www\.(.*)$ [NC]
RewriteRule ^(.*)$ https://%1/$1 [R=301,L]
RewriteCond %{HTTPS} !on
RewriteRule (.*) https://%{HTTP_HOST}%{REQUEST_URI} [R=301,L]

After these changes all your OpenCart shop URLs should be generated as HTTPS.

New orders are placed to Missing orders

When creating an order, the initial status is pending and order is moved to Missing order section. The order will stay here as long as order will not reach its final status: completed or failed. The payment may not be finished for a few possible reasons:

• The customer closed the browser.

• The customer came back to the checkout and made another order.

• The customer canceled the order on a consent page.

• The payment is still pending and module hasn’t received a webhook yet.