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
0001,39 Transaction Type
0002,14.00 Transaction Amount.
0141,840 Currency Code
0201,1.99 Tip Amount
5100,05 Message Type
5105,4 Table Number
5106,125 Check Number
5217,01 Type of Transaction
5218,715 Pay@Table Message Reference Number
5219,12345678 Pay@Table Session ID