ISO 8583 Message

Parse and build ISO 8583 messages in ASCII, BCD or EBCDIC, with field explanations and EMV field 55 decoding.

Learn: M1 ISO 8583

Message format

Encoding

ASCII (text message, hex bitmap)

ASCII with binary bitmap

Binary / BCD (packed)

EBCDIC (mainframe)

Custom

Header bytes to skip

E.g. 2 for a binary length prefix, 5 for a TPDU, 7 for both.

Message is given as

Encoding details

MTI

ASCII digits

BCD (packed)

EBCDIC digits

Bitmap

Binary (8 / 16 bytes)

Hex in ASCII (16 / 32 chars)

Hex in EBCDIC

Numeric fields

ASCII digits

BCD (packed)

EBCDIC digits

Length prefixes (LL / LLL)

ASCII digits

BCD (packed)

EBCDIC digits

Text fields (a / an / ans)

ASCII

EBCDIC

Binary fields (b: 52, 55, 64…)

Raw bytes

Hex characters

Odd-length BCD in LLVAR fields

Pad left with 0

Pad right with F

Field dictionary: ISO 8583:1987. Lengths count digits for numeric and track fields, characters for text, bytes for binary fields.

Parse

Build

Message (hex)

Parse

Load example

Fields

One per line: MTI=0200, then field=value

Values are written as the parser shows them: digits, text, or hex for binary fields (52, 55, 64…). Fixed numeric fields are zero-padded.

Build

Load example

Packed message

Message (hex)

Build to see the message

Field dictionary (ISO 8583:1987)

DE	Name	Format
002	Primary account number (PAN)	n ..19 (LLVAR)
003	Processing code	n 6
004	Amount, transaction	n 12
005	Amount, settlement	n 12
006	Amount, cardholder billing	n 12
007	Transmission date & time (MMDDhhmmss)	n 10
008	Amount, cardholder billing fee	n 8
009	Conversion rate, settlement	n 8
010	Conversion rate, cardholder billing	n 8
011	System trace audit number (STAN)	n 6
012	Time, local transaction (hhmmss)	n 6
013	Date, local transaction (MMDD)	n 4
014	Date, expiration (YYMM)	n 4
015	Date, settlement (MMDD)	n 4
016	Date, conversion (MMDD)	n 4
017	Date, capture (MMDD)	n 4
018	Merchant type (MCC)	n 4
019	Acquiring institution country code	n 3
020	PAN extended, country code	n 3
021	Forwarding institution country code	n 3
022	Point of service entry mode	n 3
023	Card sequence number	n 3
024	Network international identifier (NII)	n 3
025	Point of service condition code	n 2
026	Point of service PIN capture code	n 2
027	Authorization identification response length	n 1
028	Amount, transaction fee	x+n 9
029	Amount, settlement fee	x+n 9
030	Amount, transaction processing fee	x+n 9
031	Amount, settlement processing fee	x+n 9
032	Acquiring institution identification code	n ..11 (LLVAR)
033	Forwarding institution identification code	n ..11 (LLVAR)
034	PAN, extended	ns ..28 (LLVAR)
035	Track 2 data	z ..37 (LLVAR)
036	Track 3 data	z ..104 (LLLVAR)
037	Retrieval reference number	an 12
038	Authorization identification response	an 6
039	Response code	an 2
040	Service restriction code	an 3
041	Card acceptor terminal identification	ans 8
042	Card acceptor identification code	ans 15
043	Card acceptor name / location	ans 40
044	Additional response data	an ..25 (LLVAR)
045	Track 1 data	an ..76 (LLVAR)
046	Additional data — ISO	an ..999 (LLLVAR)
047	Additional data — national	an ..999 (LLLVAR)
048	Additional data — private	an ..999 (LLLVAR)
049	Currency code, transaction	n 3
050	Currency code, settlement	n 3
051	Currency code, cardholder billing	n 3
052	PIN data	b 8
053	Security related control information	n 16
054	Additional amounts	an ..120 (LLLVAR)
055	ICC data (EMV TLV)	b ..999 (LLLVAR)
056	Reserved ISO	ans ..999 (LLLVAR)
057	Reserved national	ans ..999 (LLLVAR)
058	Reserved national	ans ..999 (LLLVAR)
059	Reserved national	ans ..999 (LLLVAR)
060	Reserved national	ans ..999 (LLLVAR)
061	Reserved private	ans ..999 (LLLVAR)
062	Reserved private	ans ..999 (LLLVAR)
063	Reserved private	ans ..999 (LLLVAR)
064	Message authentication code (MAC)	b 8
065	Bitmap, extended	b 1
066	Settlement code	n 1
067	Extended payment code	n 2
068	Receiving institution country code	n 3
069	Settlement institution country code	n 3
070	Network management information code	n 3
071	Message number	n 4
072	Message number, last	n 4
073	Date, action (YYMMDD)	n 6
074	Credits, number	n 10
075	Credits, reversal number	n 10
076	Debits, number	n 10
077	Debits, reversal number	n 10
078	Transfer number	n 10
079	Transfer, reversal number	n 10
080	Inquiries number	n 10
081	Authorizations, number	n 10
082	Credits, processing fee amount	n 12
083	Credits, transaction fee amount	n 12
084	Debits, processing fee amount	n 12
085	Debits, transaction fee amount	n 12
086	Credits, amount	n 16
087	Credits, reversal amount	n 16
088	Debits, amount	n 16
089	Debits, reversal amount	n 16
090	Original data elements	n 42
091	File update code	an 1
092	File security code	an 2
093	Response indicator	an 5
094	Service indicator	an 7
095	Replacement amounts	an 42
096	Message security code	b 8
097	Amount, net settlement	x+n 17
098	Payee	ans 25
099	Settlement institution identification code	n ..11 (LLVAR)
100	Receiving institution identification code	n ..11 (LLVAR)
101	File name	ans ..17 (LLVAR)
102	Account identification 1	ans ..28 (LLVAR)
103	Account identification 2	ans ..28 (LLVAR)
104	Transaction description	ans ..100 (LLLVAR)
105	Reserved for ISO use	ans ..999 (LLLVAR)
106	Reserved for ISO use	ans ..999 (LLLVAR)
107	Reserved for ISO use	ans ..999 (LLLVAR)
108	Reserved for ISO use	ans ..999 (LLLVAR)
109	Reserved for ISO use	ans ..999 (LLLVAR)
110	Reserved for ISO use	ans ..999 (LLLVAR)
111	Reserved for ISO use	ans ..999 (LLLVAR)
112	Reserved for national use	ans ..999 (LLLVAR)
113	Reserved for national use	ans ..999 (LLLVAR)
114	Reserved for national use	ans ..999 (LLLVAR)
115	Reserved for national use	ans ..999 (LLLVAR)
116	Reserved for national use	ans ..999 (LLLVAR)
117	Reserved for national use	ans ..999 (LLLVAR)
118	Reserved for national use	ans ..999 (LLLVAR)
119	Reserved for national use	ans ..999 (LLLVAR)
120	Reserved for private use	ans ..999 (LLLVAR)
121	Reserved for private use	ans ..999 (LLLVAR)
122	Reserved for private use	ans ..999 (LLLVAR)
123	Reserved for private use	ans ..999 (LLLVAR)
124	Reserved for private use	ans ..999 (LLLVAR)
125	Reserved for private use	ans ..999 (LLLVAR)
126	Reserved for private use	ans ..999 (LLLVAR)
127	Reserved for private use	ans ..999 (LLLVAR)
128	Message authentication code (MAC)	b 8