Before you connect
- Confirm Perkstar and Loyverse use the same currency. Till redemption requires a currency with two decimal places.
- Sign in as a Perkstar owner or manager and use a plan that includes Loyverse.
- Make sure you can approve apps for the intended Loyverse business.
- Decide whether any existing Loyverse loyalty balance must be exported or migrated.
- Keep every POS device online while configuring and testing it.
Prepare the Points card
The card picker shows eligible cards under Ready to connect. Cards under Needs changes cannot be selected and include an Edit link explaining what to fix. A compatible card must be:- active and unarchived;
- a Points card for individual customers, not a group-enrolment card;
- configured to earn automatically by spend or visit, rather than by manual points entry;
- configured with an ongoing Points-to-Cash balance and a valid conversion;
- set to flexible spending with a positive minimum balance before spending;
- configured to display a QR code; and
- configured to require First name and Email on the sign-up form.
Stamp cards, reward-level Points cards, set-amount Points-to-Cash cards,
group-enrolment cards and manual-earning cards cannot be connected. Flexible
Points-to-Cash is required because a cashier can enter any eligible amount up
to the available balance.
Set Loyverse earning to 0%
1
Open Loyverse Back Office
Sign in to the same Loyverse business you will connect to Perkstar.
2
Open Loyalty settings
Go to Settings → Loyalty.
3
Save zero percent
Set the loyalty earning percentage to 0%, then select Save.
Connect and activate
1
Connect the correct businesses
Start the Loyverse
connection, sign in to
Perkstar and choose the business if asked. Authorise access to Loyverse
business details, customers and receipts. On return, check the Loyverse
business name and currency before continuing.
2
Choose the Points card
Select the intended card under Ready to connect, then choose Use this
card with Loyverse. Use the guided Edit link if a card is under
Needs changes.
3
Enable customer card scanning
Read and confirm the customer data-sharing notice, then choose Enable
customer card scanning. Perkstar links one existing exact-email Loyverse
profile or creates an eligible profile when none exists, and publishes the
managed Wallet QR identifier.
4
Configure every POS device
In Loyverse POS, open Settings → General and enable Use camera to scan
barcodes, unless the device uses a compatible external scanner. Tap Add
customer, scan a test Wallet card and confirm the correct customer opens.
Repeat this on every new or replacement device.
5
Enable till redemption
Confirm separately that every device can scan, Loyverse is set to 0%, and
existing balances may be replaced. Choose Enable till redemption and
wait until the page says scanning, earning and redemption are connected.
Customer information used for scanning
When scanning is enabled, Perkstar sends the customer’s name, email address, optional phone number and managed Wallet scan identifier to Loyverse. Customer reference IDs, receipts, redemptions and balance data are exchanged to run the integration. The business must tell customers about this sharing and have an appropriate lawful basis.Test before going live
Use a synthetic customer and record the expected result for the connected card’s exact earning and conversion rules.- Scan the Wallet card through Add customer, attach the customer and complete one paid sale without redemption.
- Confirm points were added once and the Wallet fields updated.
- Complete another sale and redeem a smaller amount, such as £1.25 from a larger available balance.
- Confirm precisely that amount was deducted—not pennies and not the complete balance.
- Refund the second sale against its original receipt and confirm the eligible correction was applied once.