Viva Wallet¶

Connecting a Viva Wallet payment terminal allows you to offer a fluid payment flow to your customers and ease the work of your cashiers.

Konfiguration¶

Start by creating your Viva Wallet account on Viva Wallet’s website.

Locate your Viva Wallet credentials¶

When configuring Viva Wallet in Point of Sale, you need to use specific credentials that are available in your Viva Wallet account. These credentials include your Merchant ID, API key, POS API credentials, and Terminal ID number.

Merchant ID and API key¶

Locate your Merchant ID and API key following the Viva documentation. Then, save the keys and paste them into the Odoo Merchant ID and API Key fields when creating the payment method.

POS API credentials¶

Locate and generate your POS API credentials following the Viva documentation. Then, save the keys and paste them in the Odoo Client secret and Client ID fields when creating the payment method.

Terminal ID¶

Your terminal ID number is used to identify your terminal. To find it:

1. Go to your Viva Wallet account and select the relevant account.

2. Go to Sales ‣ Physical payments ‣ Card terminals in the navigation menu.

The terminal ID number is located under the Terminal ID (TID) column. Save it to paste it into the Terminal ID field when creating the payment method.

Die Zahlungsmethode konfigurieren¶

1. Activate the POS Viva Wallet module to enable the payment terminal.

2. Create the related payment method by going to Point of Sale ‣ Configuration ‣ Payment Methods and clicking New.

3. Set the journal type as Bank.

4. Select Viva Wallet in the Use a Payment Terminal field.

5. Fill in the mandatory fields with your:

   • Merchant ID and API key

   • Client ID and Client secret

   • Terminal ID

6. Save the form and copy the generated webhook URL from the Viva Wallet Webhook Endpoint field. This URL is necessary when configuring the webhook.

Configure the webhook¶

Webhooks allow you to receive real-time notifications whenever a transaction occurs within your Viva Wallet account. Set them up for payment transactions following the Viva documentation.

Die Zahlungsmethode mit einem Kassensystem verbinden¶

You can select the payment method in your POS settings once the payment method is created. To do so, go to the POS‘ settings and add the payment method under the Payment methods field of the Payment section.

Mit einem Zahlungsterminal bezahlen¶

Wenn Sie eine Zahlung bearbeiten, wählen Sie die entsprechende Zahlungsmethode aus. Überprüfen Sie den Betrag und klicken Sie auf Senden. Sobald die Zahlung erfolgreich war, ändert sich der Status in Zahlung erfolgreich.