Magento 1.x

Our plugin for Magento 1.x enables you to receive payments to your Magento online store via the Viva Wallet payment gateway.

Adobe is to withdraw support for Magento 1 on 30 June 2020. After this date, Viva Wallet will not guarantee or support the below plugin. To ensure compliance with the Payment Card Industry Data Security Standards (PCI DSS), we recommend migrating to Magento 2 or another platform as soon as possible.

Before you start

Setup instructions

Adding the Viva Wallet plugin to Magento 1.x 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:

    Sales menu
  2. Click on Online payments in the Sales menu.

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

    Online payments menu

  4. Click on the Add Website/App button in the top right-hand corner:

    Add Website button
    The New Payment Source dialog box is displayed:

    New Payment Source dialog box

  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 – examples:
      with URL rewrite disabled: index.php/vivawallet/hpay/hpok/
      with URL rewrite enabled: vivawallet/hpay/hpok/
    • Failure URL – examples:
      with URL rewrite disabled: index.php/vivawallet/hpay/hpnok/
      with URL rewrite enabled: vivawallet/hpay/hpnok/
  6. 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 one working day after submitting the source.

Step 2: Integrate with your e-commerce store

To start using Viva Wallet as the payment gateway within Magento 1.x:

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

  2. Open the directory (API-master⁩/Plugins⁩/magento⁩/magvivawallet⁩/app) containing the source files.

  3. Upload the files to their corresponding location on the server (ftp/ssh).

  4. Clear Magento cache.

  5. In the Magento store settings:

    • MerchantID – your Viva Wallet Merchant ID
    • API Key – your Viva Wallet API Key
    • Source Code – 4-digit code for the payment source you set up in the Viva Wallet banking app
    • OrderCode URL – https://www.vivapayments.com/api/orders
    • Gateway URL – https://www.vivapayments.com/web/newtransaction