Skip to content
Reward Loyalty
Get it · $349
Reward Loyalty
Get it · $349 Sign in
Documentation
Back to Home Buy Reward Loyalty

Troubleshooting.

Resolve common stamp card problems at point-of-sale

Jul 20, 2026

Resolve common stamp card issues to keep checkout moving and customers happy. This guide covers the most frequent problems and their solutions.

QR code scanning issues

QR code won't scan

Symptoms:

  • Camera doesn't recognize code
  • Scan takes a long time
  • Error message appears
  • Nothing happens when scanning

Common Causes & Solutions:

1. Poor lighting

  • Solution: Move to better-lit area or ask customer to increase screen brightness
  • Prevention: Ensure checkout area is well-lit

2. Dirty camera lens

  • Solution: Clean your device's camera lens with soft cloth
  • Prevention: Clean lens at start of each shift

3. Screen protector interference

  • Solution: Ask customer to tilt phone to reduce glare
  • Alternative: Use manual entry if protector is damaged

4. Stale page

  • Solution: Ask the customer to close and reopen their stamp card
  • Why: The QR code itself never expires; reopening redraws it at full brightness

5. Wrong distance

  • Solution: Hold device 6-12 inches from customer's screen
  • Tip: Code should fill 50-75% of camera view

6. Shaky hands

  • Solution: Hold both devices steady for 2-3 seconds
  • Tip: Rest your hand on counter for stability

If all else fails:

  • Use manual stamp entry
  • Takes 30-60 seconds longer
  • Same result as scanning

Wrong QR code displayed

Symptoms:

  • Scan shows different customer
  • Wrong stamp card appears
  • Unexpected information

Causes & Solutions:

Customer showing wrong code:

  • Solution: Ask them to close and reopen the correct stamp card
  • Verify: Customer name matches person in front of you

Customer has multiple accounts:

  • Solution: Ask which email they signed up with and match it against the masked address shown
  • Use: The account they collect on

Previous customer's code still on screen:

  • Solution: Close the form and start fresh
  • Prevention: Close after each transaction

Eligibility issues

"Minimum purchase not met"

Message: "Purchase amount below minimum requirement"

Explanation:

  • Program requires minimum purchase (e.g., $5)
  • Current purchase is below that amount
  • Customer doesn't qualify for stamp

Solutions:

Option 1: Explain to customer "Your purchase needs to be at least $5 to earn a stamp. Your current total is $3.50. Would you like to add anything else?"

Option 2: Customer adds items

  • Customer adds more items
  • New total meets minimum
  • Scan again and add stamp

Option 3: Customer declines

  • Explain they can earn a stamp next time
  • Complete sale without stamp
  • Thank them for understanding

Never:

  • Override minimum without manager approval
  • Add stamp when not eligible
  • Make exceptions without authorization

"Daily limit reached"

Message: "Customer has reached maximum stamps for today"

Explanation:

  • Program limits stamps per day (e.g., 3 per day)
  • Customer already earned maximum today
  • Prevents abuse while being fair

Solutions:

Explain to customer: "You've already earned your maximum 3 stamps today. The limit resets at midnight, so you can earn more stamps tomorrow!"

If customer is upset:

  • Apologize for inconvenience
  • Explain it's a program rule
  • Emphasize they can continue tomorrow
  • Escalate to manager if needed

Never:

  • Override daily limits
  • Add stamps by hand to bypass limit
  • Promise exceptions

"Program has expired"

Message: "This stamp card program is no longer active"

Explanation:

  • Program had end date
  • End date has passed
  • No more stamps can be earned

Solutions:

Explain to customer: "This program ended on [date]. Unfortunately, no more stamps can be added to this card."

If customer has uncompleted card:

  • Apologize
  • Check if they have pending rewards
  • Direct to manager for possible resolution
  • Mention any new programs available

If customer has completed card:

  • Check if reward is still claimable
  • Process reward if possible
  • Thank them for participation

If the business retired the card (no end date passed): the customer keeps it in their wallet's Winding down section, and a completed reward stays redeemable. Scan and process it as normal; only adding new stamps has stopped.

A reward is waiting to be claimed

What you see: a "Reward ready" notice on the Add stamp page.

Explanation:

  • The card completed and holds one or more pending rewards
  • The card already reset at completion, so stamping continues as normal
  • A waiting reward never blocks new stamps; rewards queue up until claimed

