Loyverse POS - Perkstar Developers

Run one complete loyalty journey at the Loyverse till. Staff scan the QR code on a customer’s branded Apple Wallet or Google Wallet card, paid purchases earn points automatically, and the customer can spend all or part of their available Points-to-Cash balance during checkout.

Identify

Scan the customer’s Wallet QR code and attach the matching Loyverse customer to the ticket.

Earn

Perkstar reads the paid Loyverse receipt and applies the earning rules on the connected Points card.

Spend

Redeem the full available balance or enter a smaller amount without leaving Loyverse POS.

Set Loyverse’s own loyalty earning percentage to 0% before enabling till redemption. Perkstar calculates points from the paid receipt. Leaving both systems earning can reward the same purchase twice.

What stays in sync

Event	What Perkstar does
Customer scans their Wallet card	Finds or creates the eligible Loyverse customer and links the Wallet QR identifier
Paid sale	Applies the connected card’s earning rule once
Partial or full redemption	Deducts the exact monetary point discount recorded on the paid receipt
Eligible refund or cancellation	Reverses applicable earning and restores supported redeemed value once
Loyalty balance changes	Refreshes the Wallet card and the spendable value available in Loyverse

Perkstar is the source of truth for points, spendable balances and loyalty activity. Loyverse remains the source of truth for sales and refunds.

What you need

A Perkstar business and plan that includes the Loyverse integration.
Owner or manager access in Perkstar and permission to connect apps in the intended Loyverse business.
The same two-decimal currency in both systems.
An active individual Points card with automatic earning, a QR code and flexible Points-to-Cash spending.
An online Loyverse POS device with camera barcode scanning enabled, or a compatible external barcode scanner.

Set up Loyverse

Prepare the card, set Loyverse to 0%, connect and activate safely.

Use it at checkout

Give staff a clear scan, earn and partial-redemption workflow.

Refunds and help

Handle corrections, delayed updates, troubleshooting and disconnection.

Data flow

Direction	Information	Purpose
Loyverse → Perkstar	Business identity, currency, customer reference, and paid receipt or refund information	Match the correct business and customer, calculate earning, read the exact redemption and reconcile corrections
Perkstar → Loyverse	Customer name, email and optional phone when a profile must be created; managed Wallet QR identifier; current spendable balance	Find the customer by scanning and make their balance available through Redeem points
Perkstar → Wallet platforms	Updated Points, Balance and programme fields	Keep the customer’s Apple Wallet or Google Wallet card current

Products, inventory, employees, taxes and payment information are not synchronised. Perkstar connects through Loyverse OAuth, so the business does not share its Loyverse password with Perkstar.

Need help with a live connection? Email Loyverse@perkstar.co.uk with the Perkstar business name, Loyverse receipt number and approximate time. Never send a password, access token or customer’s Wallet QR value.

Identify

Earn

Spend

​What stays in sync

​What you need

Set up Loyverse

Use it at checkout

Refunds and help

​Data flow

What stays in sync

What you need

Data flow