> For the complete documentation index, see [llms.txt](https://docs.sensepass.com/sensepay/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sensepass.com/sensepay/payment-methods/card-processors/viva.md).

# Viva

Viva processes card and Google Pay payments for SensePass locations in Europe and the UK, online and on in-store terminals.

To connect Viva, you set up a webhook and a website/app in the Viva merchant portal.

**Card processor - UK - Denmark - Portugal - Finland - Netherlands - In-store terminals**

### Capabilities

| Country  | Method     | Payment | Authorize | Tokenize | Tokenize + Capture | Full refund | Partial refund | Credit | 3DS | Split payment | L2/L3 data |
| -------- | ---------- | ------- | --------- | -------- | ------------------ | ----------- | -------------- | ------ | --- | ------------- | ---------- |
| UK       | Card       | Yes     | Yes       | Yes      | -                  | Yes         | Yes            | No     | -   | -             | -          |
| UK       | Apple Pay  | No      | No        | No       | -                  | -           | -              | -      | -   | -             | -          |
| UK       | Google Pay | Yes     | No        | No       | -                  | Yes         | Yes            | -      | -   | -             | -          |
| Denmark  | Card       | Yes     | Yes       | No       | -                  | Yes         | Yes            | -      | -   | -             | -          |
| Denmark  | Apple Pay  | No      | No        | No       | -                  | -           | -              | -      | -   | -             | -          |
| Denmark  | Google Pay | No      | No        | No       | -                  | -           | -              | -      | -   | -             | -          |
| Portugal | Card       | Yes     | Yes       | Yes      | -                  | Yes         | Yes            | -      | -   | -             | -          |
| Portugal | Apple Pay  | No      | No        | No       | -                  | -           | -              | -      | -   | -             | -          |
| Portugal | Google Pay | No      | No        | No       | -                  | -           | -              | -      | -   | -             | -          |

Yes = supported. No = not supported. - = not available or not confirmed yet - contact SensePass to check. Notes such as "terminals only" are shown under the table.

#### Currency and amounts

| Country | Currency | Minimum amount | Decimal amounts | Payment page language |
| ------- | -------- | -------------- | --------------- | --------------------- |
| UK      | GBP      | 1              | Yes             | English               |

### Credentials

| Field in SensePass | Where to find it in Viva                                 |
| ------------------ | -------------------------------------------------------- |
| Merchant ID        | Viva merchant portal > **General** tab > **Merchant ID** |

The **Add Payment Details** window in SensePass Partners shows any other fields Viva needs. Required fields are marked with \*.

### Set up the webhook in Viva

1. Sign in to the Viva merchant portal with your merchant account.
2. Go to **Settings** > **API Access**, open the **Webhook** tab and click **Create Webhook**.
3. In **URL**, enter the SensePass webhook URL with your Viva merchant ID (from the **General** tab) at the end:

{% tabs %}
{% tab title="Sandbox" %}

```
https://api.sandbox.sensepass.com/api/transactions/viva/webhook/merchant/<VIVA_MERCHANT_ID>
```

{% endtab %}

{% tab title="Production" %}

```
https://api.sensepass.com/api/transactions/viva/webhook/merchant/<VIVA_MERCHANT_ID>
```

{% endtab %}
{% endtabs %}

4. Click **Verify** and select **Active**.
5. In **Event type**, select **Transaction Pos Ecr Session Completed**.
6. Click **Save**.

<figure><img src="https://3556089516-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbqMA3Kf8t2xEX9F6y9%2Fuploads%2Fht5vu2U3zZCosHHnvy32%2Fimage.png?alt=media&#x26;token=370dbf32-bb8b-4f2b-9ed0-35bedd66976d" alt=""><figcaption><p>Viva - Webhook tab under Settings > API Access</p></figcaption></figure>

<figure><img src="https://3556089516-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbqMA3Kf8t2xEX9F6y9%2Fuploads%2FFbxcesddUYQg4zSLbTUt%2Fimage.png?alt=media&#x26;token=32b56093-5a0e-4de3-a576-67a2ca22d814" alt=""><figcaption><p>Viva - Create Webhook window</p></figcaption></figure>

{% hint style="warning" %}
**Important:** Use the same merchant ID that is set in SensePass Partners > Payment Methods > Viva.
{% endhint %}

### Add SensePass as a website/app in Viva

1. Go to **Sales** > **Online Payments** > **Websites/Apps** and click **Add Website/App**.
2. Enter: **Code** sensepass, **Source name** Sensepass, **Protocol** Https, **Domain Name** api.sandbox.sensepass.com (Production: api.sensepass.com). You can upload the merchant logo.
3. Enter **Success URL** api/transactions/viva/callback/success and **Failure URL** api/transactions/viva/callback/failure.
4. Under **Advanced configuration**, enter **Order Code** ocode, **Transaction ID** tid and **Language** lang.
5. Select all the confirmation options (public domain name, privacy policy, terms and conditions, customer service details, viva.com logo).
6. Click **Save**.

<figure><img src="https://3556089516-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbqMA3Kf8t2xEX9F6y9%2Fuploads%2FC047HtkuBxsyXTv4f73v%2Fimage.png?alt=media&#x26;token=cf17ddee-20c9-4373-a2b5-ef06dfd7ce12" alt=""><figcaption><p>Viva - Websites/Apps under Sales > Online Payments</p></figcaption></figure>

<figure><img src="https://3556089516-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbqMA3Kf8t2xEX9F6y9%2Fuploads%2FwYyt90ru4QjzcYCoueU3%2Fimage.png?alt=media&#x26;token=f72b3be3-0155-4278-ab80-96da2828e32e" alt=""><figcaption><p>Viva - Add Website/App window</p></figcaption></figure>

### Enter the credentials in SensePass Partners

Payment methods are set per location.

1. In SensePass Partners, open the location's three-dot menu and select **Payment Methods**.
2. Click **+** at the end of the **Viva** row. The **Add Payment Details** window opens.
3. Paste the credentials into the matching fields. Required fields are marked with \*.
4. Click **Save**.

{% hint style="info" %}
**No access to SensePass Partners?** Your SensePass partner sets up payment methods for you. Ask them to add Viva to your location.
{% endhint %}

{% hint style="danger" %}
**Important:** Keep your credentials confidential. Do not send them by email or chat. Enter them only in the dashboard.
{% endhint %}

### Good to know

* Viva terminals can be paired with a SensePass register (EMV terminal type VIVA).

### Who to contact

| For                                                           | Contact                                                   |
| ------------------------------------------------------------- | --------------------------------------------------------- |
| Your Viva account, credentials, settlement and fees           | Viva support                                              |
| Setting up Viva in SensePass, payments that fail in SensePass | <support@sensepass.com> or your SensePass account manager |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.sensepass.com/sensepay/payment-methods/card-processors/viva.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
