ISO 8583 Parser
payments · knowledge base

Credit Card & Payment Messaging

New here? The articles below are grouped by topic. If you would rather be told what to read first, follow the learning path → — the same articles put in order, with a tool to practise at every stage.

Complete reference tables

Full code tables you can search or quote — every value, in one page.

What Is ISO 8583? Structure, Fields and Code Tables
Start here: the MTI, the bitmap and the data elements, a full authorization request decoded field by field, and where every code table lives.
Freereferenceoverview
EBCDIC to ASCII Table (CP500), Packed BCD and ISO 8583 Encodings
The same value in three encodings, byte for byte — 0200 is 4 bytes in ASCII, 2 in packed BCD, 4 in EBCDIC — plus a full CP500 table and how to tell which one a dump uses.
FreereferenceEBCDIC
EMV AID List: RIDs, PIX Values and Partial Matching
Every well-established AID by scheme, plus why the terminal's 9F06 and the card's 4F can legitimately differ — and what "card not supported" usually means.
FreereferenceEMV
ISO 8583 Bitmaps: How to Read and Build One by Hand
Hex to field numbers and back, with the arithmetic spelled out — plus the secondary-bitmap mistake that silently invents fields 65–128.
Freereferencebitmap
ISO 8583 MTI Codes: The Complete Message Type List
Every message type indicator you will meet — 0100, 0200, 0400, 0800 and their responses — plus what each of the four digits means and the three pairs people mix up.
FreereferenceMTI
ISO 4217 Currency Codes: The Complete Numeric List
Every numeric currency code with its alpha code and minor units — 764 THB, 840 USD, 392 JPY — and why the exponent decides where DE 4's decimal point goes.
FreereferenceISO4217
MCC Codes: Merchant Category Codes by Industry
Merchant category codes grouped by trade, with what each one actually affects — issuer risk rules, cashback, and why a wrong MCC gets a transaction declined.
FreereferenceMCC
ISO 8583 Data Elements: Complete List of All 128 Fields
The field reference: DE2/3/4/11/37/39 and other high-frequency fields in one plain sentence each, the rest grouped by purpose — amounts, time, institutions, clearing — plus why reserved fields differ between networks.
📌 ReferenceFreefields
DE39 Response Codes: Full List
00 approved / 05 do not honor / 51 insufficient funds / 54 expired / 91 issuer down… each code's meaning, what to do, and soft-vs-hard declines.
FreereferenceDE39
ISO 8583 Processing Codes: The Full DE3 List
All DE3 transaction types and the from/to account digits — 000000 purchase, 010000 cash withdrawal.
FreereferenceDE3
POS Entry Mode Codes: The Full DE22 List
Every DE22 PAN entry mode code plus the PIN-capability digit — 05 chip, 80 fallback, 81 e-commerce.
FreereferenceDE22
EMV Tag Reference: All 66 DE55 Tags
Every EMV TLV tag you'll meet in DE55, grouped by purpose — with length, format, meaning, and how to read a tag byte that continues into the next one.
FreereferenceEMV

Message structure & flow

How a message is laid out, and what happens across its lifecycle.

