Prepare personalization data

The following section defines the list of data elements that shall be returned by Transit Issuer in getDigitalCardBundleData response, in order to build the digital card bundles.

Depending on the application technology, the list of elements differs.

EMV

Name	Format	Description	Example
acIssuerMasterKeyId	String	Identifier of the IMK that is derived to obtain ICC Master Keys used to compute application cryptograms.	"G0DB5.LIVE.IMK225563.IMKAC.01"
acDerivationKeyIndex	String	Derivation Key Index that identifes the IMK AC used to derive ICC Master Keys. This value is personalized into the digital card.	"01"
cardData	String	Encrypted cardData using JWE encryption as defined in Data Encryption. See format below.

Card Data

JSON object defined as follows:

JSON parameter name	Description	Sample value
pan	The PAN (Primary Account Number) value. Required	"4929403965000868"
exp	The card expiry date 'MMYY' format. Required	"1228"
panSequenceNumber	The PAN sequence number. Default value set to "01"	"03"
paymentAccountReference	The Payment Account Reference(PAR). The PAR Data is comprised of a 4 character BIN Controller Identifier assigned by EMVCo to Registered BIN Controllers followed by a unique 25 character value.	"512381D9F8E0629211E3949A08002"
initialAtc	Initial Application Transaction Counter value. Default value set to "0001"	"000A"

Sample payload:

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

PURE

The following data elements are to be provided when PURE application is used (not applicable to Apple)

Name	Format	Description	Example
lcIssuerMasterKeyId	String	Identifier of the IMK that is derived to obtain ICC Master Keys used to compute local CDCVM stamp cryptograms.	"G0DB5.LIVE.IMK225563.IMKAC.12"
lcDerivationKeyIndex	String	Derivation Key Index that identifes the IMK LC used to derive ICC Master Keys. This value is personalized into the digital card.	"04"

Calypso

Name	Format	Description	Example
applicationType	String	Indicates the type of Calypso application to personalize. 01 for Navigo 02 for Triangle 2/Hoplink 03 for AMC 00 for other Calypso applications	"00"
issuerKeyId	Hexa String	Issuer Key identifier (KIF KVC) Used for DGI 4101	"217E"
loadKeyId	Hexa String	Load Key identifier (KIF KVC) Used for DGI 4102	"277E"
validationKeyId	Hexa String	Validation Key identifier (KIF KVC) Used for DGI 4103	"307E"
signatureKey1Id	Hexa String	Key identifier (KIF KVC) that represents either: the signature with HSM key for applicationType ='02' or '03' or the signature Key #1 for applicationType ='01' Not applicable for applicationType = '00'	"EC15"
signatureKey2Id	Hexa String	Key identifier (KIF KVC) that represents either: the AES-CTR ciphering key for applicationType = '02' or '03' or the signature Key #2 for applicationType = '01' Not applicable for applicationType = '00'	"EC45"
signatureKey3Id	Hexa String	Key identifier (KIF KVC) that represents the PID generation key for applicationType = '03' Not applicable for applicationType = '00', '01' and '02'	"EC75"
signatureKey4Id	Hexa String	Key identifier (KIF KVC) that represents the PID signature key for applicationType = '03' Not applicable for applicationType = '00', '01' and '02'	"EC95"
dgixxxx	Hexa String (29 bytes)	Value of the DGI to personalize. 'xxxx' shall represent the DGI tag, e.g. dgi0903 is for DGI Tag = '0903'	"00000FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF"