API Reference

OpenCart User Guide

OpenCart

OpenCart is an online store management system. It is PHP-based, using a MySQL database and HTML components. Support is provided for different languages and currencies. It is freely available under the GNU General Public License. As of May 2016, 342,000 websites were using OpenCart. It is an open source PHP-based online e-commerce solution.

Generating API Keys

Objective

To perform any request on Valor virtual terminal, one should have the following credentials:

APP ID

The App ID is a unique identifier created and assigned to each merchant in the Valor Portal.

  • It is used to recognize the merchant’s account when an API call is made.
  • It tells ValorPay which merchant’s system is sending the request.

APP KEY

The App Key is a secure code created and assigned to a merchant’s EPI in the Valor Portal.

  • It is used to authenticate the EPI when an API request is made.
  • It allows ValorPay to identify and confirm which EPI has initiated the request.

EPI

  • Basically EPI is an end point identifier, Identify the device on valor infrastructure, any devices including virtual terminal will be identified as an EPI, typically it's a 10 digit number starts with 2

STEPS TO CREATE APP ID AND APP KEY

STEP 1 - Log Into The Valor Portal

STEP 2 - Click Virtual Terminal in menu

STEP 3 - Click Manage Button

STEP 4 - Select API KEYS Tab

STEP 5 - Here you need to select the EPI to generate API Key.

STEP 6 - Enter these keys to the settings tab of the ValorPay application, choose your settings and click ‘Submit’.

Once you installed OpenCart extension use this credentials in the payment gateway configuration.

Download Extension

You can download the ValorPay plugin from the Valor Pay Portal or from
Developer ValorPaytech

  1. To download from portal go to Resource Center -> Plugin and click Opencart.zip.
  2. Extract the zip you can find the extension zip in it valorpay.ocmod.zip

Installing Extension

Valorpay extension installation steps.

  1. In order to upload an extension, navigate to Extensions > Installer.
  2. Then click the blue upload button.

  1. Upload the valorpay.ocmod.zip

  1. Once the extension is successfully uploaded, Go to Extension sub menu and In Choose
    the extension type     and select Payment

  2. Locate ValorPay and click Install.

  1. Once the Valorpay extension is installed, click on Edit to configure the payment-related settings.

Here you need to configure the APP ID, APP KEY and EPI. Refer to the Generating API Keys section to get APP ID, APP KEY and EPI from the valor portal.

Valor Payment Method - Frontend

Once the ValorPay Enabled and Configured we can view the payment Gateway in the checkout page.

To process transactions we need to enter the Card information.

Valor Payment Details in Order View - Backend

To view Valor Pay information in the backend, go to Sales > Orders and select the order.