Matching a Refund Back to Its Original Transaction: Five Candidate Keys
Nothing in a refund message says which purchase it reverses. DE38 approval code, DE37 RRN, DE31 acquirer reference data, Visa TID, Mastercard TLID — who generates each, what the rules guarantee, when each fails to match.
FreeReconciliationClearing
ISO 8583 Parse Failures: Two Root Causes and the Check Order
Libraries don't fail at parsing — they fail on the config you gave them. The six structural causes, the three silent ones that never raise an error, and what to rule out first.
FreedebuggingISO8583
UnionPay 8583 vs Standard ISO 8583: What's Public, What Isn't
"The UnionPay spec" is three different layers. Which one your question belongs to changes the answer — with the 1987 version anchor traced to published standards.
FreeschemesUnionPay
ISO 8583 Message Examples: 8 Annotated Messages You Can Parse
Authorization, financial, reversal, network management and a chip transaction with DE55 — each broken down field by field, and one click away from the parser.
FreeexamplesISO8583
Reading ISO 8583: MTI, Bitmaps & Data Elements
The lingua franca of card payments. What an MTI is, how to read the bitmap, what the 128 data elements do — practise with the parser on this site.
FreeISO8583message
Reading ISO 8583 Field Formats
What n 6, n ..19 and ans ...999 mean — and why the dot count is the length prefix.
Freereferenceformat
The Transaction Lifecycle: Authorization → Clearing → Settlement
Authorization, capture, clearing, settlement, refunds and chargebacks — the differences, explained once and for all.
Freebasicssettlement
Reversals, Timeouts & Repeats: The ISO 8583 Failure Paths
0400 or 0420? How to fill DE90, why DE95 carries the remainder not the difference, how a retry becomes a double charge, and how a lost reversal turns into an orphaned hold — with a production checklist.
Freereversaladvanced
0800 / 0810 Network Management: Sign-On, Echo Test and Key Exchange
The only messages on the link that carry no money — and the first thing you hit during certification. Why DE 70, not the MTI, is the real opcode.
FreeISO8583DE70
Partial Approval & DE 54: When the Approved Amount Isn't What You Asked For
The issuer approves 30.00 of a 50.00 sale. Response code 10, a rewritten DE 4, and how to cut DE 54 into its 20-character groups.
FreeISO8583DE54
STAN vs RRN?
STAN is a same-day trace number; RRN is a cross-system tracker.
Free1 minbasics
Why No Decimal Point in Amounts?
Amounts are integers in minor units; convert using the currency's decimals.
Free1 minbasics
Mastercard Authorization vs Clearing: Same Fact, Different Fields
0100 and 1240 use different dictionaries: DE22 subfields renamed, the MCC moves from DE18 to DE26, DE48 subelements become PDS tags — the publicly documented crosswalk.
FreeMastercardclearing
ISO 8583 vs ISO 20022: What Actually Changed for Cards
Not the same kind of standard. The cross-border cutover finished in November 2025 and never touched the acquirer-to-issuer path — which of your links moved, and which did not.
FreestandardsISO 20022
3-D Secure, ECI and the Liability Shift
Passing 3DS does not move liability — the authorization carrying the result does. Why Visa and Mastercard number ECI in opposite directions, and what to check when the outcome is wrong.
Free3-D Securee-commerce
DE7, DE12, DE13: Which Clock Each Time Field Is On
One is UTC by definition, the rest are local — and the field that says "local" never says which local. What you can and cannot derive from it.
Freefieldsreconciliation
Scheme Differences: Why "the Same" ISO 8583 Parses Differently
Encoding (BCD/EBCDIC), headers, bitmap count, private DE48/62/63/55 — where the scheme conventions differ.
Freeschemesintermediate

EMV chip transactions

The tags a chip returns, and what each one is telling you.

EMV Chip & DE55 Deep Dive: ARQC / TVR / CVM
Why chip cards are safer, what each EMV TLV tag in DE55 means, how the ARQC cryptogram is generated, and how TVR/CVM drive the authorization decision.
🔒 PremiumEMVadvanced
TVR Bits Explained: All 5 Bytes of EMV Tag 95
Every Terminal Verification Results bit, byte by byte — and why a set bit is not a decline.
FreereferenceEMV
AIP vs TVR vs TSI: Which EMV Tag Answers Which Question
Capability, process, result — what the card declared, what the terminal recorded, and what actually ran.
FreeEMVtag 82
ARQC vs TC vs AAC: Reading EMV Tag 9F27
Why a transaction can fail with DE 39 = 00 — the card returns AAC on the second GENERATE AC. Tag 9F27 bit by bit, with a worked trace.
FreeEMV9F27
How the Card Chooses PIN or Signature: Reading the CVM List (Tag 8E)
The rule-by-rule algorithm behind every PIN prompt — and how to answer "the receipt says PIN verified but I never entered one".
FreeEMVtag 8E
ATC (Tag 9F36): The Counter That Catches Cloned Cards
How the transaction counter makes every cryptogram single-use, how it pairs with 9F13 — and why a gap in the sequence is not fraud on its own.
FreeEMV9F36
IAD (Tag 9F10): The Field Every Reference Dismisses as "Proprietary"
Every tag manual stops at "proprietary data". How to actually cut an IAD apart — Visa 0/1/3 and M/Chip layouts, DKI, CVN, and the CVR.
FreeEMV9F10
EMV Glossary: ARQC / TVR / AIP / CVM…
The wall of chip-transaction acronyms, each in one line with its TLV tag — look them up while decoding DE55.
FreereferenceEMV

One point a minute

Short answers to the questions that come up constantly.