Viva.com | Smart Checkout

Integrate Viva.com with your WooCommerce store to process and sync your payments & refunds and help you sell more.

Our Viva.com lets you accept payments directly to your store. It supports the following payment types and methods:

• Visa
• Mastercard
• American Express
• Maestro
• Apple Pay
• Bancontact
• JCB
• iDEAL
• P24
• MULTIBANCO
• giropay
• EPS
• PayU
• BitPay
• WeChat Pay
• Sofort
• Discover
• Diners Club International
• Instalments (Greece only)
• Subscriptions (needs WooCommerce Subscriptions)

• Viva.com | Account (sandbox account for demo)
• PHP 7.3.0+ (you can see this under WooCommerce > Status)
• WordPress 5.1+
• WooCommerce 3.5.0+
• An active domain name that points to your e-commerce site
• TLS 1.2 or higher protocol
• php cURL extension

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.
4. Go to Plugins > Add New > Upload Plugin and select the ZIP file you just downloaded.
5. Click Install Now then Activate Plugin.
6. Find Viva.com | Smart Checkout in the list and click Settings.
7. Now proceed to the next section, below, to find out how to configure the plugin.

See upgrading the plugin further down this page. Once you have enabled the new plugin in the plugins list, proceed to Step 1 of ‘Getting started’, below.

Before going any further, you need to ensure your WooCommerce currency is set to the same as your Viva.com | Account currency: WooCommerce > Settings > General > Currency options. There are 10 currencies available. Which one you should choose is dependent on the country in which you registered your Viva.com | Account:

• BGN – Bulgarian lev (Bulgaria)
• CZK – Czech koruna (Czechia)
• DKK – Danish krone (Denmark)
• EUR – Euro (Austria, Belgium, Cyprus, Finland, France, Germany, Greece, Ireland, Italy, Malta, Netherlands, Portugal, Spain)
• GBP – Pound sterling (UK)
• HRK – Croatian Kuna (Croatia)
• HUF – Hungarian Forint (Hungary)
• PLN – Polish złoty (Poland)
• RON – Romanian leu (Romania)
• SEK – Swedish Krona (Sweden)

To configure your WordPress site language, go to Settings > General and look for the Site Language drop-down. If your required language is not listed under Installed, you will find it under Available.

All you need to do is choose your desired language and save your changes:

If one of the supported languages is selected, the Viva.com | Smart Checkout settings page and customer payment form will also be displayed in that language.

First, you need to grab your WooCommerce credentials from your Viva.com | Account:

1. Log in to Viva.com, demo or live, and select the required account
2. Go to Settings > API access
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):

   

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

1. Select the Enable Viva.com | Smart Checkout checkbox.
   
