OpenCart 3

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


Prerequisites


Setup instructions

Adding the Viva Wallet plugin to OpenCart 3 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 – enter index.php?route=extension/payment/vivawallet/callback&success
    • Failure URL – enter index.php?route=extension/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 3:

  1. Do one of the following:

    • Extract the contents of the ZIP archive (vivawallet.ocmod.zip) downloaded earlier and upload the files from the upload directory to their corresponding location on the server with ftp/ssh.
    • Using the extension installer, click on the Upload button and browse to the ZIP archive (vivawallet.ocmod.zip).
  2. Overwrite files/folders as necessary (no core opencart files will be overwritten).

  3. Login to the Open Cart admin section and go to Extensions > Payments.

  4. Find Vivawallet in the list of extensions.

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

  6. Use the source code (digit number like 1234) in the payment modules settings.