OpenCart 1.5

The Viva Wallet plugin for OpenCart 1.5 enables you to receive payments to OpenCart 1.5 via the Viva Wallet payment gateway.

Prerequisites

• Log in to the Viva Wallet banking app, demo or live .
• Find your Merchant ID and API Key.
• Download API-master.zip to your desktop.

Setup instructions

Adding the Viva Wallet plugin to OpenCart 1.5 consists of the following steps.

Step 1: Create a payment source

To add a new payment source in the Viva Wallet banking app:

1. Click on Sales in the left navigation:
   
   

2. Click on Online payments in the Sales menu.

3. Click on Websites / apps in the Online payments menu:
   
   

4. Click on the Add Website/App button in the top right-hand corner:
   
   
   The New Payment Source dialog box is displayed:
   
   

5. Complete the fields as follows:

   • Code – the four-digit number in the top-left of the dialog box is the ‘Source Code’. Make a note of it for use in your plugin.
   • Source Name – give your payment source a source name so you can recognise it in your reports.
   • Linked Wallet – link the payment source to the required wallet.
   • Protocol – if your e-commerce platform uses SSL on the checkout, select https, otherwise use http.
   • Domain Name – enter the domain name to be associated (without the protocol. i.e. use [(www.)yourdomain.com], not http://[yourdomain].com). If the site uses www, it must be specified and visa versa.
   • Integration method – leave this with redirection selected.
   • Company Logo - a PNG of your company logo to be displayed on the Viva Wallet payment page.
   • Success URL – enter index.php?route=payment/vivawallet/callback&success¹
   • Failure URL – enter index.php?route=payment/vivawallet/callback&fail²

6. Click on the Create button to finish creating the payment source.

Once the payment source moves from a status of ‘Pending’ to ‘Active’ in the Website/Apps list, it’s ready to use. This should take no longer than 24 hours.

Step 2: Integrate with your e-commerce store

To start using Viva Wallet as the payment gateway within OpenCart 1.5:

1. Unzip the archive (API-master.zip) you downloaded earlier.

2. Open the directory (API-master⁩/Plugins⁩/opencart/OpenCart 1.5) containing the source files.

3. Copy the files to your opencart installation keeping the folder structure.

4. Overwrite files/folders as necessary (no core opencart files will be overwritten).

5. Log in to the Open Cart admin section and go to Extensions > Payments.

6. Find Vivawallet in the list of extensions.

7. Click Install and then Edit the payment module settings.