Configuring the Kiosk - Tip Presets, Prompts, Room Charge, and Branding

The Aplauso kiosk adapts to your property's service style through a set of server-side configuration options. There is no separate "kiosk admin" interface - all settings are managed from the property management dashboard or via the API.

What You Can Configure

Tip Preset Amounts

The default preset tip buttons are: $2 · $5 · $10 · $15 · $20 · $50

These can be customized per employee, outlet, or department. For example:

A high-end spa might use: $10, $20, $30, $50, $100
A casual restaurant might use: $1, $2, $3, $5, $10

To change tip presets, update the webTipPresets field on the employee/outlet/department record. Contact your Aplauso account manager or use the admin API.

Rating Prompt

The text displayed above the stars on the rating screen. Default values:

Employee: "How's my service?"
Department / Outlet: "How's our service?"

Customize this to match your brand voice or the specific service being rated:

"How was your valet experience today?"
"Rate your wellness journey with us"
"How did we do during your stay?"

Tip Prompt

The text displayed above the tip amount options. Default: "Add a tip?"

Customize example: "Show your appreciation for great service"

Enable / Disable Ratings

Set allowRatings: false to skip the rating step entirely. Guests go directly from landing to tip selection. Useful for:

Kiosks focused purely on payment
Situations where collecting ratings might feel too formal

Enable / Disable Tips

Set allowTips: false to collect ratings only, with no payment step. After the guest rates, they are sent directly to the thank-you page without any payment prompts.

Room Charge

Set allowRoomCharge: true to show the "Charge to Room" button as a payment option. Requires:

Your property to have guest visit tracking enabled
A working lookupVisitByRoom integration (contact Aplauso to configure)

Service Charge Percentage

The fee added on top of the tip amount shown to the guest (default: 5%). This is configured at the property's finance settings level. The charge cannot be disabled for live transactions (it covers payment processing costs) but the percentage can be adjusted.

Currency

Configured at the property level:

Code	Currency
`usd`	US Dollar
`cad`	Canadian Dollar
`mxn`	Mexican Peso

Employee Search (Lookup Link)

Set allowEmployeeSearch: true to display a "Looking for someone else?" link on individual employee or department pages. Tapping it redirects the guest to the property lookup directory at k.aplauso.io/lookup/{propertyId}.

This is useful on shared kiosk devices: the guest scans the kiosk QR (which might default to a department or manager), then searches for their specific housekeeper or server.

Branding

The kiosk uses a dark theme by default (dark background, light text). The recipient's name, photo, and role appear prominently. Property-specific logo or color branding is not currently applied at the kiosk level - the look is intentionally neutral and professional.

Testing Your Configuration

Before going live:

Set your environment to sandbox mode (see Testing in Sandbox Mode).
Open the kiosk URL and verify tip amounts, prompts, and payment methods appear as expected.
Run a test payment with a Stripe test card number: 4242 4242 4242 4242 (any future expiry, any CVC).
Confirm the thank-you page shows the correct tip amount and recipient name.