> For the complete documentation index, see [llms.txt](https://developer.magtek.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/data-types-and-shared-tlv-data-objects/signature-capture-file-type-touch-only.md).

# Signature Capture File Type (Touch Only)

The signature capture file type produced when the host invokes Command 0x1801 - Request Cardholder Signature (Touch Only) is a TLV data object in the format below. If the encryption is enabled in Command 0x1801, please refer to Encrypted Signature Capture File Type below.

## **Table SCF-1 - Signature Capture File Type**

<table><thead><tr><th width="76">Tag</th><th width="74.6666259765625">Len</th><th>Value / Description</th><th width="74.3333740234375">Typ</th><th width="77.51507568359375">Req</th><th>Default</th></tr></thead><tbody><tr><td>81</td><td>08</td><td>Signature Window Width and Height Bytes 0..1 = Left edge (minimum value of all X coordinates) Bytes 2..3 = Right edge (maximum value of all X coordinates) Bytes 4..5 = Top edge (minimum value of all Y coordinates) Bytes 6..7 = Bottom edge (maximum value of all Y coordinates)</td><td>B</td><td>R</td><td>0000 00FD 0000 0078 (landscape) 0000 00C8 0000 00B9 (portrait)</td></tr><tr><td>82</td><td>var</td><td>Signature Coordinate Values List This is a blob that consists of a raw list of point coordinates representing the signature. Each coordinate is 4 bytes long, where the first 2 bytes are the X coordinate of that point and the second 2 bytes are the Y coordinate of that point.</td><td>B</td><td>O</td><td></td></tr></tbody></table>

## **Table SCF-2 - Encrypted Signature Capture File Type**

<table><thead><tr><th width="102.99996948242188">Tag</th><th width="80">Len</th><th>Value / Description</th><th width="78.33331298828125">Typ</th><th width="83.33331298828125">Req</th><th width="109.66677856445312">Default</th></tr></thead><tbody><tr><td>F9</td><td>var</td><td>Container for MAC structure and generic data, length excludes MAC padding and MAC checksum</td><td>T</td><td>R</td><td></td></tr><tr><td>/DFDF54</td><td>var</td><td>MAC KSN</td><td>B</td><td>R</td><td></td></tr><tr><td>/DFDF55</td><td>var</td><td>MAC Encryption Type</td><td>B</td><td>R</td><td></td></tr><tr><td>/F8</td><td>var</td><td>Container for Encrypted Data</td><td>T</td><td>R</td><td></td></tr><tr><td>//DFDF59</td><td>var</td><td>Encrypted Data Primitive ( length includes padding) Decrypt the value of this TLV data object using the algorithm and variant specified in the Encrypted Data KSN parameter and the Encryption Type parameter below to read its contents.</td><td>B</td><td>R</td><td></td></tr><tr><td>//DFDF56</td><td>var</td><td>Encrypted Data KSN</td><td>B</td><td>R</td><td></td></tr><tr><td>//DFDF57</td><td>01</td><td>Encrypted Data Encryption Type See <strong>Encryption Type</strong> for a list of valid values.</td><td>B</td><td>R</td><td></td></tr><tr><td>PKCS7 padding for MAC calculation, maximum 16 bytes, minimum 1 byte</td><td></td><td></td><td></td><td></td><td></td></tr><tr><td>Four-byte MAC checksum. The host should calculate the MAC and verify that it matches.</td><td></td><td></td><td></td><td></td><td></td></tr></tbody></table>

## **Table SCF-3 - Encrypted Signature Capture File Type (after decryption)**

<table><thead><tr><th width="76">Tag</th><th width="78.66668701171875">Len</th><th>Value / Description</th><th width="75.33331298828125">Typ</th><th width="74.66668701171875">Req</th><th width="99">Default</th></tr></thead><tbody><tr><td>F9</td><td>var</td><td>Container for MAC structure and generic data, length excludes MAC padding and MAC checksum</td><td>T</td><td>R</td><td></td></tr><tr><td>/DFDF55</td><td>var</td><td>MAC Encryption Type</td><td>B</td><td>R</td><td></td></tr><tr><td>/F8</td><td>var</td><td>Container for Encrypted Data</td><td>T</td><td>R</td><td></td></tr><tr><td>//DFDF59</td><td>var</td><td>Encrypted Data Primitive, length includes padding</td><td>T</td><td>R</td><td></td></tr><tr><td>///FC</td><td>var</td><td>Decrypted Data Container, length excludes padding</td><td>T</td><td>R</td><td></td></tr><tr><td>////A1</td><td>var</td><td>Signature file container, maximum 4,000 bytes</td><td>T</td><td>R</td><td></td></tr><tr><td>/////81</td><td>08</td><td>Signature Window Width and Height, refer to <strong>Table SCF-1 - Signature Capture File Type.</strong></td><td>B</td><td>R</td><td></td></tr><tr><td>/////82</td><td>var</td><td>Signature Coordinate Values List, refer to <strong>Table SCF-1 - Signature Capture File Type.</strong></td><td>B</td><td>R</td><td></td></tr><tr><td>////81</td><td>04</td><td>Real Time Clock, Epoch Time in seconds, unsigned 32 bits. The date and time shall be Universal Time Coordinated (UTC).</td><td>B</td><td>R</td><td></td></tr><tr><td>////82</td><td>04</td><td>Device Serial Number</td><td>B</td><td>R</td><td></td></tr><tr><td>////A3</td><td>var</td><td>User data parameters for item #0 to item #3. The maximum total size of 0xA3 TLV is 4,000 bytes.</td><td>T</td><td>O</td><td></td></tr><tr><td>/////81</td><td>var</td><td>User data item #0, optional</td><td>B</td><td>O</td><td></td></tr><tr><td>/////82</td><td>var</td><td>User data item #1, optional</td><td>B</td><td>O</td><td></td></tr><tr><td>/////83</td><td>var</td><td>User data item #2, optional</td><td>B</td><td>O</td><td></td></tr><tr><td>/////84</td><td>var</td><td>User data item #3, optional</td><td>B</td><td>O</td><td></td></tr><tr><td>PKCS7 padding for encryption, maximum 16 bytes, minimum 1 byte</td><td></td><td></td><td></td><td></td><td></td></tr><tr><td>//DFDF56</td><td>var</td><td>Encrypted Data KSN</td><td>B</td><td>R</td><td></td></tr><tr><td>//DFDF57</td><td>01</td><td>Encrypted Data Encryption Type See <strong>Encryption Type</strong> for a list of valid values.</td><td>B</td><td>R</td><td></td></tr><tr><td>PKCS7 padding for MAC calculation, maximum 16 bytes, minimum 1 byte</td><td></td><td></td><td></td><td></td><td></td></tr><tr><td>Four-byte MAC checksum. The host should calculate the MAC and verify that it matches.</td><td></td><td></td><td></td><td></td><td></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developer.magtek.com/api-and-command-reference/scra-dynafamily-programmers-manual/data-types-and-shared-tlv-data-objects/signature-capture-file-type-touch-only.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.