1. Overview
M-Pesa is Safaricom's mobile money service, widely used in Kenya and other East African markets. The QR code standard encodes either a Lipa na M-Pesa (till number or paybill) or a personal phone number.2. Payload Format
M-Pesa uses a proprietary payload format within a QR code or a structured link. The typical merchant flow encodes: * Business name. * Till number or paybill number. * Optional account reference. * Optional amount.Safaricom provides a merchant portal and API to generate valid QR payloads. Do not construct payloads manually outside Safaricom's tools, as the format may change.
3. Consumer Experience
The customer scans with the M-Pesa app or the Safaricom app. The app pre-fills the merchant details; the customer enters the amount if not preset and confirms with their PIN.4. Display Tips
Print the till number and paybill in plain text beside the code so customers who prefer to type can still pay.Putting this into practice
Start with the smallest real test you can run. Generate the code, print it at the exact size you plan to use, and scan it with two different phones in the lighting where it will live. Check that the destination page loads quickly on a mobile connection and that the call to action next to the code tells people what they will get. If anything feels slow or unclear, fix it before you print a full batch, because reprints cost more than a short test. Keep a note of the size, material, and placement that worked so the next batch starts from a proven setup.Common mistakes to avoid
The most common mistakes are easy to avoid once you know them. Long payloads make modules tiny, low contrast makes edges hard to read, and text placed too close to the border eats the quiet zone the scanner needs. Covering a corner finder pattern with a logo or a sticker breaks detection entirely, and a code placed behind glare or on a curved surface fails even when the print is perfect. Review each of these points on a proof copy, and treat any failure as a reason to adjust the design rather than a reason to blame the scanner.Quick checklist
- Keep the payload as short as practical so modules stay large. - Keep dark modules on a light background with strong contrast. - Leave a clear quiet zone on all four sides of the symbol. - Test the printed code at the real viewing distance and lighting. - Confirm the destination page loads fast on a phone. - Recheck the code after any change to the link, design, or placement.Codes that stay in circulation need occasional attention. Links change, pages move, and printed materials fade, so review each live code on a regular schedule and confirm it still opens the right destination. When a destination changes, update a dynamic code or reprint a static one on the same day, and remove old codes from circulation so nobody scans a dead link. Keep a simple register of where each code appears, what it points to, and when it was last tested, because a code nobody owns is a code nobody fixes.
