Papaya: card types & point setup

Set up each card type for Papaya, and choose automatic or manual redemption.

This guide covers each card type and how to set its points in VEXiON. The thing that makes Papaya different is that you choose, per card type, whether a reward is applied automatically or manually.

You set loyalty on products in VEXiON (earn, redeem, discount). Papaya calls VEXiON when a card is scanned, VEXiON returns the discount, and Papaya applies it.

​

Automatic vs manual redemption

You pick this in the integration settings, separately for stamp cards and reward cards.

Mode	How a reward is applied	The cashier
Automatic	On its own, as soon as the customer has enough	Does nothing extra
Manual	Only when a special “VEXiON Odmena” product is on the bill	Adds that product when the customer wants to redeem

In manual mode, if “VEXiON Odmena” is not on the bill, the card only earns, it does not redeem.

​

How much gets redeemed

On reward cards, manual mode gives you a second choice, the Redeem setting:

Redeem	What happens	Good for
Whole balance	The customer’s whole credit is used at once, up to Max bill coverage	Simple, nothing to decide at the till
Exact amount	The cashier types how many euros to use	Customers who want to keep the rest for later

Exact amount works through the quantity of the “VEXiON Odmena” line: a quantity of 1 redeems 1€, 3 redeems 3€. Decimals work, so 2,5 redeems 2,50€ and 1,04 redeems 1,04€. If the customer does not have that much, only what they have is used, and Max bill coverage still applies on top.

The number is euros, never points. This is the one thing to drill into your staff. If a customer has 104 points on a card worth 0,01€ per point, that is 1,04€, so the cashier types 1,04, not 104. Typing 104 asks for 104€ and simply gets everything the customer has, which looks like the feature ignoring them.

Whole balance is the default and it is what every program did before this setting existed. Nothing changes for you unless you switch it.

​

The “VEXiON Odmena” product (manual mode only)

If you use manual redemption, create one product in Papaya as the trigger:

1. Open the menu in Papaya

   Go to Business Settings → Menu Items and add a new item.

2. Name it VEXiON Odmena

   Name = VEXiON Odmena (the name must contain the word “VEXiON”), Price = 0€, Tax group = 0%.

3. Tick the quantity dialog (Exact amount only)

   Still on the item, open Settings and tick “Vždy zobraziť dialóg na zadanie počtu / predaného množstva”. Tapping the product then opens a number pad straight away, so the cashier types the amount once.

   Without it they have to tap the tile once per euro, which stops being usable after a few euros. This lives in Papaya and we cannot set it or check it for you, so confirm it is ticked before you switch a till to Exact amount.

4. Save

   Save the product. Staff add it to a bill whenever a customer wants to redeem.

Add “VEXiON Odmena” before you scan, not after. Papaya only asks VEXiON for a discount at the moment a card is scanned, and it does not ask again when the bill changes. If the cashier types an amount and then takes payment without scanning again, the bill is never discounted and the customer pays full price. Nothing is deducted from their balance in that case, so the credit is still there, but the sale is lost.

Any product with “vexion” in its name triggers a redemption, whatever the capitalisation and wherever the word sits. VEXiON Odmena is the name to use, but Vexion reward or zľava vexion would work the same way. Do not put the word into the name of anything you actually sell, or those items will start redeeming rewards when they are rung up.

The trigger product is not counted as a purchase. It is removed before VEXiON looks at the bill, so it never earns stamps or points and does not appear in the “1 of 2 products” count in the message.

Choosing automatic or manual redemption

​

Stamp card

Collect stamps, redeem for a free or discounted product.

In VEXiON’s product table, set per product:

Field	Meaning	Example
Loyalty	In the program	Yes
Earn Stamps	Stamps earned per purchase	1
Redeem Stamps	Stamps needed for the reward	10
Discount	Percentage off when redeemed	100% (free)

Redemption:

• Automatic: when the customer has enough stamps, the free item is applied on its own.
• Manual: staff add “VEXiON Odmena” to the bill, then scan the card. Without it, the customer only collects stamps.

​

Reward card (cashback)