Solutions:

If points reward:

  • Points auto-credited at completion; verify them on the linked loyalty card if the customer asks

If physical reward:

  • Ask if the customer wants to claim now
  • Process the claim from their reward QR
  • Add today's stamp either way

Tell customer: "You have a reward ready! Want to claim it now? Either way, today's stamp still counts toward your next one."

Customer account issues

Customer not found

Symptoms:

  • Search returns no results
  • "No customer found" message
  • Cannot locate account

Common Causes & Solutions:

1. Misspelled name

  • Solution: Ask the customer to spell their name, or try their email or identifier; search matches any of the three
  • Try: Recent customers, if they visited before

2. Customer new to your club

  • Solution: Point them at your join QR; scanning it creates their account in seconds
  • Note: Once they scan your join QR and hold your card, they appear in your list, shown as Not active yet until their first stamp or points

3. Wrong club selected

  • Solution: Verify customer is at correct location
  • Check: If they're member of your club

4. Customer at different business

  • Solution: Explain they need to visit the correct location
  • Help: Direct them if possible

Multiple customers with same name

Symptoms:

  • Search returns several results
  • Unsure which is correct customer

Solutions:

Verify identity:

  1. Ask which email they signed up with and match it against the masked address shown
  2. Confirm full name
  3. Check their recent activity with your club

Select correct customer:

  • Match email
  • Verify with customer
  • Double-check before proceeding

If still unsure:

  • Ask manager for help
  • Don't guess
  • Accuracy matters

Transaction issues

Stamp not added

Symptoms:

  • Clicked "Add Stamp" but nothing happened
  • No success message
  • Customer's app doesn't update

Troubleshooting:

1. Check for error message

  • Read any error displayed
  • Follow specific solution
  • Don't ignore errors

2. Verify internet connection

  • Check if you're online
  • Try refreshing page
  • Wait and try again

3. Check whether it added

  • Look at transaction history
  • Verify stamp count
  • May have worked despite no message

4. Try again

  • Scan code again
  • Or use manual entry
  • Verify success this time

If problem persists:

  • Note customer information
  • Contact manager
  • Add stamp later when system works
  • Apologize to customer

Duplicate stamp added

Symptoms:

  • Stamp added twice
  • Customer scanned twice by mistake
  • Two transactions at same time

Immediate Action:

If you catch it right away:

  • Don't panic
  • Tap Undo recent stamp on the history you land on; it reverses your own latest stamp as an audited entry

If you notice later:

  • Tell the business owner; the partner dashboard's Delete last stamp unwinds entries newest-first

Prevention:

  • Wait for success message before rescanning
  • Don't scan if already processed
  • Pay attention to confirmations

Wrong stamp card updated

Symptoms:

  • Stamp added to wrong program
  • Customer has multiple cards
  • Selected wrong card

Immediate Action:

If you catch it right away:

  1. Tap Undo recent stamp to reverse your own latest stamp on the wrong card
  2. Open the right card and add the stamp there

If it is not your own latest stamp:

  • Tell the business owner; the partner-side Delete last stamp handles it, and the system documents the correction

Prevention:

  • Verify stamp card name before adding
  • Ask customer which program if multiple
  • Double-check before clicking

Reward redemption issues

Reward code won't scan

Symptoms:

  • Reward QR code doesn't scan
  • Same issues as stamp collection codes

Solutions:

  • Try all QR scanning troubleshooting steps
  • Verify it's the reward code, not collection code
  • Ask customer to close and reopen
  • Use manual lookup if needed

Manual process:

  1. Search for customer
  2. Open stamp card
  3. Verify completion
  4. Get manager approval
  5. Give reward
  6. Manager confirms in system

No pending rewards

Symptoms:

  • Customer claims reward ready
  • System shows no pending rewards
  • Card not complete

Troubleshooting:

1. Verify completion:

  • Check stamp count
  • Compare to stamps required
  • Show customer their progress

2. Check if already claimed:

  • Review transaction history
  • Look for redemption
  • Explain if already used

3. Verify correct card:

  • Customer may have multiple programs
  • Check they're showing right card
  • Direct to correct program

If genuine error:

  • Contact manager
  • Review history together
  • Resolve it

System and technical issues

System running slow

Symptoms:

  • Pages are slow to load
  • Delays in processing
  • Timeouts

Solutions:

