ISO 8583 Parser
🧭 Learn 📨 Messages ▾
ISO 8583 Parser (home)ISO 8583 Message BuilderISO 8583 Field DictionaryMTI DecoderISO 8583 Bitmap CalculatorDE39 Response Code LookupDE3 Processing Code DecoderDE22 POS Entry Mode DecoderTVR Decoder (Tag 95)
💳 EMV ▾
EMV TLV Tag LookupEMV AID LookupEMV TLV Parser (BER-TLV)CVM Results Decoder (Tag 9F34)AIP Decoder (Tag 82)TSI Decoder (Tag 9B)CVM List Decoder (Tag 8E)CID Decoder (Tag 9F27)ATC Decoder (Tag 9F36)IAD Decoder (Tag 9F10)
🗂 Files & codes ▾
Mastercard IPM File Parser (T112)Currency Codes and ExponentsMCC LookupHex / Dec / BCD ConverterHex Viewer (ASCII + EBCDIC)
🧰 Tools 📖 Articles 中文
online lookup

ISO 8583 Field Dictionary (DE 2 – DE 128)

Type a field number or a keyword and you have the entry: name, length type, length, data type, what the field is for, and — where the site has one — a value from a worked message. This is the same dictionary the parser on the home page uses.

126 entries, DE 2 to DE 128. A bare number goes straight to that field; anything else searches names and explanations in both languages.
Showing 126 of 126
DE 2PAN (Primary Account Number)LL · 19 · n
Cardholder's card number (primary account number).
example4000001234567899Test-range card number (LLVAR, prefix 16), Luhn-valid
DE 3Processing CodeFIX · 6 · n
Nature of the transaction; first 2 digits = transaction type (00 purchase / 01 cash …).
example000000Purchase, from the default account — decode any value in the DE3 decoder
DE 4Amount, TransactionFIX · 12 · n
Transaction amount, in the currency's minor units (e.g. cents), right-justified with leading zeros, no decimal point.
example0000000050005000 minor units; with DE49 = 840 (USD, 2 dp) → 50.00 USD
DE 5Amount, SettlementFIX · 12 · n
Amount at settlement.
DE 6Amount, Cardholder BillingFIX · 12 · n
Amount in the cardholder's billing currency.
DE 7Transmission Date & TimeFIX · 10 · n
Message transmission time (GMT) MMDDhhmmss.
example0810093021MMDDhhmmss, GMT: Aug 10, 09:30:21
DE 8Billing Fee AmountFIX · 8 · n
Fee charged to the cardholder.
DE 9Settlement Conversion RateFIX · 8 · n
Settlement currency conversion rate.
DE 10Billing Conversion RateFIX · 8 · n
Cardholder billing currency conversion rate.
DE 11STAN (System Trace Audit No.)FIX · 6 · n
System Trace Audit Number: uniquely identifies a transaction within a day; used for reconciliation, lookup, reversal matching.
example000123Trace number — the key used to match this request to its 0110
DE 12Local Transaction TimeFIX · 6 · n
Acquirer local time hhmmss.
example093021hhmmss at the acquirer
DE 13Local Transaction DateFIX · 4 · n
Acquirer local date MMDD.
example0810MMDD at the acquirer
DE 14Expiration DateFIX · 4 · n
Card expiration date YYMM.
example2812YYMM: December 2028 — matches the expiry inside Track 2
DE 15Settlement DateFIX · 4 · n
Date the transaction enters settlement.
DE 16Conversion DateFIX · 4 · n
Date of the FX rate used for conversion.
DE 17Capture DateFIX · 4 · n
Date the transaction was captured.
DE 18Merchant Category Code (MCC)FIX · 4 · n
Merchant Category Code (e.g. 5814 = fast food).
example5411Grocery stores / supermarkets
DE 19Acquiring Country CodeFIX · 3 · n
Country of the acquiring institution.
DE 20PAN Extended Country CodeFIX · 3 · n
Country of the primary account number.
DE 21Forwarding Country CodeFIX · 3 · n
Country of the forwarding institution.
DE 22POS Entry ModeFIX · 3 · n
POS entry mode: how card data was read — magstripe / chip / contactless / manual.
example90290 = full magstripe read; 2 = no PIN entry capability — see the DE22 decoder
DE 23Card Sequence NumberFIX · 3 · n
Sequence number distinguishing multiple cards on the same PAN.
example001First card issued under this PAN
DE 24Function Code / NIIFIX · 3 · n
Network-internal identifier / function code.
DE 25POS Condition CodeFIX · 2 · n
POS condition code: card-present / card-not-present / MOTO etc.
example00Normal card-present transaction
DE 26POS PIN Capture CodeFIX · 2 · n
Whether the POS terminal can accept a PIN.
DE 27Auth Response LengthFIX · 1 · n
Length of the authorization response data.
DE 28Transaction FeeFIX · 9 · x+n
Transaction fee, prefixed with a debit/credit indicator.
DE 29Settlement FeeFIX · 9 · x+n
No plain-language note yet — name, format and length above are the definition.
DE 30Transaction Processing FeeFIX · 9 · x+n
No plain-language note yet — name, format and length above are the definition.
DE 31Settlement Processing FeeFIX · 9 · x+n
No plain-language note yet — name, format and length above are the definition.
DE 32Acquiring Institution IDLL · 11 · n
Acquiring institution identification code.
example424242The ATM owner's institution (LLVAR, prefix 06) — reappears inside DE90 of the reversal
DE 33Forwarding Institution IDLL · 11 · n
Forwarding institution identification code.
DE 34PAN ExtendedLL · 28 · ns
Extended primary account number.
DE 35Track 2 DataLL · 37 · z
Magnetic stripe track 2 (PAN + expiry + service code).
example4000001234567899=2812101123450000PAN = expiry (2812) + service code (101) + discretionary data; LLVAR, prefix 33
DE 36Track 3 DataLLL · 104 · z
Magnetic stripe track 3.
DE 37Retrieval Reference Number (RRN)FIX · 12 · an
Retrieval Reference Number: tracks the same transaction across systems; used for refunds/queries.
example622209000123Retrieval reference number. A common (not mandated) recipe: Julian date 6222 (2026, day 222) + hour 09 + STAN
DE 38Authorization ID ResponseFIX · 6 · an
Authorization code returned by the issuer on approval.
example654321Approval code assigned by the issuer
DE 39Response CodeFIX · 2 · an
Transaction result: 00 = approved, others are decline reasons.
example00Approved — every other value is a decline reason; see the DE39 lookup
DE 40Service Restriction CodeFIX · 3 · an
Service restriction code.
DE 41Terminal IDFIX · 8 · ans
Acquiring terminal (POS/ATM) ID.
exampleTERM0001Placeholder terminal
DE 42Merchant IDFIX · 15 · ans
Acquiring merchant ID.
exampleTESTMERCH000001Placeholder merchant, 15 chars fixed
DE 43Merchant Name / LocationFIX · 40 · ans
Merchant name, city and country.
DE 44Additional Response DataLL · 25 · an
Additional response data.
DE 45Track 1 DataLL · 76 · an
Magnetic stripe track 1.
DE 46Additional Data (ISO)LLL · 999 · an
No plain-language note yet — name, format and length above are the definition.
DE 47Additional Data (National)LLL · 999 · an
No plain-language note yet — name, format and length above are the definition.
DE 48Additional Data (Private)LLL · 999 · an
Private additional data, scheme-specific (may contain subfields/TLV).
DE 49Currency Code, TransactionFIX · 3 · n
Currency of the transaction amount (ISO 4217 numeric; sets the decimal places).
example840USD — this is what gives DE4 its decimal point
DE 50Currency Code, SettlementFIX · 3 · n
Currency of the settlement amount.
DE 51Currency Code, BillingFIX · 3 · n
Currency of the cardholder billing amount.
DE 52PIN Data (PIN Block)FIX · 16 · b
Encrypted PIN block.
example9A8B7C6D5E4F32108-byte encrypted PIN block, shown as 16 hex chars — synthetic, decrypts to nothing
DE 53Security Control InfoFIX · 16 · n
Security-related control information.
DE 54Additional AmountsLLL · 120 · an
Additional amounts, such as available balance or tip.
example1002840C000000098500Available balance 985.00 USD (LLLVAR, prefix 020)
DE 55ICC / EMV DataLLL · 999 · b
Chip-card (EMV) data in TLV format: ARQC, TVR, issuer data, etc.
example82023C00950500000480009A032608109C01005F2A0208409F02060000000025009F100706010A03A000009F1A0208409F2608A1B2C3D4E5F607189F2701809F3303E0F8C89F34030200009F3602003C9F37041A2B3C4DBER-TLV, decoded below. LLLVAR prefix here is 174 — hex characters, not bytes (see encoding note)
DE 56Reserved (ISO)LLL · 999 · ans
Reserved (ISO).
DE 57Reserved (National)LLL · 999 · ans
No plain-language note yet — name, format and length above are the definition.
DE 58Reserved (National)LLL · 999 · ans
No plain-language note yet — name, format and length above are the definition.
DE 59Reserved (National)LLL · 999 · ans
No plain-language note yet — name, format and length above are the definition.
DE 60Reserved (Private)LLL · 999 · ans
Private field; commonly carries batch, POS or system information.
DE 61Reserved (Private)LLL · 999 · ans
Private field, defined by each card scheme.
DE 62Reserved (Private)LLL · 999 · ans
Private field, defined by each card scheme.
DE 63Reserved (Private)LLL · 999 · ans
Private field / network data.
DE 64MACFIX · 16 · b
Message Authentication Code: verifies message integrity / anti-tamper.
DE 66Settlement CodeFIX · 1 · n
No plain-language note yet — name, format and length above are the definition.
DE 67Extended Payment CodeFIX · 2 · n
No plain-language note yet — name, format and length above are the definition.
DE 68Receiving Country CodeFIX · 3 · n
No plain-language note yet — name, format and length above are the definition.
DE 69Settlement Country CodeFIX · 3 · n
No plain-language note yet — name, format and length above are the definition.
DE 70Network Mgmt Info CodeFIX · 3 · n
Network management info code (sign-on/off, key exchange).
example301Echo test; 001 = sign-on, 002 = sign-off, 101 = key change
DE 71Message NumberFIX · 4 · n
No plain-language note yet — name, format and length above are the definition.
DE 72Message Number LastFIX · 4 · n
No plain-language note yet — name, format and length above are the definition.
DE 73Action DateFIX · 6 · n
No plain-language note yet — name, format and length above are the definition.
DE 74Credits NumberFIX · 10 · n
No plain-language note yet — name, format and length above are the definition.
DE 75Credits Reversal NumberFIX · 10 · n
No plain-language note yet — name, format and length above are the definition.
DE 76Debits NumberFIX · 10 · n
No plain-language note yet — name, format and length above are the definition.
DE 77Debits Reversal NumberFIX · 10 · n
No plain-language note yet — name, format and length above are the definition.
DE 78Transfer NumberFIX · 10 · n
No plain-language note yet — name, format and length above are the definition.
DE 79Transfer Reversal NumberFIX · 10 · n
No plain-language note yet — name, format and length above are the definition.
DE 80Inquiries NumberFIX · 10 · n
No plain-language note yet — name, format and length above are the definition.
DE 81Authorizations NumberFIX · 10 · n
No plain-language note yet — name, format and length above are the definition.
DE 82Credits Processing FeeFIX · 12 · n
No plain-language note yet — name, format and length above are the definition.
DE 83Credits Transaction FeeFIX · 12 · n
No plain-language note yet — name, format and length above are the definition.
DE 84Debits Processing FeeFIX · 12 · n
No plain-language note yet — name, format and length above are the definition.
DE 85Debits Transaction FeeFIX · 12 · n
No plain-language note yet — name, format and length above are the definition.
DE 86Credits AmountFIX · 16 · n
No plain-language note yet — name, format and length above are the definition.
DE 87Credits Reversal AmountFIX · 16 · n
No plain-language note yet — name, format and length above are the definition.
DE 88Debits AmountFIX · 16 · n
No plain-language note yet — name, format and length above are the definition.
DE 89Debits Reversal AmountFIX · 16 · n
No plain-language note yet — name, format and length above are the definition.
DE 90Original Data ElementsFIX · 42 · n
Key fields of the original transaction, referenced on reversals and refunds.
example02000001240810093045000004242420000000000042 digits, five packed subfields — broken out below
DE 91File Update CodeFIX · 1 · an
No plain-language note yet — name, format and length above are the definition.
DE 92File Security CodeFIX · 2 · an
No plain-language note yet — name, format and length above are the definition.
DE 93Response IndicatorFIX · 5 · an
No plain-language note yet — name, format and length above are the definition.
DE 94Service IndicatorFIX · 7 · an
No plain-language note yet — name, format and length above are the definition.
DE 95Replacement AmountsFIX · 42 · an
Replacement amounts.
DE 96Message Security CodeFIX · 16 · b
No plain-language note yet — name, format and length above are the definition.
DE 97Net Settlement AmountFIX · 17 · x+n
No plain-language note yet — name, format and length above are the definition.
DE 98PayeeFIX · 25 · ans
No plain-language note yet — name, format and length above are the definition.
DE 99Settlement Institution IDLL · 11 · n
No plain-language note yet — name, format and length above are the definition.
DE 100Receiving Institution IDLL · 11 · n
No plain-language note yet — name, format and length above are the definition.
DE 101File NameLL · 17 · ans
No plain-language note yet — name, format and length above are the definition.
DE 102Account Identification 1LL · 28 · ans
Account identification 1 (for example the account number).
DE 103Account Identification 2LL · 28 · ans
Account identification 2 (the credit / destination account).
DE 104Transaction DescriptionLLL · 100 · ans
Transaction description.
DE 105Reserved (ISO)LLL · 999 · ans
No plain-language note yet — name, format and length above are the definition.
DE 106Reserved (ISO)LLL · 999 · ans
No plain-language note yet — name, format and length above are the definition.
DE 107Reserved (ISO)LLL · 999 · ans
No plain-language note yet — name, format and length above are the definition.
DE 108Reserved (ISO)LLL · 999 · ans
No plain-language note yet — name, format and length above are the definition.
DE 109Reserved (ISO)LLL · 999 · ans
No plain-language note yet — name, format and length above are the definition.
DE 110Reserved (ISO)LLL · 999 · ans
No plain-language note yet — name, format and length above are the definition.
DE 111Reserved (ISO)LLL · 999 · ans
No plain-language note yet — name, format and length above are the definition.
DE 112Reserved (National)LLL · 999 · ans
No plain-language note yet — name, format and length above are the definition.
DE 113Reserved (National)LLL · 999 · ans
No plain-language note yet — name, format and length above are the definition.
DE 114Reserved (National)LLL · 999 · ans
No plain-language note yet — name, format and length above are the definition.
DE 115Reserved (National)LLL · 999 · ans
No plain-language note yet — name, format and length above are the definition.
DE 116Reserved (National)LLL · 999 · ans
No plain-language note yet — name, format and length above are the definition.
DE 117Reserved (National)LLL · 999 · ans
No plain-language note yet — name, format and length above are the definition.
DE 118Reserved (National)LLL · 999 · ans
No plain-language note yet — name, format and length above are the definition.
DE 119Reserved (National)LLL · 999 · ans
No plain-language note yet — name, format and length above are the definition.
DE 120Reserved (Private)LLL · 999 · ans
No plain-language note yet — name, format and length above are the definition.
DE 121Reserved (Private)LLL · 999 · ans
No plain-language note yet — name, format and length above are the definition.
DE 122Reserved (Private)LLL · 999 · ans
No plain-language note yet — name, format and length above are the definition.
DE 123Reserved (Private)LLL · 999 · ans
No plain-language note yet — name, format and length above are the definition.
DE 124Reserved (Private)LLL · 999 · ans
No plain-language note yet — name, format and length above are the definition.
DE 125Reserved (Private)LLL · 999 · ans
No plain-language note yet — name, format and length above are the definition.
DE 126Reserved (Private)LLL · 999 · ans
No plain-language note yet — name, format and length above are the definition.
DE 127Reserved (Private)LLL · 999 · ans
No plain-language note yet — name, format and length above are the definition.
DE 128MACFIX · 16 · b
Message Authentication Code (secondary).

