Welcome to our new developer portal! Use the "Ask" button to chat with our AI Agent.

Samsung Pay personalization

The TSH is fully capable of personalizing an EMV application for Samsung Pay solution. Here is the set of data required from the TSP in the 'submitTokenData' operation.

PURE

Name
Format
Length
Description
Example

kek_label

ASCII string

max 64

Label of the key used for CMKs encryption. The value is defined during the key ceremony.

"G062C.TEST.SGKEK.KEK.01"

kek_kcv

Hexa string

6

KCV of the key used for CMK encryption.

"E95500"

dek_label

ASCII string

max 64

Label of the key used for Track2 Data ("track2_data") encryption. The value is defined during the key ceremony.

"G062C.TEST.SGDEK.MKDATA.01"

dek_kcv

Hexa string

6

KCV of the DEK key.

"50FE57"

track2_data

Hexa string

max 64

Track 2 Equivalent Data (max length is 19 bytes) Format in clear is:

  • Token PAN up to 19 digits: 'ppppppppppppppppppp'

  • 'D'

  • Expiry date: 'yymm'

  • Service code: 'sss'

  • (optional) Discretionary data (depending on PAN length)

  • 'F' (if needed to ensure whole byte) track2_data is padded with 80h + 00h..00h in order to reach encryption algorithm block size (ISO7816-4 padding) track2_data is ciphered under the DEK key using CBC mode. Encryption algorithm is defined during project setup.

"FAB7FF4EFE1989AC25EBBEC2ED72378BDA79D244B89F7F25"

cmk_ac

Hexa String

max 64

Value of the Application Cryptogram Card Master Key for proximity payment ciphered under the KEK key. Encryption algorithm is defined during project setup.

"F1452589A51C5E88FA451236A5C49687"

cmk_lc

Hexa String

max 64

Value of the Local CDCVM Card Master Key for proximity payment ciphered under the KEK key. Encryption algorithm is defined during project setup.

"F1452589A51C5E88FA451236A5C49688"

cmk_rp_ac

Hexa String

max 64

Value of the Application Cryptogram Card Master Key for remote payment ciphered under the KEK key. Encryption algorithm is defined during project setup.

"E5812624B11DE846AA452165C4C39154"

cmk_rp_lc

Hexa String

max 64

Value of the Local CDCVM Card Master Key for remote payment ciphered under the KEK key. Encryption algorithm is defined during project setup.

"F1452589A51C5E88FA451236A5C49688"

cmk_ac_kcv

Hexa string

6

KCV of the Application Cryptogram key.

"ABDEFF"

cmk_lc_kcv

Hexa string

6

KCV of the Local CDCVM Stamp key for proximity payment.

"123344"

cmk_rp_ac_kcv

Hexa string

6

KCV of the Remote Payment Application Cryptogram key.

"0345AD"

cmk_rp_lc_kcv

Hexa string

6

KCV of the Local CDCVM Stamp key for remote payment.

"123344"

cmk_ac_dki

Hexa string

2

DKI of the Application Cryptogram key.

"01"

cmk_rp_ac_dki

Hexa string

2

DKI of the RP Application Cryptogram key.

"03"

psn

Hexa string

2

PAN Sequence Number to personalize in the application.

"01"

par

ASCII bytes

58

Payment account reference.

"323352305041594D454E544143434F554E545245464552454E43455858" which represents "23R0PAYMENTACCOUNTREFERENCEXX"

app_preferred_name

ASCII bytes

max 16

Application preferred name

"4465626974" which represents "Debit"

Note1:

The data element name is case insensitive. For example, DEK_KCV and dek_kcv are equivalent

Note2:

Some data elements may be added or removed upon project configuration

Note3:

All KCVs described above are calculated by encrypting 8 bytes of 00h for 3DES keys or 16 bytes of 01h for AES keys with the related key using ECB mode. In both cases, the 3 high-order bytes shall be used as KCV.

Last updated

Was this helpful?