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

Request Cardholder Signature (Touch Only) - Command 0x1801

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

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 Transaction Operation Complete - Notification 0x0105 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 User Interface Operation Complete - Notification 0x1805 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 Start Get File from Device - Command 0xD821 to request file type Signature Capture File to retrieve the data as a Signature Capture File Type.

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

Tag
Len
Value / Description
Typ
Req
Default

Beginning of any wrappers, at minimum including Request Message

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

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 = Request Cardholder Signature (Touch Only) - Command 0x1801

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.

Request Example

Response Example

Last updated