store — Group 8, Code 80

Store value into a locker.

Purpose

store is the standard write path for placing coins into a locker. The PAN supplied here is the locker key the caller will use later for inspection, withdrawal, or sale flows.

Request layout

The request body is a stream of 37-byte per-coin records. The diagram below shows one record; offsets are relative to the start of each record.

DN 0 Serial Number (BE) 1 4 AN (bytes 0-2 of 16) 5 7 AN (bytes 3-10 of 16) 8 15 AN (bytes 11-15 of 16) 16 20 PAN (bytes 0-2 of 16) 21 23 PAN (bytes 3-10 of 16) — locker key, must end in FF FF FF FF 24 31 PAN (bytes 11-15 of 16) 32 36
Per-coin field Size
Denomination1 byte
Serial number4 bytes (big-endian)
AN (current)16 bytes
PAN (locker key)16 bytes

The live 80 store request uses 37 bytes per coin.

PAN suffix rule

The PAN must end in FF FF FF FF for the standard locker store path. This marker is what distinguishes a locker key from an ordinary PAN rotation.

Status codes

Expect 241 for all pass, 242 for all fail, and 243 when the body carries a mixed-result bitfield. See the authentication overview for the 241/242/243 response pattern shared with Group 1.