> ## Documentation Index
> Fetch the complete documentation index at: https://vexioncards.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Storyous: overview

> Connect VEXiON cards to your Storyous POS so loyalty cards are handled automatically at the till.

Connecting VEXiON cards to the **Storyous** POS means loyalty cards are processed **automatically at the till**. When a customer scans their card, stamps or points are added, discounts apply, and gift-card balance is deducted, with no manual counting.

> [!NOTE]
>
> This is the overview. The other Storyous guides cover [connecting and setup](https://vexioncards.mintlify.site/knowledge-base/storyous-setup.md), [menu and products](https://vexioncards.mintlify.site/knowledge-base/storyous-menu.md), [card types and point setup](https://vexioncards.mintlify.site/knowledge-base/storyous-card-types.md), and [working at the till](https://vexioncards.mintlify.site/knowledge-base/storyous-pos.md).

## What the Storyous integration is

It links your VEXiON loyalty program to your Storyous POS. The key difference from other POS integrations: with Storyous you **set your loyalty points inside VEXiON**, on a product list that is synced from Storyous. You do not edit anything in the Storyous admin.

* **Simple connection**: click **Aktivovat** in the Storyous Marketplace, no passwords or keys to manage.
* **Menu sync**: your products (names, prices, categories) are pulled from Storyous into VEXiON.
* **Points set in VEXiON**: you decide which products earn or redeem points, in VEXiON's product table.
* **Multiple locations**: connect several Storyous places under one loyalty program.
* **Cashier control**: at the till, staff can turn each benefit on or off per sale.

## How it works

The customer's card is scanned at the **end** of the sale, in the Storyous "Pay all" dialog. Storyous sends the basket to VEXiON, VEXiON works out what the customer earns or can use, and the cashier confirms which benefits to apply.

```mermaid theme={null}
%%{init: {'theme':'base','themeVariables':{'primaryColor':'#E5F6FF','primaryBorderColor':'#36C6FA','primaryTextColor':'#1F1E1F','lineColor':'#36C6FA','actorBkg':'#E5F6FF','actorBorder':'#36C6FA','fontFamily':'Manrope, sans-serif'}}}%%
sequenceDiagram
    participant C as Customer
    participant S as Storyous POS
    participant V as VEXiON
    Note over V: Set up once: loyalty points<br/>are set on products in VEXiON
    S->>S: 1. Cashier opens "Pay all" and scans the card
    S->>V: 2. Storyous sends the customer + basket
    V->>V: 3. VEXiON evaluates your rules<br/>(points, rewards, discount, gift)
    V-->>S: 4. VEXiON returns the available benefits
    S->>S: 5. Cashier toggles which benefits to use
    C->>S: 6. Customer pays
    S->>V: 7. Storyous confirms the transaction
    V->>V: 8. VEXiON updates the card
    V-->>C: 9. Customer sees the new balance in the wallet
```

### Step by step

1. **The card is scanned at "Pay all".** Storyous shows a **Customer benefits** dialog.
2. **Storyous sends VEXiON the customer and the basket.** VEXiON works out how many stamps or points are earned, whether a reward is available, the discount tier, and any gift-card balance.
3. **The cashier chooses.** Each benefit has a toggle, so staff can apply or skip it.
4. **The customer pays** and the transaction closes.
5. **VEXiON updates the card** in the wallet, and the customer gets a notification.

> [!NOTE]
>
> **Collect or redeem, not both.** In a single transaction a customer either **earns** stamps/points or **redeems** a reward, never both. If staff turn a reward off, VEXiON automatically switches to collecting. If they turn collecting off too, the transaction is **not counted** toward the loyalty program (nothing is earned or lost).

## Supported card types

| Card type | Supported | How it works |
| - | :-: | - |
| Stamp card | ✅ | Collect stamps, redeem for a free or discounted product |
| Reward card, Credit Cashback | ✅ | Points convert to a euro credit |
| Reward card, Product Rewards | ✅ | Points earned and redeemed on specific products |
| Discount card | ✅ | Automatic percentage discount by tier |
| Gift card | ✅ | Prepaid credit for purchases |
| Coupon card | ❌ | Not read by the Storyous till |
| Membership card | ❌ | Not read by the Storyous till |

> [!NOTE]
>
> Two variants are also supported: **tiered reward cards** (loyal customers earn points faster) and **employee cards** (a staff discount for the month, with an optional monthly limit). See [Card types and point setup](https://vexioncards.mintlify.site/knowledge-base/storyous-card-types.md#tiered-earning-reward-cards).

> [!WARNING]
>
> **Coupon and Membership cards do nothing at a Storyous till.** VEXiON supports both card types elsewhere, but the Storyous integration only reads stamp, reward, discount and gift cards. If a customer holding a coupon or membership card is scanned, the sale completes normally and no benefit is offered. Nothing breaks, but nothing happens either, so do not promise those customers anything at the till.

> [!NOTE]
>
> **Usually one benefit per sale.** Most customers hold one card, so most sales use one benefit. A business runs either stamp cards or reward cards, not both at once. If a customer holds more than one card (for example a discount card and a stamp card), their benefits can appear together in the same dialog.

> [!WARNING]
>
> **Product Rewards works for a single location only.** Because each place can have a different menu and prices, the "how many points for this product" setup cannot be shared across locations. If you run **more than one** Storyous place, use **Credit Cashback** instead (a flat euro-per-point rate that works everywhere).

## Requirements

| Requirement | Detail |
| - | - |
| Storyous account | An active Storyous POS account |
| Activation | **VEXiON cards activated in the Storyous Marketplace** (one click on **Aktivovat**) |
| VEXiON account | An active VEXiON cards account |
| Loyalty card | At least one card created in VEXiON |

> [!NOTE]
>
> Storyous is a POS integration and is part of **VEXiON cards PRO**. See [Plans and pricing](https://vexioncards.mintlify.site/knowledge-base/billing-plans.md).

### How to activate VEXiON cards in Storyous

Open [VEXiON cards in the Storyous Marketplace](https://admin.storyous.com/cz/settings/market-place/detail/?integration=advancedLoyaltyVexion) and click **Aktivovat**. You can also open **Marketplace** in your Storyous admin and find **VEXiON cards**. This switches VEXiON on for your places and opens VEXiON cards in a new tab, where you finish the connection. You do not need to contact Storyous support.

> [!NOTE]
>
> **Your Merchant ID** is a 24-character code (for example `656f0345b56913007e0b7766`). You only need it for the manual fallback, see [Entering the Merchant ID manually](https://vexioncards.mintlify.site/knowledge-base/storyous-setup.md#entering-the-merchant-id-manually).

## Quick start

**1. Click Aktivovat in the Storyous Marketplace**

VEXiON cards opens in a new tab with your Storyous merchant filled in. Sign in, or create your account.

**2. Select and map your places**

Choose which Storyous places to connect, then map each one to a VEXiON location.

**3. Sync your menu**

Click **Sync Menus** to pull your products from Storyous into VEXiON.

**4. Choose your card types**

In Integration Settings, tick the card types you use. For stamps or points, tick **Enable Point Cards** and choose the type. Discount cards are on by default. Gift cards and point cards are off by default. Click **Save Settings**.

**5. Set up loyalty on your products**

In VEXiON's product table, set which products earn and redeem points.

**6. Test one scan at the till**

Scan one card at the Storyous till and check that the points or discount appear.

**7. Done**

The integration is active. See [Connecting and setup](https://vexioncards.mintlify.site/knowledge-base/storyous-setup.md) for the full walkthrough.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.