Troubleshooting Guide

Connecting a Bluetooth thermal receipt printer allows you to print paper bills directly from Trader POS. If you run into issues, try these steps:

• Printer prints blank paper: This is the most common issue. Thermal printers only print on one side of the paper. If the receipt comes out blank, open the printer, flip the paper roll over so the heat-sensitive side faces the correct direction, and try again.
• Printer does not appear in the app: Make sure Bluetooth is turned on on your mobile device. You must pair the printer in your device's system Bluetooth settings first before it will show up inside the Trader POS app.
• Prints scrambled text or symbols: Ensure your printer is ESC/POS compatible and uses a standard baud rate. If the text continues to appear scrambled, restart both the printer and the app, then try re-pairing the device.
• Printer disconnects frequently: Keep your mobile device within a 5-meter range of the printer. Low battery on either the printer or your mobile device can also cause Bluetooth connections to drop.

Trader POS allows you to scan products using your device's built-in camera. If the scanner is not working as expected:

• Permission denied error: The app must have permission to access your device camera. Go to your device’s system settings, select Apps > Trader POS > Permissions, and ensure Camera permission is set to "Allow".
• Scanning is slow or fails to detect: Hold your phone 10 to 15 centimeters away from the barcode. Ensure there is enough light; you can toggle the built-in flashlight/torch icon in the scanning window. Ensure the barcode is flat and not wrinkled or reflecting bright light.
• Barcode not found in inventory: Ensure the barcode matches the UPC/EAN code saved in your product settings. You can edit a product to scan and register its barcode, or type the code manually.

If you are trying to register or sign in and are not receiving the SMS one-time password (OTP):

• Check phone number format: Ensure you select the correct country code and enter your phone number without the leading zero (e.g., if your number is 055-XXXX-XXX, enter it as 55-XXXX-XXX after selecting the country code).
• Use USSD Verification: If the SMS OTP is delayed or failing to deliver, you can use the USSD method. The app will display a USSD code under the OTP input field (e.g., "Alternative: Dial *XXX#..."). Dial this code from your mobile device's dialer to retrieve your verification OTP code immediately.
• Network delays: SMS delivery can occasionally be delayed by cellular network congestion. Please wait at least 60 seconds before requesting a new OTP.
• Do Not Disturb (DND) settings: Some carriers filter promotional or automated SMS messages. Check if DND mode or spam filter settings on your phone are blocking the message.

Store owners can invite employees and managers to their shop. If your team is having trouble accessing the store:

• Match phone numbers exactly: Ensure the phone number you invite in the "Team" settings matches the exact number the employee uses to sign into their account.
• Role permissions: Cashiers cannot access sensitive store metrics, cost prices, or edit settings. If a team member requires these permissions, upgrade their role to Manager or Owner from the Team section.