> ## 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: connecting & setup > Connect VEXiON cards to your Storyous POS, map your locations, and choose your loyalty settings. This is the full walkthrough for connecting VEXiON cards to your Storyous POS. Once these steps are done, the integration is live. > [!NOTE] > > **Before you start:** you need admin access to your Storyous account and to your VEXiON cards account. Storyous is part of VEXiON cards PRO. ## Connecting from the Storyous Marketplace (recommended) The fastest way. You do not need your Merchant ID and you do not need to contact Storyous support. **1. Activate VEXiON cards in Storyous** In your Storyous admin, open the settings (gear icon) and choose **Storyous Integrace**, then open **VEXiON cards**. Or open [VEXiON cards in the Storyous Marketplace](https://admin.storyous.com/cz/settings/market-place/detail/?integration=advancedLoyaltyVexion) directly. Sign in to Storyous first if it asks. If you have several places, choose the place in the **Podniky** menu on the left. Click the activation button and confirm with **Aktivovat**. ![The VEXiON cards page in the Storyous Marketplace with the activation button.](https://mintcdn.com/vexioncards/a2imgzhlHwb9o-Oc/images/storyous-marketplace-listing.png?fit=max\&auto=format\&n=a2imgzhlHwb9o-Oc\&q=85\&s=2880ca69ad2b4e242c39bf6ba5f4d64e) VEXiON cards in the Storyous Marketplace ![The Storyous dialog: after the activation you are sent to VEXiON to choose your place. The Aktivovat button.](https://mintcdn.com/vexioncards/a2imgzhlHwb9o-Oc/images/storyous-marketplace-confirm.png?fit=max\&auto=format\&n=a2imgzhlHwb9o-Oc\&q=85\&s=07f9c309ac085b7a80d5ef5dc573d580) Storyous asks you to confirm **2. Continue in VEXiON cards** Storyous shows **Integrace je aktivována** and opens VEXiON cards in a new tab after a few seconds. You can also click **Přejít do VEXiON**. Already signed in to VEXiON cards? The Storyous panel opens straight away. Not signed in? You see **Sign in to finish connecting Storyous.** Sign in and VEXiON cards brings you back to the Storyous panel. No account yet? Create one: you choose VEXiON PRO, monthly or annual, and pay by card. If you manage several VEXiON accounts, check that the account at the top left is the one this Storyous merchant belongs to. ![The Storyous message Integrace je aktivována with the Přejít do VEXiON button.](https://mintcdn.com/vexioncards/a2imgzhlHwb9o-Oc/images/storyous-marketplace-activated.png?fit=max\&auto=format\&n=a2imgzhlHwb9o-Oc\&q=85\&s=a1f07f9ae6d58a2c80a82c42cc60044f) Storyous sends you to VEXiON cards **3. Choose and map your places** The **Select locations** dialog opens with your Storyous merchant already filled in. Switch on your places and map them, as described in [Selecting your places](#selecting-your-places) and [Mapping your locations](#mapping-your-locations). **4. Finish the setup** A box shows the next steps: choose your card type, sync your menu and test one card scan at the till. **Back to Storyous** returns you to the Storyous tab. > [!NOTE] > > **Started in VEXiON instead?** In Settings → Integrations → Storyous, click **Activate in Storyous**. The Storyous Marketplace opens in a new tab. Click **Aktivovat** there and continue in the tab that opens. > [!NOTE] > > **No VEXiON account yet?** The **Activate VEXiON cards** button in the Storyous listing opens the [VEXiON sign-up](https://www.vexioncards.one/start?pos=storyous). You choose VEXiON PRO, monthly or annual. After payment the Storyous panel opens with the last step: click **Aktivovat** on VEXiON cards in the Storyous Marketplace. > [!NOTE] > > **On a phone?** You connect Storyous on a computer. If you click **Aktivovat** on a phone, VEXiON cards shows **Finish the Storyous connection on a computer**. Open the [Storyous Marketplace](https://admin.storyous.com/cz/settings/market-place/detail/?integration=advancedLoyaltyVexion) on a computer and click **Aktivovat** again. ![The Storyous panel with the Activate in Storyous button and the Enter Merchant ID manually button.](https://mintcdn.com/vexioncards/a2imgzhlHwb9o-Oc/images/storyous-marketplace-buttons.png?fit=max\&auto=format\&n=a2imgzhlHwb9o-Oc\&q=85\&s=e79f21b66d56716b7354a098854a89a6) The Storyous panel before the first connection ### If the connection does not go through The Storyous panel shows one message with the next step: | Message | What to do | | - | - | | **Not activated in Storyous yet** | Click **Aktivovat** in the Storyous Marketplace, then **Try again**. | | **Merchant connected to another account** | This Storyous merchant already belongs to another VEXiON account. Write to [info@vexioncards.one](mailto:info@vexioncards.one). | | **The Storyous link is incomplete** | Open VEXiON cards in the Storyous Marketplace and click **Aktivovat** again, or enter the Merchant ID manually. | | **Storyous is not responding** | Nothing was saved. Try again in a moment. | | **Only an admin can finish the connection** | Ask the admin of your VEXiON account to open the Storyous link. | ![The Not activated in Storyous yet message with the Try again and Activate in Storyous buttons, above the empty list of connected merchants.](https://mintcdn.com/vexioncards/a2imgzhlHwb9o-Oc/images/storyous-not-activated.png?fit=max\&auto=format\&n=a2imgzhlHwb9o-Oc\&q=85\&s=e781c71a65a7197af06d06cc2c433c93) The message when VEXiON cards is not activated in Storyous yet ## Where to find the settings 1. Sign in to the VEXiON admin. 2. Open **Settings** in the sidebar. 3. Select **Integrations**. 4. Expand **Storyous**. ## Entering the Merchant ID manually Use this when the Storyous link is not available to you. VEXiON cards must already be activated for your merchant in the Storyous Marketplace. **1. Open the Merchant ID dialog** In the Storyous panel, click **Enter Merchant ID manually**. **2. Enter your Merchant ID** Paste your 24-character Merchant ID (for example `656f0345b56913007e0b7766`) and click **Add merchant**. **3. The merchant is verified** VEXiON checks the ID against Storyous. On success it appears in **Connected merchants** with its name, and the **Select locations** dialog opens. > [!NOTE] > > **Most businesses have one Merchant ID with several places.** You do not add a separate ID per location: you add one merchant and then select its places. If you run several **separate** Storyous accounts (for example different companies), you can add more than one merchant to the same VEXiON account and they share one loyalty program. One Storyous merchant can belong to only **one** VEXiON account. > [!WARNING] > > If you see **"This merchant has not activated VEXiON cards in Storyous yet"**, click **Aktivovat** in the Storyous Marketplace first. A mistyped ID shows the same message, so check the ID too. **"This merchant is already connected"** means the ID is already added. **"This Storyous merchant is already connected to another VEXiON account"** means another account holds it: write to [info@vexioncards.one](mailto:info@vexioncards.one). ![The Add Storyous merchant dialog with the Merchant ID field filled in, above the Add merchant button.](https://mintcdn.com/vexioncards/a2imgzhlHwb9o-Oc/images/storyous-add-merchant.png?fit=max\&auto=format\&n=a2imgzhlHwb9o-Oc\&q=85\&s=109ba2a4b1b916ad258a036592fbf358) Entering a Storyous Merchant ID manually ## Selecting your places After the merchant is added, a **Select locations** dialog lists all the places (prevádzky) on that Storyous account. Toggle on the ones you want to connect for loyalty, then click **Continue**. > [!NOTE] > > **Greyed-out places** cannot be selected. The line under the place says why: it is connected to **another** VEXiON account, or VEXiON is not switched on for this place in Storyous (switch it on in the Storyous Marketplace, then reopen **Manage places**). > [!NOTE] > > **A different company ID (IČO) or currency is shown as a note, never as an error.** One VEXiON account can hold several companies. When the Storyous merchant uses a different currency than your VEXiON account, the till still charges in the Storyous currency. > [!NOTE] > > **Only active places are listed.** A place that is disabled in Storyous does not appear here at all. Re-enable it in Storyous first, then reopen **Manage places**. ![The Select locations dialog listing every place on the Storyous account, each with a toggle, and one place switched on.](https://mintcdn.com/vexioncards/5-v6TFdxrGzbH76d/images/storyous-select-places.png?fit=max\&auto=format\&n=5-v6TFdxrGzbH76d\&q=85\&s=ca1cdfc1d8633cdf5daedd3ace9a350c) Choosing which Storyous places to connect ## Mapping your locations For each place you selected, a **Map locations** dialog links it to a VEXiON location. For each place you choose: * **Link to existing**, then pick the VEXiON location it belongs to, or * **Create new**, to make a fresh VEXiON location for it. Click **Confirm mapping**. > [!WARNING] > > **Map every place you use.** The till finds your business by the Merchant ID, so deselecting a place does not stop the till answering and does not delete anything. A mapped place makes its sales count under the right VEXiON location in reports. > [!NOTE] > > **Each mapped location is a billing unit** on the graduated [per-location pricing](https://vexioncards.mintlify.site/knowledge-base/billing-locations.md). **Linking to an existing** location does not add cost. When you choose **Create new**, a VEXiON PRO account sees either "Adding 1 new location will update your subscription (+X/mo)" or "Using N of M available paid slots. No additional cost." Other accounts see only "Each mapped location counts as a billing unit." You can deselect places in that dialog before you press **Confirm mapping**. Your bill follows your VEXiON locations. Deselecting a place later, or disconnecting the merchant, does not remove the VEXiON location and does not lower the bill. To stop paying for a location, remove the location itself in Settings → Locations. > [!NOTE] > > The **Link to existing** dropdown lists only VEXiON locations that are **not already mapped** to another POS branch. If the location you expect is missing, it is already mapped somewhere else. ![The Map locations dialog showing the Storyous place, a Link to existing dropdown and the chosen VEXiON location, above the Confirm mapping button.](https://mintcdn.com/vexioncards/5-v6TFdxrGzbH76d/images/storyous-map-location.png?fit=max\&auto=format\&n=5-v6TFdxrGzbH76d\&q=85\&s=d6355f24d22a1ea86a8e8333b748198f) Mapping a Storyous place to a VEXiON location ## What you see after connecting Once connected, the Storyous panel shows **Connected merchants**. Each merchant card shows its **name**, **Merchant ID**, and how many **places** are connected, with: * **Manage places**: re-open the place selection and mapping for that merchant. * **Disconnect**: remove that merchant (see [Disconnecting](#disconnecting)). Below the list of merchants, **Activate in Storyous** and **Enter Merchant ID manually** let you connect another merchant, for example a second company. ![The Connected merchants panel showing one merchant with its Merchant ID and place count, with Manage places and Disconnect, and the panel marked Configured.](https://mintcdn.com/vexioncards/5-v6TFdxrGzbH76d/images/storyous-connected-merchant.png?fit=max\&auto=format\&n=5-v6TFdxrGzbH76d\&q=85\&s=d5a230cd09ea255eaaa79f4f8cb44bb2) A connected Storyous merchant ## Integration settings Below the merchants, **Integration Settings** turn features on or off. A note reminds you these **settings apply to all connected merchants**. | Setting | Default | What it does | | - | :-: | - | | Enable Discount Cards | ✅ On | Automatic percentage discounts by tier | | Enable Gift Cards | ❌ Off | Prepaid credit for purchases | | Enable Point Cards | ❌ Off | Collecting stamps or points | When **Enable Point Cards** is on, you choose the **Point card type**: * **Stamp cards**: whole-number stamps (a "10th coffee free" style program). * **Reward Cards**: points, with a **Redemption Mode**: * **Credit Cashback**: set the **Value of 1 Loyalty Point** (for example `0.01`, so 1 point = 0.01€). Points convert to a euro credit. The customer sees the credit in euros on the card. The till shows euros first and the points in brackets, because the cashier types points. * **Product Rewards**: points are earned and redeemed on specific products, configured in the product table. **Single location only.** Click **Save Settings** to apply. > [!WARNING] > > You can enable Discount, Gift, and Point cards together, but within Point cards you use **either** stamps **or** reward points, never both. Customers collect only one type. ### Gift card settings Ticking **Enable Gift Cards** opens a **Gift Card Settings** panel underneath it: | Setting | Default | What it does | | - | - | - | | Prepaid Value Range | 10 to 1,000 | The minimum and maximum amount for gift-card purchases and top-ups | | Enable Bonus Credits | Off | Adds a percentage bonus on top of what the buyer pays | | Bonus Percentage | 0 | The bonus, when the above is on (for example 10% on a 100 purchase gives 110 of credit) | > [!NOTE] > > The amounts are shown in **your VEXiON account's currency**. If your Storyous merchant bills in a different currency, see the note below on currency display. ![The Gift Card Settings panel showing the prepaid value range from 10 to 1000 and the Enable Bonus Credits checkbox.](https://mintcdn.com/vexioncards/5-v6TFdxrGzbH76d/images/storyous-gift-settings.png?fit=max\&auto=format\&n=5-v6TFdxrGzbH76d\&q=85\&s=1a3e46e76516cf88827f80dc61773cb3) The gift card settings, revealed by enabling gift cards ### Switching between stamps and reward points If you switch **Point card type** from **Reward Cards** to **Stamp cards** and save, VEXiON asks you to confirm, because stamps are whole numbers: > **Switching to Stamp Cards.** You are switching from reward cards to stamp cards. All decimal point values will be rounded to whole numbers (e.g., 2.5 → 3, 10.75 → 11). This change affects all products in your menu. Click **Confirm and Save** to go ahead, or **Cancel** to keep reward points. > [!WARNING] > > **Your earn and redeem values are not changed when you switch.** They stay exactly as they were. If you are moving from reward points to stamps, set the whole numbers you want yourself, in the product table or by import. At the till, the stamps earned on a sale are rounded down to a whole number. ![The Switching to Stamp Cards confirmation explaining that decimal point values will be rounded to whole numbers, with Cancel and Confirm and Save buttons.](https://mintcdn.com/vexioncards/5-v6TFdxrGzbH76d/images/storyous-stamp-switch-warning.png?fit=max\&auto=format\&n=5-v6TFdxrGzbH76d\&q=85\&s=588d74747adb054b692c0c53576509dc) The confirmation shown when switching to stamp cards > [!WARNING] > > **Currency in the settings is your account's, not the merchant's.** The **Value of 1 Loyalty Point** and the **gift-card range** are labelled with **your VEXiON account's currency**. If your Storyous merchant bills in a different one, those two labels will not match your till. The **product table** is different: it shows each place's own currency, taken from Storyous. It loads that a moment after the table appears, so prices can flash your account's currency first, and if the lookup fails they stay on it. If a price is labelled in a currency the place does not use, reload the page. The POS always charges in the merchant's currency, so what the customer pays is unaffected. ![Integration Settings with Enable Discount Cards, Enable Gift Cards and Enable Point Cards all ticked, the inline Gift Card Settings showing a prepaid value range of 10 to 1,000 CHF and an unticked Enable Bonus Credits, and Point card type set to Stamp cards, above the Save Settings button.](https://mintcdn.com/vexioncards/5-v6TFdxrGzbH76d/images/storyous-settings.png?fit=max\&auto=format\&n=5-v6TFdxrGzbH76d\&q=85\&s=575e439fa954b99bc7d9f8fd76574e37) The Storyous integration settings ## Syncing your menu The last step is to pull your products from Storyous so you can set loyalty on them. For each connected place, click **Sync Menus**. Full instructions are in [Menu and products](https://vexioncards.mintlify.site/knowledge-base/storyous-menu.md). ## Disconnecting To remove a merchant, click **Disconnect** on its card. VEXiON asks you to confirm with **"Disconnect this merchant?"** and spells out what happens: > Removing *(merchant name)* will unlink all its places from VEXiON locations and delete its synced products. This cannot be undone. Confirming unlinks its places from your VEXiON locations **and deletes that merchant's synced product rows**, including the loyalty settings you set on them. Customers and their card balances are **not** deleted. > [!WARNING] > > Reconnecting the same merchant afterwards brings the products back from Storyous, but they come back with loyalty at the defaults, so **your earn, redeem, and discount values are lost**. Export the product list to Excel before disconnecting if you may reconnect later. > [!NOTE] > > Disconnecting is **per merchant**. If you run several merchants, removing one does not affect the others. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.