PrestaShop 1.5-1.6

Our plugin for PrestaShop 1.5-1.6 enables you to receive payments to PrestaShop 1.5-1.6 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 vivawallet1.5_1.6.zip to your desktop.

Setup instructions

Adding the Viva Wallet plugin to PrestaShop 1.5-1.6 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 – modules/vivawallet/success.php
   • Failure URL – modules/vivawallet/fail.php

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

Step 2: Integrate with your e-commerce store

To start using Viva Wallet as the payment gateway within PrestaShop 1.5-1.6:

1. Install the previously downloaded ZIP archive (vivawallet1.5_1.6.zip) through your stores module manager (add new module).

2. The module will show in your store admin under modules / payments & gateways.

3. Enable and configure the Viva Wallet module as follows:

   • Instalment logic – Greece only. Complete if you wish to offer instalments otherwise leave blank.
   • Base URL – https://www.vivapayments.com (production) or https://demo.vivapayments.com (demo)
   • MerchantID – your production Viva Wallet Merchant ID (demo Merchant ID if testing)
   • API Key – your production Viva Wallet API Key (demo Viva Wallet API key if testing)
   • Source Code – 4-digit code for the payment source you set up in the Viva Wallet banking app. Use one from the demo environment if testing.

Step 3: Set an optional webhook

1. Go to Settings > API Access > Webhooks in the Viva Wallet banking app:
   
   
   

2. Click on Create Webhook.
   The New Webhook dialog box is displayed:
   
   

3. In the Url field, enter http(s)://(www.)mysite.com/modules/vivawallet/webhook.php, exchanging the placeholder for your actual domain name.

4. Choose Transaction Payment Created from the Event Type dropdown.

5. Click on the Save button.