Source for Online payments

These sources are used for online payments through Smart Checkout, our plugins and our payment tools.

Add a payment source

To add a new payment source for Online payments, please follow the steps below:

  1. Log into Viva Wallet (either demo or live ) and select the relevant account

  2. Click on Sales in the left navigation menu:
    Sales menu

  3. Navigate to Online payments > Websites/Apps:
    Online payments menu

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

  5. You will see the New Payment Source dialog box displayed:
    New Payment Source dialog box

  6. Complete the fields as follows:

    • Code – The four-digit number at the top-left of the dialog box is the ‘Source Code’ - the unique code of this payment source. This code is automatically generated, but you can choose a different value if preferred (for organisational purposes, for example). If you are utilising our Payment API, this code is passed within the sourceCode parameter when creating a payment order

    • Source Name – In addition to the Source Code, you can also give your payment source a name. This allows you to more easily recognise the source within your account and within reports (for example, the Sales Clearance report)

    • Linked account – Choose which account (wallet) to link this payment source to. When this payment source is used, funds will be deposited into the chosen account. You can link several different sources to one account, if desired

    • Protocol – If your e-commerce platform uses SSL on the checkout, select https. If your platform does not use SSL (as is the case with some development environments, for example), use http

    • Domain Name – Enter the domain to be associated with this payment source. You do not need to add the trailing slash (\) or the protocol (http:// or https://). For example:

      • If your site uses www: www.yourdomain.com
      • If your site doesn’t use www: yourdomain.com
    • Integration method – Leave this as Redirection/Native Checkout v2

    • Company Logo - Upload your company logo to be associated with this payment source, in Transparent PNG format up to 100KB in size (suggested: 128 x 128 pixels). This is an important step as the logo will be displayed on your payment page, helping customers identify and validate your company

    If you are using one of our Plugins, the following Success & Failure URLs may need a specific value. Please refer to the Plugin URLs table below

    • Success URL – This is the URL of the page the customer will be directed to upon a successful payment. For example, you could use this to present a confirmation or ‘thank you’ page to the customer

    • Failure URL – This is the URL of the page the customer will be directed to upon an unsuccessful payment. For example, you could use this to return the customer to the final step of the checkout process so they may attempt the transaction again

    Plugin URLs
    Plugin nameSuccess URLFailure URL
    WooCommerce Smart Checkoutindex.php?wc-api=wc_vivawallet&vivawallet=successindex.php?wc-api=wc_vivawallet&vivawallet=fail
    PrestaShop Smart Checkoutmodule/vivawallet/successmodule/vivawallet/fail
    OpenCart Smart Checkoutindex.php?route=extension/payment/vivawallet/callback&successindex.php?route=extension/payment/vivawallet/callback&fail
    Magento Smart Checkoutvivapayments/viva/callbackvivapayments/viva/callback

  7. Optional: review the ‘Advanced Configuration’ section:

    The Advanced Configuration section (as shown below) provides the ability to amend the names of the URL parameters which are appended to your Success/Failure URLs after a transaction is made:

    Advanced Configuration options

    The three configurable parameters are:

    Parameter Default Name
    Order Codes
    Transaction IDt
    Languagelang

    It is recommended to leave these parameters with their default names, unless you specifically require different parameter names to align with your internal systems or processes

  8. Finally, read the information against each of the checkboxes at the bottom of the screen. You will need to agree to these in order to create the payment source. Once you have checked all of these, click on the Create button to complete the process.

Get Support

If you would like to integrate with Viva Wallet, or if you have any queries about our products and solutions, please see our Get Support page to see how we can help!