How to read the format line

Every entry carries the same three-part line: length type · length · data type. So LL · 19 · n on DE 2 reads "two-digit length prefix, at most 19 characters, digits only".

TokenWhat it means
FIXFixed length. The number is exactly how many characters the field occupies.
LLVariable length behind a two-digit length prefix. The number is the maximum.
LLLVariable length behind a three-digit length prefix. The number is the maximum.
nDigits only.
anLetters and digits.
ansLetters, digits and special characters.
nsDigits and special characters.
bBinary, written here as hexadecimal characters.
zTrack 2 / track 3 as encoded on the magnetic stripe.
x+nA leading C or D (credit or debit) followed by digits.

One thing worth knowing about the length: it counts characters in the message as the parser reads it, not bits. DE 52 shows FIX · 16 · b because the PIN block arrives as 16 hexadecimal characters; the ISO specification writes the same field as b 64, counting bits. Same field, two ways of counting. The notation in full covers the n..19 style you will meet in scheme specifications.

Why DE 1 and DE 65 are not entries

Bit 1 and bit 65 are not data elements. Bit 1 set means a secondary bitmap follows; bit 65 set means a tertiary bitmap follows. Nothing is read out of the message for either, so there is no name, length or format to give. That is why the list holds 126 entries — DE 2 through DE 128, minus DE 65. If you want to see which bits are on in a bitmap you have in front of you, the bitmap calculator does that.

The fields your counterparty defines, not ISO

DE 48, DE 60 to DE 63, and DE 120 to DE 127 are reserved for private use, and DE 56 to DE 59 and DE 112 to DE 119 are reserved for ISO or national use. The names in this dictionary are the ISO 8583:1987 baseline. Visa, Mastercard, UnionPay, Amex, JCB and Discover all put their own content in those positions — pick a scheme on the parser and it renames them accordingly. For anything you are actually building against, your counterparty's current specification is what decides.

Where the examples come from

Every example value here is lifted from the messages taken apart field by field in ISO 8583 message examples: an authorization pair, a financial pair, a reversal with DE 90, an echo test, and a chip transaction with DE 55. The data is synthetic — reserved test card ranges, placeholder terminal and merchant IDs.

Fields that do not appear in those messages have no example. That is deliberate: a plausible invented value is worse than a blank one when the person reading is holding a production message next to the screen.

© ISO 8583 Parser · Tools · Articles · About · Contact · Privacy · Terms · Refund · chenshiwei509@gmail.com