---
title: "Viva Wallet for HBook"
canonical: "https://maestrel-resource-center.refined.site/space/PGD/72057999/Viva%20Wallet%20for%20HBook"
format: markdown
---
## 1. Activate Viva Wallet  as payment gateway

Once you have activated Viva Wallet  plugin, you need to **validate the licence** in **HBook > Licence**.

![vivawallet-licence.png](media://9dea5ee3-dfec-45c6-8a05-954b708cf281)

- Set Viva Wallet as active payment gateways in **HBook > Payment > Active payment gateways.**

## 2. In HBook, add Viva Wallet credentials

- You will need to add the following information, in **HBook > Payment > Viva Wallet** **settings**.

![vivawallet-settings.png](media://072c581c-492b-4006-ae1f-fe9a48c37dfb)

## 3. In Viva Wallet dashboard, create a webhook

In **Viva Wallet dashboard**, you will need to create a webhook. Navigate to **Settings > API Access** and go to the tab **Webhooks**. You will need to indicate :

- the URL of the webhook. You will indicate it as “www.domain.com/confirmation-vivawallet”, changing “www.domain.com” to your actual WordPress site url.
- set it as “Active”
- select the event type “Transaction Payment Created”

![vivawallet-webhook.png](media://856b16ea-9300-4061-b860-bbf85e750955)

### Do I need to whitelist Viva Wallet IPs? Where can I get information ?

If you have troubles to verify your Webhook url, you should whitelist Viva Wallet IPs to make sure you receive the webhook call. You can find the list of Viva Wallet IPs [here](https://developer.vivawallet.com/webhooks-for-payments/#whitelist-the-viva-wallet-addresses).

### How to create a Sandbox Viva Wallet account ?

You can create a **Sandbox** Account from [here](https://demo.vivapayments.com/en/signup).

### How to create a Live Viva Wallet account ?

You can create your **Live** Account from [here](https://app.vivawallet.com/).

### Where to find the Source Code, Merchant ID, API Key, Client ID and Client Secret ?

- Source Code: You will need to **create a website/app** in Viva Wallet dashboard. Navigate to **Sales > Online Payments > Websites/Apps**. Click on “New app/website” and check below for the settings. You can name it for example “Viva Wallet HBook”.

![vivawallet-create-app.png](media://ee1cc573-bd15-4222-8252-3c3e75844d64)

- When you **create or edit a website/app**, you will see the following settings. Please make sure that you enter the “Success URL” and “Failure URL” as described.

![vivawallet-app-settings.png](media://7dbe5bdf-0896-44bd-9ca2-93354fda0e2f)

- **Merchant ID**, **API Key**, **Client ID** and **Client Secret** : Navigate to **Settings > API Access**.

![vivawallet-keys.png](media://9a272061-7d0a-49af-90a8-8785f0054fa4)

### Which cards to use to test Sandbox environment?

You can find the test card details [here](https://developer.vivawallet.com/integration-reference/test-cards-and-environments/).