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.

備註

Viva Wallet lets you turn your phone into a mobile card reader: Tap On Phone.

配置

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

Locate your Viva Wallet credentials

在销售点配置 Viva 钱包时，您需要使用 Viva 钱包账户中的特定凭证。这些凭证包括您的 商户 ID、API 密钥、POS API 凭证，以及 终端 ID 号码。

商户 ID 和 API 密钥

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.

merchant ID and API key fields

備註

These credentials are used for APIs that authenticate with Basic Auth.

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.

警告

These credentials are only displayed once. Ensure you keep a copy to secure them.

Client secret and client ID fields

備註

These credentials are used for Android and iOS POS Activation requests, as well as the Cloud Terminal API.

終端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.

Viva 终端 ID

配置付款方式

  1. 激活 POS Viva Wallet 模块 以启用支付终端。

  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:

  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.

payment method creation form

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.

也參考

Setting up webhooks