Navigation:

TomatoCart

Our plugin for TomatoCart enables you to receive payments to TomatoCart via the Viva Wallet payment gateway.

Before you start

Log in to Viva Wallet, demo or live , and select the required account.
Find your Merchant ID and API Key.
Download API-master.zip to your desktop.

Setup instructions

Adding the Viva Wallet plugin to TomatoCart consists of the following steps.

Step 1: Create a payment source

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

Click on Sales in the left navigation:
Click on Online payments in the Sales menu.
Click on Websites / apps in the Online payments menu:
Click on the Add Website/App button in the top right-hand corner:

The New Payment Source dialog box is displayed:
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 – checkout.php?callback&module=vivawallet&success
- Failure URL – checkout.php?callback&module=vivawallet&fail
Click on the Create button to finish creating the payment source.

During payment source activation, our team will update your payment source from a status of ‘Pending’ to ‘Active’ in the payment source list. This process normally takes a maximum of two working days after submitting the source.

Step 2: Integrate with the plugin

To start using Viva Wallet as the payment gateway within TomatoCart:

Unzip the archive (API-master.zip) you downloaded earlier.
Open the directory (API-master⁩/Plugins⁩/tomatocart/vivawallet) containing the source files.
Copy these files to your TomatoCart installation keeping the folder structure.
In Start > Modules > Payment Modules on the Admin page, click on Install opposite Vivawallet, then click Edit and enter your settings.

Step 3: Integrate with your e-commerce store

Go to Settings > API Access > Webhooks in the Viva Wallet banking app:
Click on Create Webhook.
The New Webhook dialog box is displayed:
In the Url field, enter http(s)://(www.)your_domain.com/checkout.php?callback&module=vivawallet&webhook, exchanging the placeholder for your actual domain name.
Choose Transaction Payment Created from the Event Type dropdown.
Click on the Save button.