Points convert to a euro credit the customer spends on a future bill. Reward cards on Papaya are cashback.

​

Cashback on this till

Papaya counts points with the Value of 1 Loyalty Point you set. The customer still sees credit in your currency on the card and in every message. With a point value of 0.05 €, 160 points show as 8,00 € of credit (at 0.25 Kč per point, 160 points show as 40 Kč). The Papaya screen shows a line like “Credit: €8.00 (160 points)”.

Settings:

Setting	Meaning	Example
Value of 1 Loyalty Point	Euro value per point	0.01€ (100 points = 1€)
Min balance for cashback	Minimum credit before automatic cashback triggers	5€
Max bill coverage	Most of a bill that cashback can cover	100%

Points earning has two choices. Per products uses the Earn column in the product table (how many points each product earns). General (by card) ignores that column and awards points from the bill total at the card’s rate. In both cases there is nothing to redeem per product, points convert to euros.

Redemption:

• Automatic: cashback applies on its own once the balance passes the Min balance for cashback (for example 500 points = 5€). The Max bill coverage caps how much of the bill it can cover.
• Manual: staff add “VEXiON Odmena” to the bill, then scan the card. There is no minimum in manual mode, any balance can be used (up to the Max bill coverage). With Redeem set to Exact amount, the quantity they put on that line is how many euros are used, so the customer can spend part of their credit and keep the rest.

Good to know: the balance drops by exactly the cashback printed on the bill, also when the cashback covers the whole bill and the customer pays nothing. A bill that uses cashback earns no new points.

​

Tiered earning (reward cards)

A reward card can earn points faster for loyal customers using tiers. You set the product points at the base rate, and VEXiON multiplies them by the customer’s tier (for example Bronze 1x, Silver 3x, Gold 5x). This applies to earning only, never redemption. Tiers and multipliers are set on the card in VEXiON.

Set each product’s earn points at your lowest tier’s rate. VEXiON scales up automatically for higher tiers, do not enter separate values per tier.

​

Discount card

Automatic percentage discounts by the customer’s tier, applied on their own at the till.

VEXiON tracks total spend and applies the tier discount. Tiers are set on the card in VEXiON:

Example tiers:

Tier	Minimum spend	Discount
Bronze	0€	5%
Silver	500€	10%
Gold	1500€	15%

The tier discount is taken off the whole bill, including products that are not in the loyalty program. The Loyalty setting on a product only decides whether it earns stamps or points. A tier upgrade takes effect on the customer’s next visit.

​

Employee card

An employee card is a discount card set up for staff, with discount levels for the month and an optional monthly limit. With a limit, it stops when the limit is used up, until the reset day. The step is evaluated on the employee’s spend this month. On Papaya, a cancelled or refunded bill still counts toward this month’s spend, because Papaya does not tell VEXiON about it. Correct it by hand in the VEXiON admin. For the full setup, see Employee card.

​

Gift card

Prepaid credit, sold and spent at the till. The balance is held by VEXiON and read live on every scan, so one card works at all of your locations.

Setting it up takes two things:

1. One item in the Papaya web administration, named exactly VEXiON GIFTCARD, priced 1,00 at 0 % VAT, with the count dialog turned on. The name is what VEXiON recognises, so an item you already sell cannot be used.
2. Enable Gift Cards switched on in the Papaya panel of the VEXiON dashboard, where you also set the minimum and maximum amount and the bonus.

The whole flow, the till steps for cashiers and every message the till shows are in Gift cards.

​

FAQ

Where do I set the points, in VEXiON or Papaya?

In VEXiON, on the product table. Papaya only provides the product names, prices, and categories.

Automatic or manual, which should I pick?

Automatic is simplest for staff, the reward just applies. Manual puts the customer in control: nothing is redeemed unless the cashier adds “VEXiON Odmena” to the bill.

Can I use stamps and points at the same time?

No. Within Point cards you pick either Stamp cards or Reward Cards. Customers collect one type.

Does the reward come off the cheapest item?

Yes. When more than one product on the bill is eligible, the reward goes to the cheapest one (lowest unit price) that the customer has enough stamps for. One unit of that product is rewarded.