6 min read · Updated November 2026 · Official Diagnostics Guide
Troubleshooting Common Issues & FAQs
Quick diagnostic solutions for hardware barcode scanners, Meta WhatsApp message delivery, browser cache synchronization, capacity limits, and authentication.
!
Issue 1: WhatsApp Reminders or Receipts Not Delivering
Integration & Formatting ChecklistProbable Causes: Missing international country prefix, temporary developer token expiration, or Meta App permissions.
Check 1: Phone Formatting: Verify the member mobile number has country code (e.g.
+12025550143 or +919876543210). Avoid spaces, hyphens, or leading zeros.Check 2: Permanent Token: In Meta Business Suite, ensure you created a System User Permanent Access Token with the
whatsapp_business_messaging permission set to "Never Expire".Check 3: Test Connection: In KeepBill, go to Settings → Integrations and click Test Connection to verify live response from Meta.
!
Issue 2: Barcode Scanner Enters Member ID But Doesn't Submit Check-In
Hardware Suffix ConfigurationProbable Cause: Handheld barcode scanner is not configured to send an Enter / Carriage Return (CR) character after scanning.
1. Find the quickstart configuration booklet that arrived in the scanner packaging.
2. Scan the barcode titled "Add Enter Suffix" or "CR / LF Carriage Return".
3. Test in Windows Notepad: scanning a card should type the code and immediately drop the cursor to the next line. In KeepBill, it will now trigger instant check-in.
!
Issue 3: Data Appears Outdated or Changes Don't Reflect
Browser Cache RefreshProbable Cause: The browser has cached older JavaScript assets or stylesheets.
Press Ctrl + F5 (Windows / Linux) or Cmd + Shift + R (Mac) to bypass local browser cache and fetch fresh cloud assets.
!
Issue 4: "Member Limit Reached" Error When Adding Members
Plan Capacity ManagementCause: Your business has reached 100% of the active member quota allowed by your subscription plan.
• Option A (Upgrade): Go to Settings → Plan & Billing and upgrade from Free (25 members) to Starter (100 members) or Pro (500 members) for instant capacity expansion.
• Option B (Archive): Go to Members, locate members who no longer attend, and toggle their status to Archived. Archived members do not count toward your active quota.
Frequently Asked Questions
The two most common reasons are: 1) The member phone number is missing the international country prefix (e.g. +1 for US/Canada, +44 for UK, +91 for India). 2) The Meta access token has expired (using a 24-hour temporary developer token instead of a Permanent System User Token).
Still experiencing technical difficulty?
Our engineering and customer support team responds within 2 business hours.