OpenCart

About OpenCart

OpenCart is a free web platform that enables users to quickly start an eCommerce with the minimum amount of settings and configurations required.

We put at your disposal the plugin for OpenCart, that brings the functionalities for you to add and set up Openpay's supported payment methods (credit card, stores and wire transfers) inside the shopping flow of your eCommerce based on this platform.

View Source on GitHub

Supported versions

OpenCart 2.0.1.1 or greater

Requirements

It is required for the server that hosts your OpenCart store to fulfill the following:

Apache web server
PHP 5.2 or greater.
MySQL 5.0 or greater.
Have a SSL certificate for your eCommerce domain.

It is also necessary that the installed PHP version comply with these settings:

Register Globals disabled.
Magic Quotes GPC disabled.
File uploads enabled.
Session Auto Start disabled.
GD (with PNG image processing) extension enabled.
cURL extension enabled.
ZIP extension enabled.

Installation

In order to install the Openpay plugins on your OpenCart store you need to follow these steps:

Note: This installation sequence has to be performed for each plugin you want to enable.

Download the ZIP file that contains all the plugins. You can use this link to download it.
Unzip the downloaded file. Inside the directory are the Openpay payment methods.

On your OpenCart admin panel, go to Extensions -> Installer. Click the Upload button, browse and select the ZIP file of the payment method's plugin you want to install.

If you come across with the error FTP needs to be enabled in the settings during the installation, you will have to install a platform fix that you can download using this link. Follow the guidelines provided in that site in order to apply this fix successfully.

Go to Extensions -> Payments, find in the list the uploaded plugin and click the Install option.

Look for the success message.

Setup

On your Openpay admin panel, identify the API credentials assigned to your merchant account.

Find the credentials by clicking the cog icon on the upper right corner of the screen, then select Credenciales de API.

On your OpenCart admin panel, go to Extensions -> Payments. Find the recently installed plugin and click the Edit button.

Fill in the configuration form keeping in mind the following guidelines:

General settings
- Test mode: Defines whether the plugin is working on a testing or a productive environment.
- Test Merchant ID, Secret Key, Publishable Key: Openpay's merchant account API credentials (check out step 1), on testing environment.
- Live Merchant ID, Secret Key, Publishable Key: Openpay's merchant account API credentials (check out step 1), on productive environment.
Common module settings
- Status: Defines whether the payment method will be available to your customers or not.
- Title: Payment method caption to be shown to your customer on your eCommerce's shopping flow.
- Total: Minimum purchase amount to make available the payment method.
- Sort order: Order in which the payment method is shown.
Card payments settings
- How to process the charge? Defines the type of charge to be made:
  1. Direct: An evaluation of the charge will be carried out and it will be rejected if the anti-fraud system detected any anomaly.
  2. 3D Secure: A redirect to the bank will be carried out so that the client is authenticated in his bank.
  3. Selective authentication: An evaluation of the charge will be carried out and if the anti-fraud system detects any anomaly, a 3D secure charge will be executed.
- Charge settings.- Indicates whether the charge is made immediately or not.
- Payment with points.- Receive point payments with BBVA, Santander and citibanamex.
- Save cards.- Enable saving credit cards.
- Months without interest.- You can enable or disable card payments to months without interest by selecting 3,6,9,12 or 18.
Offline payments settings
- Deadline to pay (hours): Number of hours in which your customers will be able to make the payment, once the order is placed.
- Show map: It shows the closest stores at the time of generating the payment receipt.
Store payment

Banks payments
Save your changes by clicking the button on the upper right corner of the screen.

Look for the success message.

Store and SPEI payment notifications

The plugin is prepared to receive payment notifications automatically, that is, without the need to configure your Openpay account or plugin. Notifications are sent to merchant when when a charge was made or when a payment reference was expired.

Important: The plugins assume that the store must reside in the root of the domain, so the webhook is created based on this url.

# Store payments
https://[eCommerce domain]/index.php?route=extension/payment/openpay_stores/webhook
# SPEI (wire transfer)
https://[eCommerce domain]/index.php?route=extension/payment/openpay_banks/webhook