ISO 8583 Data Element Reference
All 128 data elements of ISO 8583 — name, format, length, and usage. Click any element for a detail page with subfield breakdowns, example values, and the decoders that work with it. Network dialects (Visa, Mastercard) noted where they diverge from the 1987 base.
128 of 128 data elements
| DE | Name | Format | Length | Type |
|---|---|---|---|---|
| 1 | Secondary BitmapBitmap indicating the presence of data elements 65–128. Present only when any of those elements is used. | b | 8 | bitmap |
| 2 | Primary Account Number (PAN)The cardholder account number as embossed / encoded on the card — up to 19 digits, LLVAR. | n | ..19 | LLVAR |
| 3 | Processing CodeThree two-digit subfields: transaction type, account type debited ("from"), account type credited ("to"). | n | 6 | fixed |
| 4 | Amount, TransactionTransaction amount in the transaction currency (DE 49), right-justified, zero-padded, in minor units. | n | 12 | fixed |
| 5 | Amount, SettlementTransaction amount converted to the settlement currency (DE 50), used between network and members. | n | 12 | fixed |
| 6 | Amount, Cardholder BillingAmount in the cardholder billing currency (DE 51) after currency conversion at the rate in DE 10. | n | 12 | fixed |
| 7 | Transmission Date & TimeMMDDhhmmss in UTC/GMT — when the message entered the network. Used with DE 11 to match responses and reversals. | n | 10 | fixed |
| 8 | Amount, Cardholder Billing FeeFee charged to the cardholder in the billing currency (rarely used; superseded by DE 28-31 in most networks). | n | 8 | fixed |
| 9 | Conversion Rate, SettlementRate used to convert the transaction amount to the settlement amount. First digit is the decimal-shift exponent. | n | 8 | fixed |
| 10 | Conversion Rate, Cardholder BillingRate converting DE 4 into the cardholder billing amount (DE 6). First digit is the decimal-shift exponent. | n | 8 | fixed |
| 11 | System Trace Audit Number (STAN)Rolling per-message number assigned by the initiator, echoed in the response — the primary request/response matching key. | n | 6 | fixed |
| 12 | Time, Local Transactionhhmmss at the point of transaction, in local terminal time (contrast DE 7, which is UTC). | n | 6 | fixed |
| 13 | Date, Local TransactionMMDD at the point of transaction, local time. Combined with DE 12 for the local timestamp. | n | 4 | fixed |
| 14 | Date, ExpirationCard expiry as YYMM. Issuers validate it against the card record; absent when the acquirer cannot provide it. | n | 4 | fixed |
| 15 | Date, SettlementMMDD on which the transaction settles between members — set by the network. | n | 4 | fixed |
| 16 | Date, ConversionMMDD on which the currency conversion rate was applied. | n | 4 | fixed |
| 17 | Date, CaptureMMDD on which the transaction data was captured by the acquirer. | n | 4 | fixed |
| 18 | Merchant Type (MCC)ISO 18245 Merchant Category Code of the card acceptor — drives interchange, risk rules, and spend categorisation. | n | 4 | fixed |
| 19 | Acquiring Institution Country CodeISO 3166 numeric country code of the acquirer — basis for domestic vs cross-border qualification. | n | 3 | fixed |
| 20 | PAN Extended Country CodeCountry code of the card issuer derived from the extended PAN (rarely used). | n | 3 | fixed |
| 21 | Forwarding Institution Country CodeISO 3166 country code of the institution forwarding the message. | n | 3 | fixed |
| 22 | POS Entry ModeHow the PAN was captured (positions 1–2: keyed, magstripe, chip, contactless) and PIN capability (position 3). | n | 3 | fixed |
| 23 | Application PAN Sequence NumberDistinguishes multiple cards sharing one PAN (EMV tag 5F34 value) — e.g. primary and supplementary chips. | n | 3 | fixed |
| 24 | Network International IdentifierIdentifies the network on which the message travels (function code in later ISO 8583 versions). | n | 3 | fixed |
| 25 | POS Condition CodeCondition under which the transaction takes place: attended, unattended, e-commerce, MOTO, recurring. | n | 2 | fixed |
| 26 | POS PIN Capture CodeMaximum PIN length the terminal can capture. | n | 2 | fixed |
| 27 | Authorization ID Response LengthMaximum length of the authorization response the acquirer can handle. | n | 1 | fixed |
| 28 | Amount, Transaction FeeFee charged for the transaction, prefixed C (credit) or D (debit) — e.g. an ATM access fee. | x+n | 8 | fixed |
| 29 | Amount, Settlement FeeDE 28 fee converted to the settlement currency. | x+n | 8 | fixed |
| 30 | Amount, Transaction Processing FeeProcessing fee charged, C/D prefixed. Networks repurpose this range for interchange data. | x+n | 8 | fixed |
| 31 | Amount, Settlement Processing FeeDE 30 fee converted to the settlement currency. | x+n | 8 | fixed |
| 32 | Acquiring Institution Identification CodeIdentifies the acquirer (or its processor) that introduced the transaction into the network. | n | ..11 | LLVAR |
| 33 | Forwarding Institution Identification CodeIdentifies the institution forwarding the message when it is not the acquirer itself (e.g. a processor or gateway). | n | ..11 | LLVAR |
| 34 | PAN, ExtendedLegacy field for PANs that do not fit DE 2 conventions. Effectively unused in modern networks. | ns | ..28 | LLVAR |
| 35 | Track 2 DataMagnetic-stripe Track 2: PAN, separator, expiry, service code, and discretionary data (PVV/CVC1). | z | ..37 | LLVAR |
| 36 | Track 3 DataMagnetic-stripe Track 3 (ISO 4909) — historically used by some debit networks; effectively obsolete. | n | ...104 | LLLVAR |
| 37 | Retrieval Reference Number (RRN)Reference assigned by the acquirer to identify the transaction across its whole lifecycle — auth to clearing to dispute. | an | 12 | fixed |
| 38 | Authorization Identification ResponseThe approval code assigned by the issuer (or stand-in) for an approved transaction — printed on the receipt. | an | 6 | fixed |
| 39 | Response CodeThe action/result code of the request: 00 approved, 05 do not honor, 51 insufficient funds, 91 issuer unavailable… | an | 2 | fixed |
| 40 | Service Restriction CodeThe service code from the magnetic stripe / chip, carried standalone (also embedded in DE 35). | an | 3 | fixed |
| 41 | Card Acceptor Terminal IdentificationIdentifies the specific terminal (TID) at the merchant location. Key for reconciliation and fraud tracing. | ans | 8 | fixed |
| 42 | Card Acceptor Identification CodeThe merchant identifier (MID) assigned by the acquirer. Appears on statements and in dispute records. | ans | 15 | fixed |
| 43 | Card Acceptor Name / LocationMerchant name, city, and country in fixed subfields — the text that ends up on the cardholder statement. | ans | 40 | fixed |
| 44 | Additional Response DataSupplementary response information — AVS results, CVV2 results, and network-specific response detail. | an | ..25 | LLVAR |
| 45 | Track 1 DataMagnetic-stripe Track 1 (ISO 7813): format code, PAN, cardholder name, expiry, service code, discretionary data. | an | ..76 | LLVAR |
| 46 | Additional Data — ISOReserved for ISO-defined additional data. | an | ...999 | LLLVAR |
| 47 | Additional Data — NationalReserved for national-use additional data. | an | ...999 | LLLVAR |
| 48 | Additional Data — PrivateThe workhorse private field: networks pack TLV sub-elements here (Mastercard SE/SF data, Visa field 48 usage). | ans | ...999 | LLLVAR |
| 49 | Currency Code, TransactionISO 4217 numeric code of the currency of DE 4 — 840 USD, 978 EUR, 826 GBP. | n | 3 | fixed |
| 50 | Currency Code, SettlementISO 4217 code of the settlement currency (pairs with DE 5). | n | 3 | fixed |
| 51 | Currency Code, Cardholder BillingISO 4217 code of the cardholder billing currency (pairs with DE 6). | n | 3 | fixed |
| 52 | PIN DataThe encrypted PIN block (8 bytes), produced under the terminal PIN key — ISO 9564 formats 0/1/3/4. | b | 8 | fixed |
| 53 | Security Related Control InformationDescribes the PIN block format and key indices used to protect DE 52 (network-specific layouts). | n | 16 | fixed |
| 54 | Additional AmountsUp to six amount structures: account type, amount type, currency, C/D indicator, amount — balances, cashback, tips. | an | ..120 | LLVAR |
| 55 | ICC Data (EMV)The EMV TLV data of a chip transaction: cryptogram (9F26), AIP (82), TVR (95), unpredictable number, and the rest. | b | ...999 | LLLVAR |
| 56 | Reserved — ISOReserved for ISO use (later versions: original data elements for reversals). | ans | ...999 | LLLVAR |
| 57 | Reserved — NationalReserved for national use. Some networks: authorization life-cycle data. | ans | ...999 | LLLVAR |
| 58 | Reserved — NationalReserved for national use. | ans | ...999 | LLLVAR |
| 59 | Reserved — NationalReserved for national use. Visa: national POS geographic data. | ans | ...999 | LLLVAR |
| 60 | Reserved — Private (Advice/POS Data)Private use. Commonly: advice reason codes, batch/original data, or extended POS capability data by network. | ans | ...999 | LLLVAR |
| 61 | Reserved — Private (POS Data)Private use. Visa: POS data (cardholder-present, terminal attendance, etc.). Mastercard: POS data extension. | ans | ...999 | LLLVAR |
| 62 | Reserved — Private (Custom/Trace)Private use. Visa: custom payment service fields (transaction ID). Mastercard: intermediate network data. | ans | ...999 | LLLVAR |
| 63 | Reserved — Private (Network Data)Private use. Mastercard: network data / financial network code. Visa: SMS-related private usage. | ans | ...999 | LLLVAR |
| 64 | Message Authentication Code (MAC)MAC over the message content when only the primary bitmap is present — integrity protection between nodes. | b | 8 | fixed |
| 65 | Tertiary BitmapBitmap for data elements 129–192. Defined by the standard but essentially unused in production networks. | b | 8 | bitmap |
| 66 | Settlement CodeResult of a settlement request (0500/0510 messages). | n | 1 | fixed |
| 67 | Extended Payment CodeNumber of months for extended/installment payment. | n | 2 | fixed |
| 68 | Receiving Institution Country CodeISO 3166 country code of the receiving institution. | n | 3 | fixed |
| 69 | Settlement Institution Country CodeISO 3166 country code of the settlement institution. | n | 3 | fixed |
| 70 | Network Management Information CodePurpose of a 0800 network-management message: 001 sign-on, 002 sign-off, 101 key exchange, 301 echo test. | n | 3 | fixed |
| 71 | Message NumberSequential message number for batch transmission control. | n | 4 | fixed |
| 72 | Message Number, LastNumber of the final message in the current batch. | n | 4 | fixed |
| 73 | Date, ActionYYMMDD on which a requested action (e.g. file update) is to occur. | n | 6 | fixed |
| 74 | Credits, NumberReconciliation count of credit transactions processed. | n | 10 | fixed |
| 75 | Credits, Reversal NumberReconciliation count of credit reversals. | n | 10 | fixed |
| 76 | Debits, NumberReconciliation count of debit transactions processed. | n | 10 | fixed |
| 77 | Debits, Reversal NumberReconciliation count of debit reversals. | n | 10 | fixed |
| 78 | Transfers, NumberReconciliation count of transfer transactions. | n | 10 | fixed |
| 79 | Transfers, Reversal NumberReconciliation count of transfer reversals. | n | 10 | fixed |
| 80 | Inquiries, NumberReconciliation count of inquiry transactions. | n | 10 | fixed |
| 81 | Authorizations, NumberReconciliation count of authorization messages. | n | 10 | fixed |
| 82 | Credits, Processing Fee AmountReconciliation total of credit processing fees. | n | 12 | fixed |
| 83 | Credits, Transaction Fee AmountReconciliation total of credit transaction fees. | n | 12 | fixed |
| 84 | Debits, Processing Fee AmountReconciliation total of debit processing fees. | n | 12 | fixed |
| 85 | Debits, Transaction Fee AmountReconciliation total of debit transaction fees. | n | 12 | fixed |
| 86 | Credits, AmountReconciliation total value of credits. | n | 16 | fixed |
| 87 | Credits, Reversal AmountReconciliation total value of credit reversals. | n | 16 | fixed |
| 88 | Debits, AmountReconciliation total value of debits. | n | 16 | fixed |
| 89 | Debits, Reversal AmountReconciliation total value of debit reversals. | n | 16 | fixed |
| 90 | Original Data ElementsIdentifies the original transaction in reversals/adjustments: original MTI, STAN, timestamp, acquirer and forwarder IDs. | n | 42 | fixed |
| 91 | File Update CodeAction for file-update messages (0300): add, change, delete, inquiry. | an | 1 | fixed |
| 92 | File Security CodeSecurity code for file-update operations. | an | 2 | fixed |
| 93 | Response IndicatorIndicates the response routing for file actions. | an | 5 | fixed |
| 94 | Service IndicatorService indicator for file actions. | an | 7 | fixed |
| 95 | Replacement AmountsThe corrected amounts in partial reversals/completions: actual transaction and settlement amounts plus fee corrections. | an | 42 | fixed |
| 96 | Message Security CodeSecurity code for network management (e.g. key-exchange) messages. | b | 8 | fixed |
| 97 | Amount, Net SettlementNet settlement position, C/D prefixed — used in reconciliation (0500) messages. | x+n | 16 | fixed |
| 98 | PayeeIdentifies the payee in payment/transfer transactions. | ans | 25 | fixed |
| 99 | Settlement Institution Identification CodeIdentifies the institution at which settlement occurs. | n | ..11 | LLVAR |
| 100 | Receiving Institution Identification CodeIdentifies the institution the message should be routed to when it is not implied by the PAN — e.g. in transfers. | n | ..11 | LLVAR |
| 101 | File NameName of the file targeted by a file-update (0300) message — e.g. a negative/hot-card file. | ans | ..17 | LLVAR |
| 102 | Account Identification 1The "from" account in transfers and inquiries — account number or IBAN, per network convention. | ans | ..28 | LLVAR |
| 103 | Account Identification 2The "to" account in transfers — account number or IBAN, per network convention. | ans | ..28 | LLVAR |
| 104 | Transaction DescriptionFree-text description of the transaction, used in payment/transfer messages. | ans | ..100 | LLVAR |
| 105 | Reserved — ISOReserved for ISO use. | ans | ...999 | LLLVAR |
| 106 | Reserved — ISOReserved for ISO use. | ans | ...999 | LLLVAR |
| 107 | Reserved — ISOReserved for ISO use. | ans | ...999 | LLLVAR |
| 108 | Reserved — ISOReserved for ISO use. | ans | ...999 | LLLVAR |
| 109 | Reserved — ISOReserved for ISO use. | ans | ...999 | LLLVAR |
| 110 | Reserved — ISOReserved for ISO use. | ans | ...999 | LLLVAR |
| 111 | Reserved — ISOReserved for ISO use. | ans | ...999 | LLLVAR |
| 112 | Reserved — NationalReserved for national use. | ans | ...999 | LLLVAR |
| 113 | Reserved — NationalReserved for national use. | ans | ...999 | LLLVAR |
| 114 | Reserved — NationalReserved for national use. | ans | ...999 | LLLVAR |
| 115 | Reserved — NationalReserved for national use. | ans | ...999 | LLLVAR |
| 116 | Reserved — NationalReserved for national use. | ans | ...999 | LLLVAR |
| 117 | Reserved — NationalReserved for national use. | ans | ...999 | LLLVAR |
| 118 | Reserved — NationalReserved for national use. | ans | ...999 | LLLVAR |
| 119 | Reserved — NationalReserved for national use. | ans | ...999 | LLLVAR |
| 120 | Reserved — PrivatePrivate use. Mastercard: record data for file updates. Various switches: terminal address/extended data. | ans | ...999 | LLLVAR |
| 121 | Reserved — PrivatePrivate use. Mastercard: authorization system advice date and time. | ans | ...999 | LLLVAR |
| 122 | Reserved — PrivatePrivate use. Network-specific extensions. | ans | ...999 | LLLVAR |
| 123 | Reserved — PrivatePrivate use. Visa: verification data (address verification). Mastercard: receipt free text. | ans | ...999 | LLLVAR |
| 124 | Reserved — PrivatePrivate use. Mastercard: member-defined data. Visa: free-form / batch data. | ans | ...999 | LLLVAR |
| 125 | Reserved — PrivatePrivate use. Visa: supporting information (original message data for some services). | ans | ...999 | LLLVAR |
| 126 | Reserved — PrivatePrivate use. Visa: structured TLV field (e.g. token data, 3DS CAVV in some interfaces). Mastercard: switch private data. | ans | ...999 | LLLVAR |
| 127 | Reserved — PrivatePrivate use. Postilion and several switches: structured subfield container for routing and POS data. | ans | ...999 | LLLVAR |
| 128 | Message Authentication Code (MAC)MAC over the message content when a secondary bitmap is present — always the final element. | b | 8 | fixed |