Field 5104 (Tip Prompting)

note

This section describes the use of Field 5104 for non-Pay@Table systems. This API is also supported for Pay@Table, with different rules; see Pay@Table Field Formats and Descriptions under Field 5104 for details.

Supported settings

  • Set Tip flag (see below under Usage for details).

  • Define Tip prompting text.

  • Define up to three Tip percentages (used to calculate suggested Tip amounts).

Supported messages

  • Financial Request (echoed in Simplify response).

Format

Field 5104 format is as follows:

aa;bb;ccFSdFSe where:

  • aa, bb, cc – Tip percentages.
  • d – Tip flag (see values below).
  • e – Tip prompting text. Can include \n to indicate the start of an additional line of text.

Note: FS represents a 1 byte field separator.

Semi-colons (;) and field separators (FS) are required, even if some subfields are null.

Sample

5104,15;18;20FS1FSPlease Enter Additional\n Gratuity

Usage

For Financial Requests - Overrides configured Tip settings for the current transaction:

  • Tip Flag
    • 0 – No Tip prompting. Total transaction amount = Base amount (no tip or gratuity).
    • 1 – If Tip percentages defined, customer prompted to select Tip percentage/corresponding Tip amount. Else, customer prompted to enter Tip amount.
  • Tip Percentages
    • Used if Tip Flag = 1 (see above).
  • Tip Prompting Text
    • If Tip Flag = 1 and customer selects Other - replaces configured prompt on enter Tip amount screen.