Payment source for plugins

A payment source is where you provide details such as the domain name for your online store, the Viva Wallet account the payments will be deposited into (in case you have many), your company logo to show to the customer on the payment form, and so on. Multiple sources must be created when managing multiple online stores; each online store then has its own source. Also, you may want to use multiple sources, even for the same online store, in case you want to group and filter transactions (e.g. for different product categories).

To add a new payment source for one of our plugins in the Viva Wallet banking app:

  1. Log in to Viva Wallet, demo or live , and select the required account.

  2. Click on Sales in the left navigation:

    Sales menu

  3. Click on Online payments in the Sales menu.

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

    Online payments menu

  5. 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

  6. Complete the fields as follows:

    • Code – the four-digit number in the top-left of the dialog box is the ‘Source Code’.
    • 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 yourdomain.com, not http://yourdomain.com). If the site uses www, it must be specified so you would need to use www.yourdomain.com and not http://www.yourdomain.com.
    • Integration method – leave this with Redirection/Native Checkout v2 selected.
    • Company Logo - a PNG of your company logo to be displayed on the Viva Wallet payment page.
    • Success URL – depends on the e-commerce platform / plugin you’re using. Please see table below for the relevant information.
    • Failure URL – depends on the e-commerce platform / plugin you’re using. Please see table below for the relevant information.

      Plugin nameSuccess URLFailure URL
      OpenCart 3index.php?route=extension/payment/vivawallet/callback&successindex.php?route=extension/payment/vivawallet/callback&fail
      Magento 2.3vivapayments/viva/callbackvivapayments/viva/callback
    • Checkboxes – read the information against each one and select them all.
  7. Click on the Create button to finish creating the payment source.