logo
Payment GatewaysViva
Payment Gateways

Viva

Connect Viva to PayLexer to accept card payments and digital wallets across Europe.

Viva (formerly Viva Wallet) is a European cloud-based payment institution licensed across the EU. It provides card payment acceptance, point-of-sale solutions, and online payment processing for businesses operating in Europe.

  • Supported Regions (Merchant Accounts): European Union member states, UK - view full list

  • Supported Currencies: EUR, GBP, and other EU currencies - view full list

Supported Features

  • One-time payments

  • Refunds

  • Real-time payment status updates

  • Card payments (Visa, Mastercard, Maestro, American Express)

  • Digital wallet support

Before You Start

Make sure you have:

Looking for a different payment processor? View all supported gateways →

Configuring Viva

You need a Client ID, Client Secret, and Merchant ID from Viva for this integration.

Getting API Credentials

Log in to Viva

Log in to your Viva Dashboard.

Navigate to API credentials

Go to Settings → API Access (or the equivalent section for your account type).

Copy your credentials

Click** Create New Application** or select an existing app, then copy your Merchant ID, API Keyand Client ID.To get Client Secret, generate a new one and copy it

Get Source Code

To get the Source Code, go to** Sales - Online Payments - Websites/Apps** and click on Add Websites/App

Enter the Source Name and your Domain Name and fill Success URL and Failure URL with webhooks/viva and select all the checkboxes

  1. Click Create and copy the Source code

Viva provides separate credentials for Demo (test) and Production environments.

Adding Credentials to PayLexer

Open PayLexer Dashboard

Log in to your PayLexer dashboard and navigate to Payment Gateways → Viva.

Enter your credentials

Paste the credentials you copied from Viva.

Understanding Live/Production and Sandbox Settings:

EnvironmentPurpose
Live / Production (Mandatory)Used for real transactions. Cannot be empty, even when testing.
Test / Sandbox (Optional)Used for testing only. No real money is processed.

How PayLexer selects credentials:

  • Debug/Test mode ON → Test credentials are used

  • Debug/Test mode OFF → Live credentials are used

Test and save

Click Test Connection to verify your credentials, then click Save Configuration.

Configuring Webhooks

Open Viva Webhook settings

In your Viva Dashboard, navigate to Settings →API Access → Webhooks or the equivalent notification settings and click on Create Webhook.

Add the Webhook URL

Copy the Webhook URL from PayLexer and paste it into Viva's webhook endpoint field.

Add the Webhook URL

Select Activeand choose Event Typeas Transaction Payment Created,then click Verify, then Save.

Integrate Viva to Your Website

Go to Websites

Navigate to Websites in your PayLexer dashboard.

Edit your website

Click the Edit Icon of your added website.

Enable Viva

Click the checkbox to enable Viva for the website.

If you haven't added a website yet, → Continue to Add Your Website

Troubleshooting

Best Practices

  • Test in Demo mode before enabling Production mode

  • Validate the first live transaction

  • Keep Client Secret secure

  • Use separate Test and Production credentials

FAQs

Still Have Questions?

Was this page helpful?

Last updated 4 days ago

Built with Documentation.AI