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

# Automatic messages

> Every message VEXiON cards sends to a customer on its own after a scan, a redemption, or a reversal, by card type.

Separately from the [notifications you send](https://vexioncards.mintlify.site/knowledge-base/notifications.md), VEXiON cards sends a short message on its own after most scans, so the customer always knows what just happened. You never write these, each one is **automatic**, chosen for the action and card type, and translated into the customer's language. They appear on the phone's lock screen (Apple Wallet) and update the pass at the same time.

> [!NOTE]
>
> These messages appear only if the customer has notifications enabled for Wallet on their phone. The pass itself always updates regardless. On the numeric card types the message is tied to the value on the front of the pass, so the phone highlights the number as it changes.

## What each action sends

> [accordion] Stamps
>
> | Action | The customer sees (example) |
> | - | - |
> | Stamp added | "⭐ +1 stamp • 3 more stamps to your reward • You have 7 stamps" |
> | Last stamp added | "🎁 +1 stamp • Reward is ready • You have 10 stamps" |
> | Reward claimed | "✅ Reward redeemed • You have 0 stamps" |
> | Prepaid card charged | "🎉 Card topped up: +10 stamps • Balance: 10 stamps" |
> | Stamp used (paid in advance) | "✅ 1 stamp used • Balance: 6 stamps" |

> [accordion] Points
>
> | Action | The customer sees (example) |
> | - | - |
> | Points added, no reward ready yet | "⭐ +40 points • Free coffee: 60 points to go • Total: 140 points" |
> | Points added, rewards ready | "⭐ +40 points • To choose: 2 rewards • Total: 490 points" |
> | A reward becomes ready | "🎁 +40 points • Free coffee is ready • Total: 400 points" |
> | Reward used at the scanner | "✅ Used: Free coffee for 400 points • Total: 240 points" |
> | Points used at the till | "✅ 100 points used • Total: 240 points" |
>
> The reward name is shown only when it is short. Otherwise the message says "Reward".

> [accordion] Cashback
>
> | Action | The customer sees (example) |
> | - | - |
> | Credit earned | "⭐ +€1.67 from your €33.40 purchase • Credit: €5.01" |
> | Credit earned, card with levels | "⭐ +€1.67 from your €33.40 purchase • €120 to Gold • Credit: €5.01" |
> | New level (iPhone) | "🎉 New level: 5 % on every purchase • +€1.67 • Credit: €5.01" |
> | Credit used | "✅ €3.00 credit used • Credit: €2.01" |
> | Level ends soon, 14 and 3 days before ([level retention](https://vexioncards.mintlify.site/knowledge-base/level-retention.md)) | "Shop by 15 Apr to keep Gold (5×)." |
> | Level dropped ([level retention](https://vexioncards.mintlify.site/knowledge-base/level-retention.md)) | "Your level is now Silver (3×). 500 € to get Gold back. Your points are safe." |
>
> The customer sees the balance in euros. The points stay on the back of the pass and in the customer's profile.

> [accordion] Discount
>
> | Action | The customer sees (example) |
> | - | - |
> | Purchase | "✅ Purchase €25.00 with 10% off • €180 to 15% • Total spend: €820" |
> | Purchase, highest level | "✅ Purchase €25.00 with 15% off • Total spend: €1,020" |
> | New level (iPhone) | "🎉 Purchase €25.00 • New level: 15% off • Total spend: €1,000" |
> | Level ends soon, 14 and 3 days before ([level retention](https://vexioncards.mintlify.site/knowledge-base/level-retention.md)) | "Shop by 15 Apr to keep Gold (15%)." |
> | Level dropped ([level retention](https://vexioncards.mintlify.site/knowledge-base/level-retention.md)) | "Your level is now Silver (10%). 500 € to get Gold back." |

> [accordion] Gift cards
>
> | Action | The customer sees (example) |
> | - | - |
> | Gift card topped up | "🎉 Topped up €50.00 • Balance: €50.00" |
> | Gift card used | "✅ Paid €12.00 • Balance: €38.00" |
> | Gift card activated | "Gift card activated. Balance: 50.00€" |
> | Gift card expiring | "Gift card expires 31/12. Balance: 20.00€" |
> | Gift card refunded | "Gift card refunded" |

> [accordion] Membership
>
> | Action | The customer sees (example) |
> | - | - |
> | Membership activated | "Membership activated: Monthly until 31/08 • 30 days" |
> | Entry (with a limit) | "Membership used 2/3. 28 days remaining." |
> | Entry (unlimited) | "Membership used. Valid until 31/08 • 30 days" |
> | Daily limit renewed | "Daily limit renewed. 28 days of membership remaining." |

> [accordion] Coupons
>
> | Action | The customer sees (example) |
> | - | - |
> | Coupon redeemed | "Coupon was successfully redeemed!" |
> | Coupon ready | "Coupon is active and ready to use." |

> [accordion] Referrals
>
> | Action | The customer sees (example) |
> | - | - |
> | Referral bonus, new customer | "You received 3 bonus stamps for signing up via referral!" |
> | Referral bonus, referrer | "You earned 100 points for referring Peter. New total: 350 points" |

> [accordion] When a transaction is reversed
>
> Reversing a transaction (undoing a scan or cancelling a bill) sends a message of its own, tailored to the card type and carrying the customer's **new** balance. On the numeric card types it is tied to the value on the front of the pass, so the phone highlights the number as it changes back.
>
> | Card type | The customer sees (example) |
> | - | - |
> | Stamp | "Transaction reversed. You have 5 stamps." |
> | Reward (points, incl. cashback) | "Transaction reversed. Balance: 120 points." |
> | Reward, tiered | "Transaction reversed. Balance: 120 points." (the tier badge also drops back if the reversal crosses a level) |
> | Discount | "Transaction reversed. Your level: Silver • 5%." |
> | Gift card (balance) | "Transaction reversed. Balance: 38.00€." |
> | Gift card (purchase cancelled) | "Gift card cancelled." |
> | Membership entry | "Entry reversed. Today's usage: 1/2." |
> | Membership activation | "Membership cancelled." |
> | Coupon | "Coupon redemption reversed. Your coupon is active again." |
>
> The pass background (including a tiered card's per-level image) always follows the reversed state too, so a card that dropped a tier shows that tier's colours and image again.

Not every message applies to every card. VEXiON cards picks the right one for each action and card type on its own.


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