Viva Wallet for WooCommerce

Our latest payment plugin for WooCommerce integrates natively with your store enabling you to synchronize sales, refunds, bank transfers and customer data between WooCommerce and Viva Wallet. It features next-day settlement, PCI DSS Level 1 compliance and Strong Customer Authentication (SCA). Supported payment methods:

Requirements

Downloading the plugin

  1. Click on the Free Download button on our product page .
    A shopping cart is displayed.

  2. Complete the form with your details and click on the Purchase button. Note that as this is a free download you will not be asked for payment.
    A confirmation page is displayed.

  3. Click on the Download link to download to your local machine.

Installation

  1. Ensure your store meets the plugin requirements above.

  2. Go to Plugins > Add New > Upload Plugin on your Wordpress site and select the ZIP file you just downloaded.

  3. Click Install Now then Activate Plugin.

  4. Find Viva Wallet for WooCommerce in the list and click Settings.

  5. Now proceed to the next section, below, to find out how to configure the plugin.

Getting started

First you need to make sure your WooCommerce currency is set to the same as your Viva Wallet account currency: WooCommerce > Settings > General > Currency options. There are 5 currencies available. Which one you should choose is dependent on the country in which you registered your Viva Wallet account:

Viva Wallet for WooCommerce credentials

Next, you need to grab your WooCommerce credentials from your Viva Wallet account:

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

  2. Go to Settings > API access:

    API access page

  3. Scroll down to WooCommerce Credentials and click on Generate a pair of credentials.

  4. Make a temporary copy of the values in notepad (or similar).

    WooCommerce credentials

Required settings

From WooCommerce > Settings > Payments on your Wordpress site, do the following:

  1. Select the Enable Viva Wallet checkbox at the top of the page:

    Viva Wallet payment module settings

  2. Tick the Enable demo mode checkbox, if you wish to test before going live. Untick to begin accepting payments with Viva Wallet.

  3. Enter your Live Client ID and Live Client Secret (obtained from your Viva Wallet account earlier). The Demo Client ID and Demo Client Secret are different and should only be used when ‘Enable demo mode’ is selected in step 2.

  4. Click on Save changes. A confirmation message will be displayed with the payment source code that the plugin set up automatically within your Viva Wallet account. Once the payment source is activated , you’re ready to start receiving payments from your customers through Viva Wallet.

Advanced settings

Selecting the Show advanced settings checkbox on the same page reveals further options:

Advanced settings

Plugin updates

Automatic

If you need to update the extension you can do this automatically from the WordPress plugins page. However, first you need to make sure you have connected your site to WooCommerce.com. To do that:

  1. Go to WooCommerce > Extensions on your Wordpress site and select the WooCommerce.com Subscriptions tab.

  2. Click on the Connect button.
    A confirmation message is displayed.

  3. Click on the Approve button.

  4. Open the Plugins page and click on the Enable auto-updates link next to the Viva Wallet for WooCommerce entry.
    Now, with each new release of our plugin, you’ll be prompted to update it. Clicking on the Update now link will do this immediately.

Manual

You can also update manually by downloading the latest version from your WooCommerce account .

Once you have the zip file downloaded, you should deactivate and delete the existing version from the Plugins page on your Wordpress site. Then you can install the new version using the Upload Plugin option. You will not lose any settings or data by updating in this way.

FAQs

Are there card numbers I can use for testing?

Yes, please see card details below, for use in demo mode only. No actual payments can be made within this environment but you can use these cards to make demo payments of 30p or more.

Visa

Mastercard

After submitting a payment request, you will see a popup which gives you the option of simulating either a successful authentication or a payment failure. This is useful for test purposes.

Is there any difference in the setup process between demo and live?

Yes, when you wish to test on demo, using our sandbox, the payment source is activated immediately. However, on live, this may take up to 2 business days while our team verifies against the following criteria:

Can I test the plugin using a development server?

For test purposes, the best option is to have a staging site, e.g. staging.yourdomain.com. You can replicate your live site and try out the Viva Wallet for WooCommerce plugin without using a public domain name.

Another way is to set up a development environment on a local machine, but in this case you’ll need to use domain masking as localhost won’t work. You’ll need a directive in your hosts file so that you can navigate to www.yourdomain.com but the browser will serve the local site. This way you can test locally, make sure everything works, then apply the changes to your production website.

For both these options you should try the plugin in demo mode, configured with the WooCommerce credentials from your Viva Wallet sandbox account .

Another option for local testing is to use ngrok , an application for exposing a web server running on your local machine to the internet. View ngrok documentation .

Can I refund a customer from Viva Wallet?

Yes, you can do this through the WooCommerce ‘Orders’ page as follows:

  1. Click on the required order to view the order details page.

  2. Enter refund amount, full or partial.

  3. Click Refund via Viva Wallet button:

    Refund via Viva Wallet

  4. The order status is amended accordingly on the ‘Orders’ page:

    WooCommerce orders page

Where can I get support?

Please email woosupport@vivawallet.com .