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

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	cardData cifrado mediante cifrado JWE como se define en Cifrado de datos. Véase el formato a continuación.

Datos de la tarjeta

Objeto JSON definido de la siguiente manera:

Nombre del parámetro JSON	Descripción	Valor de ejemplo
pan	El valor del PAN (Número de Cuenta Primario). Obligatorio	"4929403965000868"
exp	La fecha de caducidad de la tarjeta en formato 'MMYY'. Obligatorio	"1228"
panSequenceNumber	El número de secuencia del PAN. Valor predeterminado establecido en "01"	"03"
paymentAccountReference	La Referencia de Cuenta de Pago (PAR). 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.	"512381D9F8E0629211E3949A08002"
initialAtc	Valor inicial del Contador de Transacciones de la Aplicación. Valor predeterminado establecido en "0001"	"000A"

Carga de ejemplo:

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

PURE

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

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