For the complete documentation index, see llms.txt. This page is also available as Markdown.

Report Cardholder Selection - Command 0x1802

The host uses this command to provide a cardholder selection to the device when the device itself does not have a display or inputs to prompt the cardholder for a selection.

Sequence of events:

1

Transaction already started

The host has already invoked Start Transaction - Command 0x1001 and the transaction is still in process.

2

Device requests host UI action

During the transaction, if the device does not have a display or touchscreen but needs to show information to the cardholder or needs the cardholder to make a selection, it sends the host User Interface Host Action Request - Notification 0x1803 to report Display / Cardholder Selection and supporting information.

3

Host prompts cardholder

The host uses its user interface to request a selection from the cardholder based on the information and selectable items provided by the notification message.

4

Host reports the selection to the device

The host sends the user selection to the device by sending Command 0x1802 in the format described below.

Request Data for Report Cardholder Selection - Command 0x1802

Beginning of any wrappers, at minimum including Request Message.

Tag
Len
Value / Description
Typ
Req
Default

1802

Report Cardholder Selection = Command 0x1802

81

01

Cardholder Selection Request Status - 0x00 = Cardholder Selection Request completed, see Selection Result parameter. - 0x01 = Cardholder Selection Request canceled by cardholder, Transaction Aborted. - 0x02 = Cardholder Selection Request timed out, Transaction Aborted.

B

R

82

01

Selection Result — Menu item index the cardholder selected. If the cardholder made no selection or the operation terminated abnormally, the device does not include this parameter.

B

O

End of any wrappers, at minimum including Request Message.

If the request started successfully, the Request Status in the message wrapper is OK, Started / Running, All good / requested operation was successful.

Response Data for Report Cardholder Selection - Command 0x1802

Beginning of any wrappers, at minimum including Response Message.

Tag
Len
Value / Description
Typ
Req
Default

1802

Report Cardholder Selection - Command 0x1802

No parameters.

End of any wrappers, at minimum including Response Message.

Request Example (Hex)

Response Example (Hex)

Last updated