Make Payment Request (Tran Type 39-05)
After a check is selected for processing (automatically or by the server), the screen flow for customer interaction will depend on values received from the POS (or default configuration):
If Partial Payment is enabled (field 5213 in the Login Response), a screen will display the check amount, and allow the customer to enter a lesser amount. In this case, the Tip percentages screen (if displayed) will show the entered amount as well as the remaining balance.
If Tip percentages are enabled (percentages returned in field 5104, Tip flag set to 1 in field 5214), a screen will show the returned percentages/corresponding amounts, and allow the customer to make a selection. If configured, “None” and/or “Other” will also appear; selecting “Other” will prompt for a Tip amount (same as next screen).
If prompting for a Tip amount is enabled (Tip flag set to 2 in field 5214), a screen will prompt for a Tip amount using the text from field 5104 if sent, else using configured text.
If a gratuity is automatically calculated (Tip flag set to 3 in field 5214), Simplify will proceed directly to the Insert/Tap/Slide screen. Total will be explained using the text from field 5104 if sent, else using hard-coded text.
If Tip is disabled (Tip flag set to 0 in field 5214), Simplify will proceed directly to the Insert/Tap/Slide screen (no tip or gratuity).
Note: Fields 5104 and 5214 can be sent in the Login Response and/or Get Check Information Response. Login settings apply until the next login unless different settings are defined for a check in a Get Check Information Response.
A Make Payment Request message is sent by Simplify after transaction information has been entered for a check (or part of a check if partial payment is enabled and selected by the customer) and (if enabled) the customer has approved the transaction amount (typically disabled for Pay@Table).
There is no Make Payment Response message. The POS responds to a Make Payment Request by sending a financial request to Simplify.
Make Payment Request
A sample Make Payment Request message is as follows:
|API Field #, Value||Description|
|5217,01||Type of Transaction|
|5218,715||Pay@Table Message Reference Number|
|5219,12345678||Pay@Table Session ID|