payShield host commands

Data & MAC

payShield LS — Verify an HMAC

answers with LT

Verify a supplied HMAC against the message bytes. Local execution supports Key Block LMKs.

Fields

FieldWhat it holds
Hash identifierFF for a Key Block LMK
HMAC length (bytes)Four decimal digits, e.g. 0032 for SHA-256
HMAC to verifyHexadecimal byte pairs matching the HMAC length
HMAC key format04 for Key Block LMK, 00 for Variant LMK
HMAC key under LMKBare key block for format 04, encrypted bytes in hex for format 00
Message data (hex)Hexadecimal byte pairs. Leave empty for a zero-byte message.
Message trailerOptional · up to 32 printable ASCII characters.

On the wire

The four zeros are the message header. The device echoes them in its response.

Verify an HMAC

0000LSFF0032<198A607EB44BFBC69903A0F1CF2BBDC5BA0AA3F3D9AE3C1C7A3B1696A0B68CF7>04FFFF1012863HC00N0000414000D6511716C61BB166F2F2DFD653BA34E793ADCC267311119F1966003E2686D29E58E786F82689FDCC55445128E041F63015451C8CCE00008<4869205468657265>

4-char headercommand185 bytes of fields
Send LS to the simulator

Opens the simulator with this command already filled in.

Data & MAC