Request Cardholder Signature

Command 0x1801 - Request Cardholder Signature (Touch Only)

The host uses this command to prompt a cardholder for a signature.

The sequence of events is as follows:

1

Transaction completed / Host may request signature

The device completes a transaction after the host invokes Command 0x1001 - Start Transaction. At the end of the transaction, the device has provided data to the host in Notification 0x0105 - Transaction Operation Complete. The host may send Command 0x1801 to the device to get a signature file without doing a transaction. The signature file can be encrypted if enabled.

2

Host decides whether to request a signature

The host decides whether to request a signature from the cardholder. For example:

• If the Notification Detail in Notification 0x0105 - Transaction Operation Complete indicates Signature Capture Requested.

• If an application-specific rule requires requesting a signature.

3

Host composes command

If the host determines it should request a signature, it composes a command request in the format shown below.

4

Device presents signature UI

The device presents a signature capture interface to the cardholder on the display.

5

Device notifies host of completion or issues

The device sends Notification 0x1805 - User Interface Operation Complete to the host to report data available, timeout, or hardware failure.

6

Host retrieves signature file (if data available)

If the device reported data available, the host uses Command 0xD821 - Start Get File from Device to request file type Signature Capture File to retrieve the data as a Signature Capture File Type.

Table - Request Data for Command 0x1801 - Request Cardholder Signature (Touch Only)

Tag	Len	Value / Description	Typ	Req	Default
Beginning of any wrappers, at minimum including Request Message
1801 = Command 0x1801 - Request Cardholder Signature (Touch Only)
81	01	Timeout — Timeout in seconds that the device should wait for the cardholder to sign and confirm completion.	B	R
82	01	Encryption on signature and user data. 0=disabled, 1=enabled.	B	O	0
A3	var	User data parameters for item #0 to item #3. The maximum total size of 0xA3 TLV is 4,000 bytes. This TLV may be present only if encryption is enabled.	T	O
/81	var	User data item #0, optional	B	O
/82	var	User data item #1, optional	B	O
/83	var	User data item #2, optional	B	O
/84	var	User data item #3, optional	B	O
End of any wrappers, at minimum including Request Message

Table - Response Data for Command 0x1801 - Request Cardholder Signature (Touch Only)

Tag	Len	Value / Description	Typ	Req	Default
Beginning of any wrappers, at minimum including Response Message
1801 = Command 0x1801 - Request Cardholder Signature (Touch Only)
No parameters.
End of any wrappers, at minimum including Response Message

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

Table - Request Example

Example (Hex)

AA 00 81 04 01 00 18 01 84 05 18 01 81 01 1E

Table - Response Example

Example (Hex)

AA 00 81 04 82 00 18 01 82 04 01 00 00 00