Skip to main content
PocketPassPocketPassEnglish

Lightspeed Retail (R-Series) POS extension

Scan a golfer's wallet pass at the Lightspeed Retail till to load their details and add them to the open sale. How to register the extension and use it.

Updated 11/5/2026

The Retail POS extension lets a cashier scan a golfer's PocketPass wallet pass at the till, see their customer and tee-time details, and add them to the open sale - so the sale is tied to the right Lightspeed Retail customer.

Before you start

  • Connect Lightspeed Retail (R-Series) on the Integrations page first.
  • The golfer needs a Lightspeed Retail customer record to be added to the sale. PocketPass finds it through the link Lightspeed Golf holds between the golfer and their Retail customer, or - if there's no link - by searching Lightspeed Retail for a customer with the golfer's email. Once found, the match is remembered so later scans are instant. If no Retail customer matches, the extension still shows the golfer's details but can't attach them to the sale.

Register the extension in Lightspeed

    1. On the Integrations page, click Continue setup (or Open) on your Lightspeed Retail connection. The setup checklist opens as a full-screen panel.
    2. In Step 1 - Add the PocketPass button to the Register's Sale Tab, copy the POS extension URL.
    3. In the Lightspeed Retail back office, go to Settings → Custom menus → Register: Sale Tab.
    4. Click Add a new button and set its Title to PocketPass.
    5. Edit the button (the pencil icon) and paste the POS extension URL into its URL field.
    6. Click Save changes. The PocketPass button now appears on the register's Sale screen - open a sale and tap it once to tick the step off.

The PocketPass Refund button

Refunds to a house account are taken on the register's Refund screen, so add a second button there:

    1. In the setup checklist, copy the Refund button URL (the same URL ending in ?mode=refund).
    2. In the Lightspeed Retail back office, go to Settings → Custom menus → Register: Refund Tab.
    3. Click Add a new button, set its Title to PocketPass Refund, and paste the refund button URL into its URL field.
    4. Click Save changes, start a refund and tap the button once to tick the step off.
Note

Step 1 ticks itself off automatically the first time Lightspeed loads the PocketPass button from a sale. There's nothing to confirm on the PocketPass side - if the step still looks pending after you've opened the button, open a sale and tap PocketPass one more time; the next signed request from Lightspeed completes it.

Note

Lightspeed signs the URL each time a register opens the button, and PocketPass checks that signature on every call. The button only works when it's opened from a sale or refund on your register, so a copy of the URL opened in a browser can't look anyone up. The signature expires after a while: if the till says the screen has expired, close PocketPass and open it again from the sale.

Use it at the till

    1. Start a sale on the register and open the PocketPass extension.
    2. Scan the golfer's wallet pass (camera) or type their customer number, confirmation code, or email.
    3. Review the golfer's details and tee times.
    4. Tap Add to sale - the golfer is attached to the sale as the customer, a check-in is recorded in PocketPass, and the extension closes back to the till.

If the golfer is on a shared account, a Charge to choice appears above Use credit: their own account, or the shared account (with what they can still spend on it). Scanning a shared-account card skips the choice, because that card only charges its own account.

Card on file. If the golfer hasn't saved a card, tap No card on file · Add one under their balance. They scan the QR code with their phone and enter the card on a secure payment page, or tap Email the link. The till shows the card once it's saved. See Statements, card on file and autopay.

Refunding to a house account. On the register's Refund screen, add the returned items and take any cash or card part of the refund. Then tap PocketPass Refund, scan the golfer and tap Refund to account: the rest of the refund goes onto their house account and the sale completes.

Refunding a top-up. A top-up can't be refunded through a Lightspeed sale. An owner deducts it with Adjust balance on the golfer's customer page, and you pay the cash out of the drawer with a register payout.

The PocketPass payment types are hidden. Setup archives PocketPass House Account (and PocketPass Prize Account) so they don't appear in the register's payment list. House-account payments can only be taken through the PocketPass buttons, because a payment keyed by hand would move money PocketPass never sees. Your accountant should map both to liability accounts; see House accounts in your Lightspeed Retail books.

When prize accounts are on, the golfer's screen also lists the prize accounts offered at this shop, so the cashier can add a competition entry to the sale or pay out a winner.

Troubleshooting

  • "Golfer is not a Lightspeed Retail customer." No Retail customer is linked to the golfer and none matched their email. Create or import them in Lightspeed Retail using the same email, then re-scan.
  • No golfer found. The pass may be from a different merchant, or the code was mistyped - try the email instead.
  • "This POS button isn't authorised." PocketPass was opened without Lightspeed's signature, for example from a bookmark or a copied link. Open it from the PocketPass button on a sale instead.
  • Camera won't open. The browser or register may be blocking camera access. Make sure you allow camera access when prompted, and that the register is on https. Because the extension runs inside Lightspeed's POS, the till itself must permit the camera for embedded extensions - if it doesn't, camera scanning won't be available and you should type the customer number, confirmation code, or email instead (this always works).

More in Integrations