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

# Use Loyverse at checkout

> Show staff how to scan a customer's Wallet card, award points and redeem an exact balance through Loyverse POS.

Staff stay inside the Loyverse POS journey. The customer only needs the branded
loyalty card in Apple Wallet or Google Wallet.

## Find the customer and earn points

<Steps>
  <Step title="Build the ticket">
    Add the sale items in Loyverse as normal.
  </Step>

  <Step title="Scan the Wallet card">
    Tap **Add client** or **Add customer** and scan the QR code on the
    customer's Perkstar Wallet card with the device camera or compatible barcode
    scanner.
  </Step>

  <Step title="Attach the matched customer">
    Check the correct profile has opened, then tap **Add to ticket**.
  </Step>

  <Step title="Complete payment">
    Take payment in Loyverse normally. Perkstar applies the connected card's
    automatic earning rule after it receives the paid receipt.
  </Step>
</Steps>

<Warning>
  Attach the customer before payment. Perkstar does not guess who made an
  unattached purchase and will not award that sale to someone later.
</Warning>

## Redeem some or all of the balance

<Steps>
  <Step title="Attach the customer">
    Add the items, scan the Wallet card and add the matched profile to the
    ticket.
  </Step>

  <Step title="Open redemption">
    Open the customer profile and tap **Redeem points**.
  </Step>

  <Step title="Enter the requested amount">
    Use the full maximum or enter a lower eligible amount requested by the
    customer, then tap **OK**.
  </Step>

  <Step title="Check and charge">
    Check the point discount under **Discounts**, then tap **Charge** and
    complete payment.
  </Step>
</Steps>

<Info>
  Loyverse labels the checkout value as points, but while this integration is
  live it represents spendable money. At a GBP till, **5.00 means £5.00**.
  Perkstar reads the exact monetary discount from the paid receipt, so entering
  £1.25 deducts £1.25—not £0.01 and not the whole available balance.
</Info>

The customer can spend only the balance currently available. Before the
configured minimum is reached, the spendable balance is zero and the Wallet card
shows the points remaining until it unlocks.

## What the customer experiences

1. Join the business's Points card and add it to Apple Wallet or Google Wallet.
2. Show the Wallet QR code at checkout.
3. Earn points after a paid sale when the customer was attached to the ticket.
4. Once the minimum is reached, choose how much available balance to spend.
5. See updated Points and Balance fields after Perkstar reconciles the receipt
   and the Wallet refresh completes.

## When updates appear

Online receipts normally begin syncing when Loyverse sends a receipt update.
If that notification is delayed, Perkstar's five-minute recovery sync looks for
the missing change. The Wallet refresh is queued after the loyalty update and
its display timing can also depend on the Wallet platform and phone connection.

If a POS device takes a sale offline, Perkstar cannot see it until Loyverse
syncs the receipt. Reconnect the device and allow the normal sync to finish. Do
not repeat the sale or make a manual loyalty adjustment to compensate for a
delay.

Loyverse provides illustrated instructions for [scanning a customer
barcode](https://help.loyverse.com/help/scanning-customer-barcode) and [redeeming
points](https://help.loyverse.com/help/points-discounts).


## Related topics

- [Loyverse POS](/integrations/loyverse/index.md)
- [Set up Loyverse](/integrations/loyverse/setup.md)
- [Integration gallery](/integrations/index.md)
- [Refunds and troubleshooting](/integrations/loyverse/refunds-troubleshooting.md)
- [Find-or-create customer + post transaction in one call](/api-reference/marketplace/find-or-create-customer-+-post-transaction-in-one-call.md)