2. Tick the Enable demo mode checkbox, if you wish to test before going live. Untick to begin accepting payments with Viva.com Smart Checkout.
3. Enter your Live Client ID and Live Client Secret (obtained from your Viva.com | 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.com | Account. You’re ready to start receiving payments from your customers through Viva.com Smart Checkout.

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

• If you wish, you can edit the Title and Description seen by the customer during checkout.
• Clicking the Source Code List dropdown displays the current payment source codes available in your Viva.com | Account.
• The Show Viva.com logo checkbox can be deselected if you wish to remove any Viva.com branding from your checkout.
• The Show credit card logo on checkout page can be deselected if you wish to disable the ability to show the issuer branding after card number validation.
• The Order status after successful payment dropdown enables you to choose Processing if more appropriate than the default Completed option. Which option you should select depends on the type of business you operate. E.g., for instantly available digital downloads, ‘Completed’ is appropriate, but for products where you need to check stock levels after taking payment, ‘Processing’ is more meaningful. 

Your store needs to be set to a Greek state via WooCommerce > Settings > Country / State. Currency needs to be set to EUR in WooCommerce > Settings > General > Currency options. If all the requirements are satisfied, you will be able to see an additional field under advanced settings:

If you have a Viva.com | Account set up in Greece and want to allow customers to pay by instalments, you can define the instalment rules here.
Example: 90:3,180:6
This means:
Order total < 90 Euros –> offer 0 installments;
Order total >= 90 Euros and < 180 Euros –> offer 0 or 3 installments;
Order total >= 180 Euros –> offer 0 or 3 or 6 installments.
Leave empty if you do not want to offer installments.

There are two ways in which you can perform a plugin upgrade.

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.com | Smart Checkout.
   Now, with each new release of our plugin, you’ll be prompted to update it. Clicking on the Update now link under the Viva.com | Smart Checkout entry on the plugins page will do this immediately. Your previous settings will be retained.

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. Now go to Step 1 of ‘Getting started’.

When testing in demo mode enter the above in place of real card details. This will mimic a successful 3DS authentication and payment.

You can visit Viva.com developer portal for more test cards.

In both cases, the new payment source is activated immediately. However, on live, our team also checks the WooCommerce website assigned to the payment source in case of any potential issues.

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.com | Smart Checkout 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.com 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.

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.com button:
   
4. The order status is amended accordingly on the ‘Orders’ page:
   

Please email woosupport@vivawallet.com.

Solutions to common problems.

This is caused by WooCommerce detecting a security issue. It usually means you have auto-generation of user password switched on in your WooCommerce settings. In your wp-admin, go to WooCommerce > Settings > Accounts & Privacy. Make sure that the When creating an account, automatically generate an account password checkbox indicated in the screenshot below is not selected:

Ensure that you have entered the correct credentials. If you are in live mode, you should have entered live credentials (not demo keys).

View and download logs

If this does not solve the error and you need to troubleshoot the issue, we have a log facility you can access. From within WP Admin, do the following:

1. Go to WooCommerce > Status > Logs tab:

   

2. Select required date with prefix “wc-vivacom-smart” from the dropdown and click on the View button. A log file example is shown below with sensitive info blurred out:
   
3. Copy the contents into a text file and save it with an appropriate name.
4. Repeat steps 2 and 3 to review and collect additional relevant logs

Other issues could relate to your WordPress theme, other plugins you have installed or JavaScript problems.

WordPress theme

If using an extended or custom theme, try temporarily replacing with one of the default ones from WordPress.

Other third-party plugins

Try the following in case another plugin is interfering with the Viva.com Smart Checkout extension:

• Disable all plugins except WooCommerce and Viva.com Smart Checkout.
• Test the checkout with Developer Tools > Console open in your browser.
• If you see no errors you should try to enable one plugin at a time and check again. This way you should be able to find the plugin that is creating the issue.

JavaScript errors

The WordPress team have written a support guide on how to troubleshoot these types of error using your browser console.

Fatal error: Uncaught InvalidArgumentException: Subscription doesn't exist in scheduled action: 0 in /home/customer/www/zenbears.co.uk/public_html/wp-content/plugins/woocommerce-subscriptions/vendor/woocommerce/subscriptions-core/includes/class-wc-subscriptions-manager.php:167 
Stack trace: #0 /home/customer/www/zenbears.co.uk/public_html/wp-content/plugins/viva-wallet-for-woocommerce/includes/class-wc-vivawallet-subscriptions.php(58): WC_Subscriptions_Manager::expire_subscription(0) 
#1 /home/customer/www/zenbears.co.uk/public_html/wp-includes/class-wp-hook.php(308): WC_Vivawallet_Payment_Gateway_Subscriptions->scheduled_subscription_payment('14.16', Object(Automattic\WooCommerce\Admin\Overrides\Order)) 
#2 /home/customer/www/zenbears.co.uk/public_html/wp-includes/class-wp-hook.php(332): WP_Hook->apply_filters('', Array) 
#3 /home/customer/www/zenbears.co.uk/public_html/wp-includes/plugin.php(517): WP_Hook->do_action(Array) 
#4 /home/customer/www/zenbears.co.uk/public_html/wp-content/plugins/woocommerce-subscriptions/includes in /home/customer/www/zenbears.co.uk/public_html/wp-content/plugins/woocommerce-subscriptions/vendor/woocommerce/subscriptions-core/includes/class-wc-subscriptions-manager.php on line 167

This error can sometimes occur during subscription renewals when using the WooCommerce Subscriptions plugin. You can resolve this error by ensuring that recurring payments are enabled in your Viva.com | Account – API Security features: