KeepBill Docs
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 Checklist

Probable 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 Configuration

Probable 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 Refresh

Probable 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 Management

Cause: 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.

Contact Support