All pages
Powered by GitBook
1 of 1

Loading...

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 Start Transaction - Command 0x1001. At the end of the transaction, the device has provided data to the host in Transaction Operation Complete - Notification 0x0105. 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

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

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

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

3

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

4

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

5

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

6

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

Tag
Len
Value / Description
Typ
Req
Default
Tag
Len
Value / Description
Typ
Req
Default

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

1801 = Request Cardholder Signature (Touch Only) - Command 0x1801

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

1801 = Request Cardholder Signature (Touch Only) - Command 0x1801

No parameters.

End of any wrappers, at minimum including Response Message

Beginning of any wrappers, at minimum including Request Message

Beginning of any wrappers, at minimum including Response Message

Host decides whether to request a signature

Host composes command

Device presents signature UI

Device notifies host of completion or issues

Host retrieves signature file (if data available)

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

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

Request Example

Response Example

Example (Hex)
AA 00 81 04 01 00 18 01 84 05 18 01 81 01 1E
Example (Hex)
AA 00 81 04 82 00 18 01 82 04 01 00 00 00