Short term:

  • Be patient
  • Warn customers of delay
  • Complete sales first, add stamps after
  • Use manual entry if faster

Report to manager:

  • Note the time
  • Describe the issue
  • Manager can investigate
  • May be temporary

Never:

  • Skip adding stamps
  • Promise to add later without noting
  • Ignore the issue

Internet connection lost

Symptoms:

  • Cannot load pages
  • "No connection" errors
  • System unresponsive

Immediate Actions:

1. Check connection:

  • Verify WiFi is on
  • Check if other devices work
  • Try cellular data if available

2. Continue serving customers:

  • Complete sales as usual
  • Note customers who need stamps
  • Add stamps when connection returns

3. Communicate:

  • Apologize to customers
  • Explain technical difficulty
  • Assure them you'll add the stamps
  • Get contact info if needed

4. Report to manager:

  • Notify them at once
  • Manager can troubleshoot
  • May need IT support

Device issues

Symptoms:

  • Tablet/phone not working
  • Camera not functioning
  • App crashes

Solutions:

Quick fixes:

  • Restart the device
  • Close and reopen browser
  • Clear cache if possible
  • Try different device

Workarounds:

  • Use manual entry only
  • Borrow colleague's device
  • Use backup device if available

Report to manager:

  • Device may need repair
  • May need replacement
  • May need IT support

Customer service issues

Angry customer

Situation: Customer upset about stamp card issue

Approach:

1. Stay calm:

  • Don't take it personally
  • Remain professional
  • Give them your attention

2. Empathize:

  • "I understand your frustration"
  • "I'm sorry this happened"
  • "Let me help you"

3. Investigate:

  • Look at their history
  • Verify their claim
  • Find the facts

4. Resolve:

  • Fix if you can
  • Escalate to manager if needed
  • Follow through

5. Follow up:

  • Ensure resolution
  • Thank them for patience
  • Invite them back

Confused customer

Situation: Customer doesn't understand how stamp cards work

Approach:

1. Keep it simple:

  • "You collect stamps with each purchase"
  • "When you have 10 stamps, you get a free coffee"
  • "It's like a digital punch card"

2. Show them:

  • Point to their progress
  • "You have 3 stamps now"
  • "You need 7 more"

3. Demonstrate:

  • "I'll add a stamp right now"
  • Show the process
  • Let them see it update

4. Encourage:

  • "You're on your way!"
  • "Come back to earn more"
  • "It's easy!"

When to escalate to manager

Situations requiring manager

Escalate these:

  • Customer disputes you can't resolve
  • System errors you can't fix
  • Requests to override eligibility
  • Accusations of fraud or abuse
  • Requests to delete transactions
  • Technical issues persisting
  • Angry customers you can't calm

How to escalate:

  1. Excuse yourself
  2. Find your manager
  3. Sum up the situation
  4. Let manager take over
  5. Learn from how they handle it

Situations you can handle

You can resolve:

  • Basic QR scanning issues
  • Simple customer questions
  • Standard stamp additions
  • Normal reward redemptions
  • Minor confusion or questions

When in doubt:

  • Ask your manager
  • Better to check than guess
  • Learning opportunity

Prevention tips

Avoid common issues

Before each shift:

  • Clean camera lens
  • Charge device
  • Test scanning
  • Review active programs

During transactions:

  • Verify customer identity
  • Check eligibility before adding
  • Wait for success messages
  • Double-check details

After issues:

  • Document what happened
  • Report to manager
  • Learn from mistakes
  • Improve next time

Build good habits

Always:

  • Ask every customer about stamps
  • Verify before submitting
  • Be clear
  • Stay patient and helpful

Never:

  • Rush through transactions
  • Ignore error messages
  • Override without permission
  • Promise what you can't deliver

Quick reference

Most common issues

  1. QR won't scan → Adjust lighting, clean lens, use manual entry
  2. Minimum not met → Explain requirement, offer to add items
  3. Daily limit reached → Explain limit, invite back tomorrow
  4. Customer not found → Verify spelling, try different identifier
  5. Duplicate stamp → Note it, tell manager to void

Emergency contacts

For technical issues:

  • Your manager
  • IT support (if available)

For customer disputes:

  • Your manager
  • Store manager

For system outages:

  • Your manager
  • Note affected customers

Next steps

Cookies on this site.

Google Analytics runs only if you allow it. Cookie policy