QR codes are the primary way guests discover the Aplauso kiosk on their own phones. Each code encodes a URL that takes the guest directly into the tipping flow for a specific recipient - no searching, no typing.
URL Formats
| Recipient Type | URL Pattern | Use Case |
|---|---|---|
| Employee (short code) | k.aplauso.io/{shortCode} | Most common - each employee has a unique 6-char code |
| Employee (full ID) | k.aplauso.io/e/{firestoreId} | Used internally, same flow as short code |
| Outlet | k.aplauso.io/o/{outletId} | Tip the whole team at a specific venue (e.g., "The Pool Bar") |
| Department | k.aplauso.io/d/{departmentId} | Tip a whole department (e.g., "Housekeeping") |
| Property directory | k.aplauso.io/lookup/{propertyId} | Guest chooses who to tip from a searchable staff list |
Where to Get Your QR Code
For employees:
- Mobile app → Reward tab → QR Code sub-tab (displays and shares personal QR)
- Web dashboard → my.aplauso.io → Overview → QR code icon
- Print templates at my.aplauso.io → QR Templates
For departments and outlets:
- Manage → Departments → [Department] → QR Code (in the department detail)
- Manage → Outlets → [Outlet] → QR Code
- Or use the QR generator URL:
k.aplauso.io/qr/d/{departmentId}/k.aplauso.io/qr/o/{outletId}
QR Generator Tool (for print downloads):
Navigate to k.aplauso.io/qr/{type}/{id} where type is e, o, or d. The page renders a QR code image and offers a Download PNG button. Add a size parameter to control resolution:
/qr/e/{id}/5→ 140×140 px (minimum)/qr/e/{id}/10→ 280×280 px (default)/qr/e/{id}/30→ 840×840 px (high quality for large prints)
URL Parameters (Source Tracking)
Append parameters to track where tips come from:
| Parameter | Example | Effect |
|---|---|---|
?tag=doorhanger | k.aplauso.io/MARIA1?tag=doorhanger | Tags all tips and ratings from this QR as "doorhanger" source |
?tags=valet,front-desk | Multiple comma-separated tags | Multiple tracking tags |
?lang=es | Forces Spanish language for this QR | |
?lang=en | Forces English language for this QR |
Use source tags to measure which QR placement generates the most tips - door hangers vs. table cards vs. receipts.
Deployment Recommendations
| Location | Recipient Type | Format |
|---|---|---|
| Employee room card / door hanger | Individual employee | Printed business card with personal QR |
| Housekeeping cart | Department QR | Laminated card attached to cart |
| Spa treatment room | Individual employee | Framed tent card on table |
| Valet booth | Outlet QR | Counter sign or sticker |
| Restaurant table | Individual employee | Tent card |
| Hotel checkout counter | Property directory lookup | Signage pointing to /lookup/{id} |
Backward Compatibility
Legacy QR codes using the /r/ prefix (e.g., k.aplauso.io/r/e/{id}) are automatically redirected to the current URLs. Old printed materials remain fully functional.
Print Quality Tips
- Minimum QR code print size: 2 cm × 2 cm (0.8 × 0.8 inches)
- Use high contrast (black on white) - avoid printing QR codes on dark or patterned backgrounds
- Test every printed QR with at least two different phone models before mass printing
- Download PNG at the highest size parameter available for professional print shops (size=30 or higher)