payShield host commands

Card & EMV

payShield KW — Verify ARQC / Generate ARPC (EMV SKD)

answers with KX

Verify an EMV ARQC and/or generate the ARPC. Scheme 2/3 = Option A/B card key + EMV Common SK; scheme 0/1 = Option A/B + EMV2000 SK (needs IV-AC and branch/height)

Fields

FieldWhat it holds
Scheme ID1 charsKW: 0/1 EMV2000, 2/3 EMV Common SK · KQ: 1 M/Chip
Mode1 chars0 verify · 1 verify+ARPC(M1) · 2 ARPC(M1) · 3 verify+ARPC(M2) · 4 ARPC(M2)
MK-AC under LMK32 or 97 or 129 charsS… key block (97/129 chars), or 32 hex under a variant LMK
IV-AC (HEX)32 chars32 hex (16 bytes) — EMV2000 schemes 0/1 only
Branch/Height1 chars0 (branch 2, height 16) or 1 (branch 4, height 8) — EMV2000 only
PAN12-19 digit card number
PAN Sequence Number2 chars00
ATC (HEX)4 chars4 hex chars (2 bytes)
Transaction Data (HEX)Concatenated EMV transaction data in hex (host adds any 0x80 padding)
ARQC (HEX)16 chars16 hex chars (8 bytes)
ARC (HEX)4 chars4 hex chars (2 bytes) — Method 1 ARPC
CSU (HEX)8 chars8 hex chars (4 bytes) — Method 2 ARPC
Proprietary Auth Data (HEX)optional, 0-16 hex (0-8 bytes) — KW Method 2 ARPC (CCD)

Worked values

Example values for each field. The key blocks work against the Thales test LMK the simulator ships with.

Scheme 2/3 — EMV Common SK (verify + Method 2 ARPC)
Scheme ID
3
Mode
3
MK-AC under LMK
S10096E0TX00N000012E905F155733E03B02AE8CE651EE849FC5023F815590ECD81B8412231A656AC2BE2CAF85F84352F
PAN
05878038067710
PAN Sequence Number
00
ATC (HEX)
0012
Transaction Data (HEX)
00000000730000000000000000760000040000098620051800443085D27900001201A031F800000080
ARQC (HEX)
437FCB1739272C7A
CSU (HEX)
00820000
Scheme 0/1 — EMV2000 SK (verify + Method 1 ARPC)
Scheme ID
0
Mode
1
MK-AC under LMK
S10096E0TN00N000093958BE965930B976EBAD02EF36855DF83CD58DE241264CA230A93427E7C9EB32515846EB1458B68
IV-AC (HEX)
00000000000000000000000000000000
Branch/Height
1
PAN
43219876543210
PAN Sequence Number
00
ATC (HEX)
0001
Transaction Data (HEX)
0000000018000000000000000076620004E0000986181127000C79A698580001D60FA501A030F8000000000000000000000F00000000000000000000000000000080000000000000
ARQC (HEX)
AA5DB3DF673A95D3
ARC (HEX)
0000
Open KW in the simulator

Card & EMV