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.
All 97 fields
No matching entries. Try another code or clear the filter.
Accounts and participants
| Field | Profile label | ASCII container |
|---|---|---|
2 | Primary Account Number (PAN) | Up to 19 bytes |
18 | Merchant Type | 4 bytes |
19 | Acquiring Institution Country Code | 3 bytes |
20 | PAN Country Code | 3 bytes |
21 | Forwarding Institution Country Code | 3 bytes |
23 | PAN Sequence Number | 3 bytes |
32 | Acquiring Institution ID Code | Up to 11 bytes |
33 | Forwarding Institution ID Code | Up to 11 bytes |
34 | Primary Account Number, Extended | Up to 28 bytes |
37 | Retrieval Reference Number | 12 bytes |
38 | Authorization ID Response | 6 bytes |
40 | Service Restriction Code | 3 bytes |
41 | Card Acceptor Terminal ID | 8 bytes |
42 | Card Acceptor ID Code | 15 bytes |
43 | Card Acceptor Name/Location | 40 bytes |
98 | Payee | 25 bytes |
99 | Settlement Institution ID Code | Up to 11 bytes |
100 | Receiving Institution ID Code | Up to 11 bytes |
102 | Account ID 1 | Up to 28 bytes |
103 | Account ID 2 | Up to 28 bytes |
Amounts and currencies
| Field | Profile label | ASCII container |
|---|---|---|
4 | Amount, Transaction | 12 bytes |
5 | Amount, Settlement | 12 bytes |
6 | Amount, Cardholder Billing | 12 bytes |
8 | Amount, Cardholder Billing Fee | 8 bytes |
9 | Conversion Rate, Settlement | 8 bytes |
10 | Conversion Rate, Cardholder Billing | 8 bytes |
28 | Amount, Transaction Fee | 9 bytes |
29 | Amount, Settlement Fee | 9 bytes |
30 | Amount, Transaction Processing Fee | 9 bytes |
31 | Amount, Settlement Processing Fee | 9 bytes |
49 | Currency Code, Transaction | 3 bytes |
50 | Currency Code, Settlement | 3 bytes |
51 | Currency Code, Cardholder Billing | 3 bytes |
54 | Additional Amounts | Up to 240 bytes |
82 | Credits, Processing Fee Amount | 12 bytes |
83 | Credits, Transaction Fee Amount | 12 bytes |
84 | Debits, Processing Fee Amount | 12 bytes |
85 | Debits, Transaction Fee Amount | 12 bytes |
86 | Credits, Amount | 16 bytes |
87 | Credits, Reversal Amount | 16 bytes |
88 | Debits, Amount | 16 bytes |
89 | Debits, Reversal Amount | 16 bytes |
95 | Replacement Amounts | 42 bytes |
97 | Amount, Net Settlement | 17 bytes |
Dates and times
| Field | Profile label | ASCII container |
|---|---|---|
7 | Transmission Date and Time | 10 bytes |
12 | Time, Local Transaction | 6 bytes |
13 | Date, Local Transaction | 4 bytes |
14 | Date, Expiration | 4 bytes |
15 | Date, Settlement | 4 bytes |
16 | Date, Conversion | 4 bytes |
17 | Date, Capture | 4 bytes |
73 | Date, Action | 6 bytes |
Card and security data
| Field | Profile label | ASCII container |
|---|---|---|
35 | Track 2 Data | Up to 37 bytes |
36 | Track 3 Data | Up to 104 bytes |
45 | Track 1 Data | Up to 76 bytes |
52 | PIN | 16 bytes |
53 | Security related Control Information | 16 bytes |
55 | ICC data | Up to 510 bytes |
64 | MAC | 16 bytes |
96 | Message Security Code | 16 bytes |
128 | MAC | 16 bytes |
Message control and reconciliation
| Field | Profile label | ASCII container |
|---|---|---|
1 | Bitmap, Secondary | 16 bytes |
3 | Processing Code | 6 bytes |
11 | System Trace Audit Number | 6 bytes |
22 | Point of service Entry Mode | 3 bytes |
24 | Network International ID (NII) | 3 bytes |
25 | Point of service Condition Code | 2 bytes |
26 | Point of service Capture Code | 2 bytes |
27 | Authorizing ID Response Length | 1 byte |
39 | Response Code | 2 bytes |
44 | Additional Response Data | Up to 25 bytes |
46 | Additional Data · ISO | Up to 999 bytes |
47 | Additional Data · National | Up to 999 bytes |
48 | Additional Data · Private | Up to 999 bytes |
65 | Bitmap, Extended | 16 bytes |
66 | Settlement Code | 1 byte |
67 | Extended Payment Code | 2 bytes |
68 | Receiving Institution Country Code | 3 bytes |
69 | Settlement Institution Country Code | 3 bytes |
70 | Network Management Information Code | 3 bytes |
71 | Message Number | 4 bytes |
72 | Message Number, Last | 4 bytes |
74 | Credits, Number | 10 bytes |
75 | Credits, Reversal Number | 10 bytes |
76 | Debits, Number | 10 bytes |
77 | Debits, Reversal Number | 10 bytes |
78 | Transfer, Number | 10 bytes |
79 | Transfer, Reversal Number | 10 bytes |
80 | Inquiries, Number | 10 bytes |
81 | Authorizations, Number | 10 bytes |
90 | Original Data Elements | 42 bytes |
91 | File Update Code | 1 byte |
92 | File Security Code | 2 bytes |
93 | Response Indicator | 5 bytes |
94 | Service Indicator | 7 bytes |
101 | File Name | Up to 17 bytes |
104 | Transaction Description | Up 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.