ISO 8583 implementation reference

Data fields

Compare field containers in the pyiso8583 default and default_ascii starter profiles, including encoding, length prefixes and bitmap positions.

Accounts and participants

Named fields from pyiso8583 starter profiles. Reserved containers without defined content are excluded.
FieldProfile labelASCII container
2Primary Account Number (PAN)Up to 19 bytes
18Merchant Type4 bytes
19Acquiring Institution Country Code3 bytes
20PAN Country Code3 bytes
21Forwarding Institution Country Code3 bytes
23PAN Sequence Number3 bytes
32Acquiring Institution ID CodeUp to 11 bytes
33Forwarding Institution ID CodeUp to 11 bytes
34Primary Account Number, ExtendedUp to 28 bytes
37Retrieval Reference Number12 bytes
38Authorization ID Response6 bytes
40Service Restriction Code3 bytes
41Card Acceptor Terminal ID8 bytes
42Card Acceptor ID Code15 bytes
43Card Acceptor Name/Location40 bytes
98Payee25 bytes
99Settlement Institution ID CodeUp to 11 bytes
100Receiving Institution ID CodeUp to 11 bytes
102Account ID 1Up to 28 bytes
103Account ID 2Up to 28 bytes

Amounts and currencies

Named fields from pyiso8583 starter profiles. Reserved containers without defined content are excluded.
FieldProfile labelASCII container
4Amount, Transaction12 bytes
5Amount, Settlement12 bytes
6Amount, Cardholder Billing12 bytes
8Amount, Cardholder Billing Fee8 bytes
9Conversion Rate, Settlement8 bytes
10Conversion Rate, Cardholder Billing8 bytes
28Amount, Transaction Fee9 bytes
29Amount, Settlement Fee9 bytes
30Amount, Transaction Processing Fee9 bytes
31Amount, Settlement Processing Fee9 bytes
49Currency Code, Transaction3 bytes
50Currency Code, Settlement3 bytes
51Currency Code, Cardholder Billing3 bytes
54Additional AmountsUp to 240 bytes
82Credits, Processing Fee Amount12 bytes
83Credits, Transaction Fee Amount12 bytes
84Debits, Processing Fee Amount12 bytes
85Debits, Transaction Fee Amount12 bytes
86Credits, Amount16 bytes
87Credits, Reversal Amount16 bytes
88Debits, Amount16 bytes
89Debits, Reversal Amount16 bytes
95Replacement Amounts42 bytes
97Amount, Net Settlement17 bytes

Dates and times

Named fields from pyiso8583 starter profiles. Reserved containers without defined content are excluded.
FieldProfile labelASCII container
7Transmission Date and Time10 bytes
12Time, Local Transaction6 bytes
13Date, Local Transaction4 bytes
14Date, Expiration4 bytes
15Date, Settlement4 bytes
16Date, Conversion4 bytes
17Date, Capture4 bytes
73Date, Action6 bytes

Card and security data

Named fields from pyiso8583 starter profiles. Reserved containers without defined content are excluded.
FieldProfile labelASCII container
35Track 2 DataUp to 37 bytes
36Track 3 DataUp to 104 bytes
45Track 1 DataUp to 76 bytes
52PIN16 bytes
53Security related Control Information16 bytes
55ICC dataUp to 510 bytes
64MAC16 bytes
96Message Security Code16 bytes
128MAC16 bytes

Message control and reconciliation

Named fields from pyiso8583 starter profiles. Reserved containers without defined content are excluded.
FieldProfile labelASCII container
1Bitmap, Secondary16 bytes
3Processing Code6 bytes
11System Trace Audit Number6 bytes
22Point of service Entry Mode3 bytes
24Network International ID (NII)3 bytes
25Point of service Condition Code2 bytes
26Point of service Capture Code2 bytes
27Authorizing ID Response Length1 bytes
39Response Code2 bytes
44Additional Response DataUp to 25 bytes
46Additional Data · ISOUp to 999 bytes
47Additional Data · NationalUp to 999 bytes
48Additional Data · PrivateUp to 999 bytes
65Bitmap, Extended16 bytes
66Settlement Code1 bytes
67Extended Payment Code2 bytes
68Receiving Institution Country Code3 bytes
69Settlement Institution Country Code3 bytes
70Network Management Information Code3 bytes
71Message Number4 bytes
72Message Number, Last4 bytes
74Credits, Number10 bytes
75Credits, Reversal Number10 bytes
76Debits, Number10 bytes
77Debits, Reversal Number10 bytes
78Transfer, Number10 bytes
79Transfer, Reversal Number10 bytes
80Inquiries, Number10 bytes
81Authorizations, Number10 bytes
90Original Data Elements42 bytes
91File Update Code1 bytes
92File Security Code2 bytes
93Response Indicator5 bytes
94Service Indicator7 bytes
101File NameUp to 17 bytes
104Transaction DescriptionUp to 100 bytes
Source scope and interpretation

These are configurable starter profiles. Field labels, containers and lengths describe the selected profile, not a universal network contract or a complete code list.