7 - Notification Messages Sent from Device to Host (Extended Notifications Only)
eDynamo| Secure Card Reader Authenticator | Programmer’s Manual (COMMANDS)
Page 63 of 245 (
D998200115-17
)
7.2.3
Notification 0x0302 - User Selection Request (Contact Only)
This notification is used to inform the host that a user selection is needed before the device can continue
processing the current transaction. The host should prompt the cardholder to select an item from the
menu, then send
Extended Command 0x0302 - User Selection Result
transaction can proceed with the selected result.
Offset Field Name
Value
0
Selection
Type
This field specifies what kind of selection request this is:
0x00 = Application Selection
0x01 = Language Selection
1
Timeout
Specifies the maximum time, in seconds, allowed to complete the selection
process. If this time is exceeded, the host should send
0x0302 - User Selection Result
with the Selection Status field set to
0x02
(User Selection Request aborted, timeout) after which the transaction is
aborted and an appropriate Transaction Status is available. Value 0 (User
Selection Request completed) is not allowed in this case.
2
Menu Items
This field is variable length and is a collection of null-terminated strings
(maximum 17 strings). The maximum length of each string is 20 characters,
not including a Line Feed (
0x0A
) character that may be in the string. The
last string may not have the Line Feed character.
The first string is a title and should not be considered for selection.
It is expected that the host displays the menu items to the cardholder, then,
after the cardholder makes a selection, call
to return the number of the item the cardholder
selected, which should be between 1 and the number of menu selection items
being displayed. The first item, 0, is the title only.