Application Group 0x05 - PAN Messages

Command 0x05::0x01 - Read PAN

The host uses this command to retrieve the Primary Account Number (PAN) of the last card it successfully read, regardless of the interface used to read the card. Generally the host would use this command in solutions that use an external Encrypting PIN Pad (EPP), to retrieve the PAN and provide it to the EPP so it can create a PIN block.

For the host to successfully retrieve the plaintext PAN using this command, the device must have determined the card matched one or more entries in the device’s PAN Whitelist (see Command 0x03::0x80 - Read PAN Whitelist / Account Data Whitelist). If the card does not match an entry in the whitelist, the PAN will be available in encrypted form, but only if oDynamo is currently paired with a Cryptera EPP. The EPP decrypts the PAN and uses it to form the encrypted PIN block. Otherwise the device returns 0x0000 in parameter C4 to indicate the PAN is not available.

After successful return of the PAN to the host or a timeout, the device erases the PAN from memory. For MSR transactions, the timeout for the host to follow up with the device to retrieve the PAN is 3 seconds. Because EMV transactions may require more time for the cardholder and operator to complete, the timeout for EMV transactions is 255 seconds. If a timeout occurred, the device returns 0x0000 in parameter C4 to indicate the requested item is not available.

Table - Message Structure for Command 0x05::0x01 - Read PAN

Tag	Len	Value(s) / Description
C0	01	01	Message Type Data Object (Tag C0) = 0x01 Command
C1	01	05	Application ID Data Object (Tag C1) = 0x05 PAN Messages
C2	01	01	Command ID Data Object (Tag C2) = 0x01 Request PAN

Table - Response to Command 0x05::0x01 - Read PAN

Tag	Len	Value(s) / Description
C0	01	02	Message Type Data Object (Tag C0) = 0x02 Response
C1	01	05	Application ID Data Object (Tag C1) = 0x05 PAN Messages
C2	01	01	Command ID Data Object (Tag C2) = 0x01 Request PAN
C3	01	00	Result Code Data Object (Tag C3) = 0x00 OK / Done or 0x11 = Timeout occurred.
C4	Calculated	Byte 0 PAN Status 0x00 = PAN is not in PAN Whitelist, can not be transferred 0x01 = PAN is in PAN whitelist, full PAN is available 0x02 = PAN is in PAN whitelist, 12 digits of PAN are available 0x03 = PAN is encrypted for use with paired Cryptera EPP Byte 1 PAN Length Bytes 2..n PAN Value (if available) If the PAN is encrypted, the value will be 16 bytes and can be used as the data portion of parameter P2 for the EPP command READPIN_EXT.