> ## Documentation Index
> Fetch the complete documentation index at: https://partner-integrations.voyado.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Benefits flow

The Vipps Benefits (Fordeler) app allows customers to:

* Become a member of a loyalty club directly in the app
* See available promotions and vouchers for all their loyalty clubs
* Create their account directly in the app

## Adding a new loyalty club

Here's how a customer adds a new loyalty club in the app:

<Frame caption="Adding a new loyalty club">
  <img src="https://mintcdn.com/voyado-partners/rthJ1B11b2vqqU5w/images/vipps/vipps-10.png?fit=max&auto=format&n=rthJ1B11b2vqqU5w&q=85&s=63833bb961752d22ffb241539d831857" alt="Adding a new loyalty club" width="502" height="904" data-path="images/vipps/vipps-10.png" />
</Frame>

This is how the customer's existing loyalty clubs are presented:

<Frame caption="Presentation of loyalty clubs">
  <img src="https://mintcdn.com/voyado-partners/rthJ1B11b2vqqU5w/images/vipps/vipps-11.png?fit=max&auto=format&n=rthJ1B11b2vqqU5w&q=85&s=88e8f44f80a6f1f32010c275ee229e7d" alt="Presentation of loyalty clubs" width="1179" height="2556" data-path="images/vipps/vipps-11.png" />
</Frame>

## If contact already exists

If the contact already exists in Engage, loyalty data is fetched from Engage to the Vipps app like this:

<Frame caption="Fetching loyalty data flow">
  <img src="https://mintcdn.com/voyado-partners/rthJ1B11b2vqqU5w/images/vipps/vipps-12.png?fit=max&auto=format&n=rthJ1B11b2vqqU5w&q=85&s=808beb38af37c39e6d00bfa155f153a2" alt="Fetching loyalty data flow" width="1546" height="1246" data-path="images/vipps/vipps-12.png" />
</Frame>

The full contact data is then fetched from Engage with:

```http Fetch contact data theme={null}
GET api/v2/contacts/{contactId}
```

The contact's promotions are fetched using:

```http Fetch promotions theme={null}
GET /api/v2/contacts/{contactId}/promotions
```

And the available vouchers (bonus checks) are fetched with:

```http Fetch vouchers theme={null}
GET /api/v2/contacts/{contactId}/bonuschecks/available
```

## Creating a contact

If the customer in the Vipps app does not exist in Engage, they will be created there.

The creation flow looks like this:

<Frame caption="Contact creation flow">
  <img src="https://mintcdn.com/voyado-partners/rthJ1B11b2vqqU5w/images/vipps/vipps-13.png?fit=max&auto=format&n=rthJ1B11b2vqqU5w&q=85&s=d01b3b17e27cf9306c25bc99d2f735d1" alt="Contact creation flow" width="1374" height="1380" data-path="images/vipps/vipps-13.png" />
</Frame>

*CIBA = Client Initiated Backchannel Authentication*

## Onboarding automation flow

The automation in Engage (triggered by a middle layer using an iPaas) is built up like this:

1. Create an automation with the trigger "Vipps CIBA from Vipps Benefits".

2. Press the "+" button to add an Activity called "Vipps CIBA".

This automation will now be triggered by the middle layer when a customer is created from Vipps Benefits.

<Frame caption="The automation trigger">
  <img src="https://mintcdn.com/voyado-partners/rthJ1B11b2vqqU5w/images/vipps/vipps-14.png?fit=max&auto=format&n=rthJ1B11b2vqqU5w&q=85&s=d33c69d6060a7e1ab70d29ac2be838aa" alt="The automation trigger" width="882" height="718" data-path="images/vipps/vipps-14.png" />
</Frame>
