> ## Documentation Index
> Fetch the complete documentation index at: https://developers.perkstar.co.uk/llms.txt
> Use this file to discover all available pages before exploring further.

# Loyverse POS

> Connect Perkstar to Loyverse for Wallet QR scanning, automatic points, exact balance redemption and matched refunds.

<img src="https://mintcdn.com/perkstar/cK5MV8DQx6JqSKwP/assets/loyverse-logo.svg?fit=max&auto=format&n=cK5MV8DQx6JqSKwP&q=85&s=0067357b3a045c14796849f61fce0940" alt="Loyverse" width="142" height="38" data-path="assets/loyverse-logo.svg" />

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.

<CardGroup cols={3}>
  <Card title="Identify" icon="qrcode">
    Scan the customer's Wallet QR code and attach the matching Loyverse customer
    to the ticket.
  </Card>

  <Card title="Earn" icon="sparkles">
    Perkstar reads the paid Loyverse receipt and applies the earning rules on
    the connected Points card.
  </Card>

  <Card title="Spend" icon="sterling-sign">
    Redeem the full available balance or enter a smaller amount without leaving
    Loyverse POS.
  </Card>
</CardGroup>

<Warning>
  **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.
</Warning>

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

<CardGroup cols={3}>
  <Card title="Set up Loyverse" icon="sliders" href="/integrations/loyverse/setup">
    Prepare the card, set Loyverse to 0%, connect and activate safely.
  </Card>

  <Card title="Use it at checkout" icon="cash-register" href="/integrations/loyverse/checkout">
    Give staff a clear scan, earn and partial-redemption workflow.
  </Card>

  <Card title="Refunds and help" icon="rotate-left" href="/integrations/loyverse/refunds-troubleshooting">
    Handle corrections, delayed updates, troubleshooting and disconnection.
  </Card>
</CardGroup>

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

<Note>
  Need help with a live connection? Email
  [Loyverse@perkstar.co.uk](mailto: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.
</Note>


## Related topics

- [Loyverse POS](/integrations/loyverse/index.md)
- [Use Loyverse at checkout](/integrations/loyverse/checkout.md)
- [Set up Loyverse](/integrations/loyverse/setup.md)
- [Integration gallery](/integrations/index.md)
- [Refunds and troubleshooting](/integrations/loyverse/refunds-troubleshooting.md)