Skip to content
EMV Tools

Tools

ISO 8583 bitmap decoder

ISO 8583 is the message format used between terminals, acquirers, networks, and issuers. A message starts with its type and a bitmap, in which each bit says whether a data element (DE) is present: bit 2 is DE 2, bit 3 is DE 3, and so on. Bit 1 says that a secondary bitmap follows with fields 65 to 128.

Look at it when you read a raw message in a host log and need to know which fields follow, for example whether DE 55 with the chip data is present.

The result lists every present field with its name. The names follow ISO 8583:1987; networks redefine some fields, especially the national and private ones, so check your network specification.

Worked example: 72 34 05 41 28 C2 88 05 has bit 1 off, so there is no secondary bitmap. It lists 20 fields, among them DE 2 (PAN), DE 3 (processing code), DE 4 (amount), DE 35 (track 2 data), and DE 49 (currency code).

New to EMV? Read EMV in 5 minutes or browse the glossary

Everything runs in your browser. Nothing you enter leaves this page.

Enter 16 hex digits for the primary bitmap, or 32 to include the secondary bitmap.

Choose the data elements

Turn fields on or off to update the bitmap. Bit 1 turns on by itself when a field above 64 is on.

Primary bitmap, fields 2 to 64
Secondary bitmap, fields 65 to 128

Anatomy of an ISO 8583 message

Anatomy of an ISO 8583 messageAn ISO 8583 message starts with the message type indicator, then the primary bitmap, then the secondary bitmap when bit 1 of the primary bitmap is on, and then the data elements in field number order. The example is an authorization request with fields 2, 3, 4, 11, 22, 55, and 128.MTI4 digitsPrimary8 bytesSecondary8 bytesFieldsVariableDE 2DE 3DE 4DE 11DE 22DE 55DE 128
Message type indicator
The version, class, function, and origin of the message. 0100 is an authorization request from the acquirer in the 1987 version. Example: 0100
Primary bitmap
Bits 1 to 64. Each bit that is on says that the data element with that number is present. Bit 1 on says that a secondary bitmap follows. Example: F020040000000200
Secondary bitmap
Bits 65 to 128, present only when bit 1 of the primary bitmap is on. Example: 0000000000000001
Data elements
The fields whose bits are on, one after another in field number order. DE 55 carries the EMV chip data as TLV objects.

Data elements in the example

  • DE 2: Primary account number (PAN)
  • DE 3: Processing code
  • DE 4: Transaction amount
  • DE 11: System trace audit number (STAN)
  • DE 22: Point of service entry mode
  • DE 55: ICC data (EMV tags)
  • DE 128: Message authentication code (MAC)