> ## 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.

# Adding a Customer

> Issue a card to someone yourself and send it to them, from the dashboard or the scanner.

Most customers add themselves by scanning your card's [QR code or link](https://vexioncards.mintlify.site/knowledge-base/sharing-a-card.md). But you can also enrol someone yourself and send them the card directly.

There are **two places** to do this:

* **The [Customers page](https://vexioncards.mintlify.site/knowledge-base/customers-page.md)** (on the dashboard): the full version, where you can issue any card type and set opening values.
* **The Scanner** (the till screen): a quick version for staff serving customers at the counter.

## Who can add customers

Your team can have three roles, and the role decides **where** a person can add customers. The **flow itself is decided by the screen, not the role**: the Customers page always gives the full version, the Scanner always gives the quick version. An admin using the scanner gets the same quick flow that scanner staff get.

| Role | Can add customers from | Notes |
| - | - | - |
| **Admin** | Customers page **and** Scanner | Full access to everything, across all locations. |
| **Manager** | Customers page **and** Scanner | Works within their assigned location(s). Has customers, notifications, and the scanner, and can see their own billing page, but not the Cards area or the business billing. |
| **Scanner** | Scanner only | Confined to the scanner screen at their assigned location, so the quick flow is their only way to add someone. |

## From the Customers page (full version)

On the [Customers page](https://vexioncards.mintlify.site/knowledge-base/customers-page.md), click **Create Customer** (top right). It walks through four steps and lets you issue **any** card type, including gift cards, and set opening values.

**1. Select Card**

Pick which of your cards to send. The list shows each card with its type (Stamp, Reward, Gift Card, and so on). Select one and click **Next**.

![Step 1 of adding a customer: the Select Card list to choose which card to issue.](https://mintcdn.com/vexioncards/jyoFo5IjMFdGfJql/images/create-customer-1-card.png?fit=max\&auto=format\&n=jyoFo5IjMFdGfJql\&q=85\&s=97decc06c302dac198924610eee918b3)

Step 1: Select Card

**2. Customer Details**

Start with the **Email**. If this person already has one of your cards, VEXiON cards finds them as soon as the address is complete:

* You see their name and the cards they already have.
* **First Name** and **Last Name** fill in by themselves.
* **Phone Number** and **Date of Birth** show **From profile**. The new card gets them automatically. Click **Change** to type a different value.

Not the right person? Click **Not this person** and fill in the form yourself.

![Step 2 of adding a customer: the email is entered, the customer Jana Kováčová is found with the cards she already has, and her first and last name are filled in.](https://mintcdn.com/vexioncards/voso4A4v7D7u28Sw/images/create-customer-2-known-customer.png?fit=max\&auto=format\&n=voso4A4v7D7u28Sw\&q=85\&s=4c81216e02d2001463ccb7b2e5560298)

Step 2: a customer you already know

For a new customer, enter the details yourself:

* **Email**. Tap a suggestion such as **@gmail.com** to finish the address.
* **First Name** and **Last Name**.
* **Phone Number** (with country code). A phone number is what enables sending by SMS later. Without an email, a phone number of a known customer also finds them. If several customers share the number, pick the right one or choose **New customer with this number**.
* **Date of Birth**.
* **Use custom card number**: turn this on to give the card your own reference instead of an automatic one. This value **becomes the card's number and is encoded into the QR code** on the customer's wallet pass, so it is handy for matching an existing physical card or a number from your POS: scanning either resolves to the same customer. It can be letters, numbers, hyphens, and underscores (up to 64 characters), and cannot be a 24-character hex string (that format is reserved for the system's own IDs). Leave it off and the system assigns a number automatically.

If the customer already has **this** card, the email turns red and you cannot continue. Click **Open customer profile** to see them, or **Pick another card**.

**First Name** is required. Give an email, a phone number or a custom card number. Email is required unless you use a custom card number (for customers without an email, such as a printed card) or the customer is already known. With only a card number there is nothing to send, so you hand the card over yourself. Click **Next**.

**3. Card Values**

Set the card's starting values. This step **depends on the card type**, and is skipped entirely for coupon cards (there is nothing to set):

> [accordion] Stamp card
>
> **Initial stamps**: a slider from 0 up to the card's stamp goal, to give the customer a head start.
>
> If the card has **Paid in advance** on, a **Fully prepaid** toggle also appears, to issue the card already paid up.

> [accordion] Reward card (including cashback)
>
> **Initial reward points**: the points balance to start the customer with.

> [accordion] Gift card
>
> **Gift card value**: the starting balance, in your currency.
>
> A gift card you issue here is not a sale, because no money was received. The card's [Activity](https://vexioncards.mintlify.site/knowledge-base/card-activity-customers.md#gift-cards) shows **Gift card issued by merchant**, it does not count in **Sold**, and you get no sale email.

> [accordion] Discount card
>
> **Total spend**: the amount of spend to seed the customer with. The dialog shows the card's **discount tiers** and highlights which tier the customer will start in based on the amount you enter.
>
> For an **employee card** there is no starting balance. Instead you see a read-only summary of the **monthly limit**, the **reset day**, and the **discount tiers**.

> [accordion] Membership card
>
> **Membership duration**: pick one of the plans set up on the card (each shows its price). A **Pre-activate membership** toggle lets you start the membership as active immediately.

> [accordion] Coupon card
>
> No values to set, so this step is skipped.

Click **Next**.

![Step 3 of the Create Customer dialog, Card Values: an Initial stamps slider set to 3 of 10 and a Fully Prepaid Card toggle, with Back and Next buttons.](https://mintcdn.com/vexioncards/jyoFo5IjMFdGfJql/images/create-customer-3-values.png?fit=max\&auto=format\&n=jyoFo5IjMFdGfJql\&q=85\&s=f1f63d88d14beb3b5ccf3c1d9ebb2404)

Step 3: Card Values (stamp card shown)

**4. Delivery**

Choose how to send the card:

* **Send via Email**: enabled when the customer has an email.
* **Send via SMS**: enabled only when you added a **phone number** in step 2 (otherwise it is greyed out).
* **Preferred Language** for the message.

Review the **Summary** (card, customer, and delivery method), then click **Send Card**.

## Give a customer another card

When a customer already has one of your cards, you can send them another one in a few clicks. Nothing needs to be typed again.

* **Customer profile**: open the customer and click **Give another card** next to the card button (on a phone: **Another card**).
* **Right after sending a card** from the Customers page: click **Send another card** in the confirmation message.

On the Scanner, use **New customer** and type the email: a known customer is found and filled in.

Pick the card. Cards the customer already has are greyed out with **Already has**. The customer details step is skipped: VEXiON cards uses the details you already have. Then set the card values and send.

![The card list for giving a customer another card: two cards are available, the cards the customer already has are greyed out and marked Already has.](https://mintcdn.com/vexioncards/RasLrEnfnjCO5Q4M/images/give-another-card.png?fit=max\&auto=format\&n=RasLrEnfnjCO5Q4M\&q=85\&s=b2f473d581959e604f521281b141daaf)

Give another card: cards the customer already has are greyed out

## From the Scanner (quick version)

Staff serving customers at the counter can add someone straight from the **Scanner**. Tap **New customer** (top right of the scanner screen) to open the same wizard, streamlined for the till.

![The New customer button at the top right of the Scanner screen.](https://mintcdn.com/vexioncards/jyoFo5IjMFdGfJql/images/scanner-new-customer-button.png?fit=max\&auto=format\&n=jyoFo5IjMFdGfJql\&q=85\&s=5aca5abba45b9271862e50f8aa9f6219)

The 'New customer' button on the scanner

It works the same way, with **three differences** that keep it fast and safe at the counter. These apply to anyone using the scanner, whatever their role:

> [accordion] No Card Values step (three steps, not four)
>
> The scanner skips the Card Values step entirely. Every card is issued in its **starting state** (a stamp card with no stamps, a reward card with no points, and so on). Staff cannot set opening balances or stamps, so a mistap can never hand out value. The flow is just **Select Card → Customer Details → Delivery**.

> [accordion] Gift cards and employee cards are not available
>
> You cannot issue a **gift card** or an **employee card** from the scanner. Only your loyalty cards (stamp, reward, discount, coupon, membership) appear. Gift cards are sold and loaded through their own flow instead (see [Physical Gift Cards](https://vexioncards.mintlify.site/knowledge-base/physical-gift-cards.md)).

> [accordion] Only this till's cards appear
>
> The card list is scoped to the cards **enabled at that scanner's location**, so staff only see the cards relevant to where they are working.

Everything else is identical: pick a card, enter the customer's details (including a custom card number if you want one), choose Email or SMS, and send. A known customer is found from the email here too.

After you send, the scanner opens the new customer straight away, so you can add the first stamp or points at once. If the customer already has the card, tap **Show on scanner** to open them.

> [!NOTE]
>
> In both places the customer is created and the card is sent in one go. They tap the link in the message to add the pass to Apple Wallet or Google Wallet, and they appear in your [customer list](https://vexioncards.mintlify.site/knowledge-base/customers-page.md) straight away.

## What the customer receives

The customer gets a message with a **claim link** that adds the card to their wallet. The wording matches the card type.

### By email

The email has the subject **"Your card from \[your business name]"** and a friendly **"You have a new card!"** message, with a short welcome line for that card type, a preview of the card, and a button to add it to Apple Wallet or Google Wallet. For example, a stamp card reads:

> \[Your business] welcomes you with a new stamp card! Add it to your digital wallet and scan it at every purchase. Collect stamps and earn your reward!

![The card delivery email: a dark VEXiON cards header, a Hi \[name\] greeting, a short welcome line, a coloured card preview showing the customer name and card value (for example Stamps 0 / 8), and an Add to Wallet button.](https://mintcdn.com/vexioncards/o-jAVD4ZwhtnjdDL/images/customer-card-email.png?fit=max\&auto=format\&n=o-jAVD4ZwhtnjdDL\&q=85\&s=d31e04368b2097a358235de8324ae31b)

The card email a customer receives

### By SMS

The SMS is a single short message sent from **VEXiONcards**, with the card type and the claim link. For example:

> You have a new stamp card from \[your business]. Add it to your wallet: \[link]

The message changes to match the card type (a new reward card, gift card, membership card, coupon, and so on).

The card SMS a customer receives


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