Drupal Commerce

The Viva Wallet plugin for Drupal Commerce enables you to receive payments to Drupal Commerce via the Viva Wallet payment gateway.


Prerequisites

Before you begin:


Setup instructions

Adding the Viva Wallet plugin to Drupal Commerce 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 vivawallet/success/
    • Failure URL – enter vivawallet/fail/
  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 Drupal Commerce:

  1. If applicable, uninstall previously installed VivaWallet / Viva Payments payment module (admin/modules).

  2. Install the new module (Modules - Install new module - Upload a module).

  3. Browse to the ZIP archive (commerce_vivawallet-7.x-1.0.zip) you downloaded earlier to your desktop.

  4. Enable the Viva Payments payment module (admin/modules).

  5. Enable and configure the Viva Payments payment module (store/configuration/payment methods).