# 3DS DOM elements

Below is a list of all DOM elements you can tag with `data-threeds` attributes so the 3DS SDK can find it. 

An example and more details are available in [**Step 2**](https://docs.payshield.ai/3dsecure2+/implementation-guidelines#2.-add-data-threeds-attributes) of the integration guide.

| Element           | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | Format                           | Required                              | Version |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------------------------- | ------- |
| pan               | Credit card number                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | String                           | Y                                     | 2.3     |
| month             | Expiration month                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | String - Two digits only         | Y                                     | 2.3     |
| year              | Expiration year                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | String - Two digits only         | Y                                     | 2.3     |
| shippingLine1     | First line of cardholder street address                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | String (max 50 characters)       | Amex only (recommended if applicable) | 2.3     |
| shippingLine2     | Second line of cardholder street address                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | String (max 50 characters)       | Amex only (recommended if applicable) | 2.3     |
| shippingLine3     | Third line of cardholder street address                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | String (max 50 characters)       | Amex only (recommended if applicable) | 2.3     |
| shippingPostCode  | Zip code / Postal code                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | String (max 16 characters)       | Amex only (recommended if applicable) | 2.3     |
| shippingCity      | City of cardholder address                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | String (max 50 characters)       | Amex only (recommended if applicable) | 2.3     |
| shippingState     | State of cardholder address                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | String  (max 3 characters)       | Amex only (recommended if applicable) | 2.3     |
| shippingCountry   | Country of cardholder address                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | String  (max 3 characters)       | Amex only (recommended if applicable) | 2.3     |
| billingLine1      | First line of cardholder street address                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | String (max 50 characters)       | No (strongly recommended)             | 2.3     |
| billingLine2      | Second line of cardholder street address                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | String (max 50 characters)       | No (strongly recommended)             | 2.3     |
| billingLine3      | Third line of cardholder street address                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | String (max 50 characters)       | No (strongly recommended)             | 2.3     |
| billingPostCode   | Zip code / Postal code                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | String (max 16 characters)       | No (strongly recommended)             | 2.3     |
| billingCity       | City of cardholder address                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | String (max 50 characters)       | No (strongly recommended)             | 2.3     |
| billingState      | State of cardholder address                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | String  (max 3 characters)       | No (strongly recommended)             | 2.3     |
| billingCountry    | Country of cardholder address                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | String (max 3 char)              | No (strongly recommended)             | 2.3     |
| email             | E-mail                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | String  (max 254 characters)     | No (strongly recommended)             | 2.3     |
| cardHolderName    | First name + Last name                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | String (min 2 max 45 characters) | Discover only (strongly recommended)  | 2.3     |
| currency          | ISO 4217 three-digit currency code. Must be one of the values set in 3ds merchant setting                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | String                           | No                                    | 2       |
| transType         | <p>Type of product being transacted:<br><strong>01</strong> = Goods / Service Purchase (default)<br><strong>03</strong> = Check Acceptance<br><strong>10</strong> = Account Funding<br><strong>11</strong> = Quasi-Cash Transaction<br><strong>28</strong> = Prepaid Activation and Load</p>                                                                                                                                                                                                                                                                                                                                                                                                                                          | String                           | No                                    | 2       |
| shipIndicator     | <p>Shipping method used to deliver goods:<br><strong>01</strong> = Ship to cardholder’s billing address</p><p><strong>02</strong> = Ship to another verified address on file with merchant</p><p><strong>03</strong> = Ship to address that is different than the cardholder’s billing address</p><p><strong>04</strong> = “Ship to Store” / Pick-up at local store (Store address shall be populated in shipping address fields)</p><p><strong>05</strong> = Digital goods (includes online services, electronic gift cards and redemption codes)<br><strong>06</strong> = Travel and Event tickets, not shipped<br><strong>07</strong> = Other (for example, Gaming, digital services not shipped, e-media subscriptions, etc.)</p> | String                           | Amex only                             | 2       |
| deliveryTimeFrame | <p>When would the goods be delivered:<br><strong>01</strong> = Electronic Delivery<br><strong>02</strong> = Same day shipping<br><strong>03</strong> = Overnight shipping<br><strong>04</strong> = Two-day or more shipping</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | String                           | Amex only                             | 2       |
| reorderItemsInd   | <p>Is the order new for the customer or it has been ordered before:<br><strong>01</strong> = First time ordered<br><strong>02</strong> = Reordered</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | String                           | Amex only                             | 2       |


---

# Agent Instructions: 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:

```
GET https://docs.payshield.ai/3dsecure2+/3ds-dom-elements.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.