> For the complete documentation index, see [llms.txt](https://docs.payments.thalescloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payments.thalescloud.io/transit-digitization/es/integrar-la-api-de-d1-transit/preparar-datos-de-personalizacion.md).

# Preparar datos de personalización

La siguiente sección define la lista de elementos de datos que Transit Issuer deberá devolver en la respuesta getDigitalCardBundleData, con el fin de construir los paquetes de tarjeta digital.

Dependiendo de la tecnología de la aplicación, la lista de elementos difiere.

### EMV <a href="#emv" id="emv"></a>

| Nombre               | Formato | Descripción                                                                                                                                             | Ejemplo                         |
| -------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- |
| acIssuerMasterKeyId  | Cadena  | Identificador de la IMK que se deriva para obtener las claves maestras ICC usadas para calcular criptogramas de aplicación.                             | "G0DB5.LIVE.IMK225563.IMKAC.01" |
| acDerivationKeyIndex | Cadena  | Índice de clave de derivación que identifica la IMK AC utilizada para derivar las claves maestras ICC. Este valor se personaliza en la tarjeta digital. | "01"                            |
| cardData             | Cadena  | <p>cardData cifrado mediante cifrado JWE como se define en Cifrado de datos.<br>Véase el formato a continuación.</p>                                    |                                 |

#### Datos de la tarjeta <a href="#pure" id="pure"></a>

Objeto JSON definido de la siguiente manera:

| Nombre del parámetro JSON | Descripción                                                                                                                                                                                                                          | Valor de ejemplo                |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------- |
| pan                       | <p>El valor del PAN (Número de Cuenta Primario).</p><p><strong>Obligatorio</strong><br></p>                                                                                                                                          | "4929403965000868"              |
| exp                       | <p>La fecha de caducidad de la tarjeta en formato 'MMYY'.<br><strong>Obligatorio</strong></p>                                                                                                                                        | "1228"                          |
| panSequenceNumber         | <p>El número de secuencia del PAN.<br>Valor predeterminado establecido en "01"</p>                                                                                                                                                   | "03"                            |
| paymentAccountReference   | <p>La Referencia de Cuenta de Pago (PAR).</p><p>Los datos PAR constan de un identificador de controlador BIN de 4 caracteres asignado por EMVCo a los controladores BIN registrados, seguido de un valor único de 25 caracteres.</p> | "512381D9F8E0629211E3949A08002" |
| initialAtc                | <p>Valor inicial del Contador de Transacciones de la Aplicación.<br>Valor predeterminado establecido en "0001"</p>                                                                                                                   | "000A"                          |

Carga de ejemplo:

```json
{
  "pan": "4929403965000868",
  "exp": "1228",
  "panSequenceNumber": "01",
  "paymentAccountReference": "512381D9F8E0629211E3949A08002",
  "initialAtc": "0001"
}
```

#### PURE <a href="#pure" id="pure"></a>

Los siguientes elementos de datos deben proporcionarse, además, cuando se utilice la aplicación PURE (no aplicable a Apple)

| Nombre               | Formato | Descripción                                                                                                                                             | Ejemplo                         |
| -------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- |
| lcIssuerMasterKeyId  | Cadena  | Identificador de la IMK que se deriva para obtener las claves maestras ICC usadas para calcular criptogramas de sello CDCVM local.                      | "G0DB5.LIVE.IMK225563.IMKAC.12" |
| lcDerivationKeyIndex | Cadena  | Índice de clave de derivación que identifica la IMK LC utilizada para derivar las claves maestras ICC. Este valor se personaliza en la tarjeta digital. | "04"                            |

### Calypso <a href="#calypso" id="calypso"></a>

| Nombre          | Formato                       | Descripción                                                                                                                                                                                                                                                                    | Ejemplo                                                      |
| --------------- | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------ |
| applicationType | Cadena                        | <p>Indica el tipo de aplicación Calypso que se va a personalizar.</p><ul><li>01 para Navigo</li><li>02 para Triangle 2/Hoplink</li><li>03 para AMC</li><li>00 para otras aplicaciones Calypso</li></ul>                                                                        | "00"                                                         |
| issuerKeyId     | Cadena hexadecimal            | <p>Identificador de clave del emisor (KIF KVC)<br>Usado para DGI 4101</p>                                                                                                                                                                                                      | "217E"                                                       |
| loadKeyId       | Cadena hexadecimal            | <p>Identificador de clave de carga (KIF KVC)<br>Usado para DGI 4102</p>                                                                                                                                                                                                        | "277E"                                                       |
| validationKeyId | Cadena hexadecimal            | <p>Identificador de clave de validación (KIF KVC)<br>Usado para DGI 4103</p>                                                                                                                                                                                                   | "307E"                                                       |
| signatureKey1Id | Cadena hexadecimal            | <p>Identificador de clave (KIF KVC) que representa cualquiera de los siguientes:</p><ul><li>la firma con clave HSM para applicationType ='02' o '03'</li><li>o la clave de firma #1 para applicationType ='01'</li></ul><p>No aplicable para applicationType = '00'</p>        | "EC15"                                                       |
| signatureKey2Id | Cadena hexadecimal            | <p>Identificador de clave (KIF KVC) que representa cualquiera de los siguientes:</p><ul><li>la clave de cifrado AES-CTR para applicationType = '02' o '03'</li><li>o la clave de firma #2 para applicationType = '01'</li></ul><p>No aplicable para applicationType = '00'</p> | "EC45"                                                       |
| signatureKey3Id | Cadena hexadecimal            | <p>Identificador de clave (KIF KVC) que representa la clave de generación de PID para applicationType = '03'<br><br>No aplicable para applicationType = '00', '01' y '02'</p>                                                                                                  | "EC75"                                                       |
| signatureKey4Id | Cadena hexadecimal            | <p>Identificador de clave (KIF KVC) que representa la clave de firma PID para applicationType = '03'<br><br>No aplicable para applicationType = '00', '01' y '02'</p>                                                                                                          | "EC95"                                                       |
| dgixxxx         | Cadena hexadecimal (29 bytes) | <p>Valor del DGI a personalizar.<br>'xxxx' deberá representar la etiqueta DGI; por ejemplo, dgi0903 es para DGI Tag = '0903'</p>                                                                                                                                               | "00000FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF" |

<br>


---

# 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://docs.payments.thalescloud.io/transit-digitization/es/integrar-la-api-de-d1-transit/preparar-datos-de-personalizacion.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.