4 - Command Set
DynaPro Go| Handheld PIN Pad Device with MSR/Contact/Contactless | Programmer’s Manual (COMMANDS)
Page 114 of 247 (
D998200136-31
)
4.5.3
Command 0xA0 - Request Tip or Cashback (Handheld Operation Only)
The host uses this command to direct the device to request tip or cashback information from the
cardholder or operator if the solution design needs that information to start an EMV transaction. The
device prompts the cardholder or operator to enter the requested information, and upon successful entry
sends
Report 0x30 - Tip or Cashback Report (Handheld Operation Only)
or cashback amount, which the host can then use when it calls
The maximum length of Transaction Amount, Calculated Tax Amount, Tip dollar amount, and Cash Back
dollar amount is 10 digits. If the Tip calculated by percentage equals or exceeds $42,949,672.95, the
device shows
0
.
If an error occurs, the device terminates the command and reports the error in ACKSTS of
. For a full list of error codes, see
Table 4-76 - Usage Table for Command 0xA0
Bit
7
6
5
4
3
2
1
0
Byte 0
0xA0
Byte 1
Wait time in seconds, (0x01..0x3C) for cardholder to enter Tip or Cashback
Byte 2
Operating Mode:
0x00 = Tip mode
0x01 = Cashback mode
Byte 3
Beeper Behavior (Only changes device behavior if
Beeper Mode
=
Enabled
in
Command 0x09 - Set / Get Device Configuration
on page
Bytes 4..9
Transaction Amount (n12 format)
Bytes 10..15
Calculated Tax Amount (n12 format)
Bytes 16..18
Tax Rate % (n6 format x 100) (Handheld Operation Only). This information is for screen
display only, the device does not perform any tax calculation
Byte 19
Fixed Tip Selection Mode:
0x00 = Percent Mode
0x01 = Amount Mode
Not applicable when using Cashback mode
Byte 20
Percent or Fixed Amount for left button (format n2)
Not applicable when using Cashback mode
Byte 21
Percent or Fixed Amount for middle button (format n2)
Not applicable when using Cashback mode
Byte 22
Percent or Fixed Amount for right button (format n2)
Not applicable when using Cashback mode
Bytes 23..48
Reserved