How to configure VivaWallet for your Ecwid by Lightspeed store?

Viva Wallet is the first European entirely cloud-based Neobank, using Microsoft Azure with presence in 24 countries in Europe.

Viva Wallet is a Principal Member of Visa and Mastercard for acquiring and issuing services.

Viva Wallet provides businesses of all sizes card acceptance services through the innovative Viva Wallet POS app, add-on Google Play devices and through advanced payment gateways in online stores. It also offers business accounts with local IBAN and a business Viva Wallet Mastercard card.

Why does Your Ecwid by Lightspeed Store needs VivaWallet?

Conversion increase by up to 21%: Increase your online store's conversion rates by enabling your customers to process their payments in less than 30 seconds.

Constantly self-updated: Further improve conversion with regular automatic updates, which continuously enrich your checkout with new payment methods.

Security & Compliance: With advanced fraud protection using Machine Learning algorithms and compliance aligned with regulatory & security rules (PSD2, SCA/3DS, PCI, etc.), your checkout is secure and fully compliant.

Superior to API-based checkouts: The Smart Checkout offers unique features across merchants, countries and payment methods, that an API-based checkout cannot.

How I start?

Simply, by installing VivaWallet for Ecwid by Lightspeed app. After that you just have to configure necessary fields for the integration and your shop is ready to use VivaWallet.

More info & FREE Trial

How do I configure the app?

Get your Merchant ID, API Key, Client ID and Secret ID

1. Log into your VivaWallet portal
2. Navigate to "Settings" -> "API Access"
3. Locate "Smart Checkout Credentials"
   1. If you have never used the "Smart Checkout Credentials", then click on the button "Generate a pair of credentials". This will open a popup with your Secret ID. Make sure to copy it, as you will not be able to see it again.
   2. If you have used the "Smart Checkout Credentials" before, then you will already see your Client ID
   3. Copy the Merchant ID, API Key, Client ID and Secret ID
   4. Navigate to the Ecwid by Lightspeed VivaWallet app dashboard and paste the Merchant ID, API Key, Client ID and Secret ID into respective fields.

Need more help? Check the official tutorial.

Create a Payment Source

1. Navigate to "Sales" -> "Online Payments" -> "Websites/Apps"
2. Click on "Add Website/App" button in the top right-hand corner
3. The New Payment Source dialog box is displayed:
4. Complete the fields as follows:
   1. 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.
   2. 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).
   3. 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.
   4. 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.
   5. 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
   6. Integration method - Leave this as Redirection/Native Checkout v2.
   7. 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.
   8. Success URL - This is the URL of the page the customer will be directed to upon a successful payment. Here, you need to put only ?viva=success
      • If you use some sort of Ecwid integration (via Wordpress, Duda, Wix or some other platform) it might be possible that you are not loading the store on your home page. In that case, navigate to your cart page and copy everything after domain host and /. Example: yourdomain.com/my_cart_page and paste that part like this: my_cart_page?viva=success
   9. Failure URL - This is the URL of the page the customer will be directed to upon an unsuccessful payment. Here, you need to put only ?viva=fail
      • If you use some sort of Ecwid integration (via Wordpress, Duda, Wix or some other platform) it might be possible that you are not loading the store on your home page. In that case, navigate to your cart page and copy everything after domain host and /. Example: yourdomain.com/my_cart_page and paste that part like this: my_cart_page?viva=fail
   10. Advanced Configuration - If you use some sort of Ecwid integration (via Wordpress, Duda, Wix or some other platform), you need to open the Advanced Configuration section and update Order Code field. Instead of a default s insert sid instead.
   11. 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.
5. Copy the Source Code
6. Navigate to the Ecwid by Lightspeed VivaWallet app dashboard and paste the Source Code into respective field.
7. Check all data within the Ecwid by Lightspeed VivaWallet app dashboard
8. Click on the blue "Save" button within the Ecwid by Lightspeed VivaWallet app dashboard
9. You are all set

Need more help? Check the official tutorial.

Create a Webhook connection: Recommended

Sometimes a Viva Wallet callback may have network issues and because of that the order is not created successfully but ends in the Abandon Carts instead. To avoid that, you can connect your Viva Wallet account to a webhook endpoint on our side to make sure that orders are always processed successfully.

Before creating a webhook, make sure that you have saved correct "Merchant ID" and "API Key" into Viva Wallet app inside your store.

1. Navigate to "Settings" -> "API Access" -> "Webhooks"
2. Click on "Create Webhook"
3. Fill in the URL as "https://infiniteapps.net/app/viva/viva-webhooks/[STOREID]", replace "[STOREID]" with your actual store ID.
4. Tick "Active" checkbox
5. Select "Transaction Payment Created" for "Event Type"
6. Click "Save"
7. You are all set

VivaWallet Powerful Features

0% Acceptance Fees Earn back your acceptance fees by using your Viva Wallet Debit Mastercard for your corporate expenses.

Free Business Account Receive a local IBAN, Business Debit Cards, and real-time reporting with unlimited transaction history.

Daily Pay-outs Your online sales are cleared daily into your Business Account. Access your funds and be able to make payments, or transfer funds to any bank account.

Payment Methods Accept multiple payment methods such as credit and debit cards, Apple Pay, Google Pay, Samsung Pay, PayPal, Alipay, JCB, WeChat Pay, local payment methods, etc.

Recurring/Subscriptions Save cards safely for later use with card tokenisation. You can easily set-up recurring transactions through our API or plugins.

Local Languages Our checkout pages support local languages such as: English, German, French, Italian, Spanish, Polish, Romanian, Dutch, Greek, Portuguese, Bulgarian, Danish, Finnish, etc.

Powerful Reporting Use our powerful reporting dashboards to showcase your company's data, helping you make better business decisions.

Read more