Source for Online payments

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 Online payments in the Viva Wallet banking app:

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

    You should fill the code 111111 to pass through successfully the Two-Factor Authentication functionality in demo environment.

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

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

      If you are using one of our Plugins, the Success URL must be a specific value. Please refer to the Plugin URLs table below.

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

      If you are using one of our Plugins, the Failure URL must be a specific value. Please refer to the Plugin URLs table below.

      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 have any questions about our solutions, or questions about how to integrate with our solutions, please refer to our Get Support page.