🌐
ISO 8583 Reference roXSAKHARE · V2.46
🌐

roXSAKHARE ISO 8583

Complete data element reference for all transaction types. Click any transaction below to explore request and response fields.

🔐
0100 / 0110
Authorization
Request authorization from issuer before completing a transaction
📣
0120 / 0130
Auth Advice
Notify issuer of authorization result for forced or offline transactions
💳
0200 / 0210
Purchase / Financial
Real-time debit/credit. Account debited immediately upon approval
📋
0220 / 0230
Financial Advice
Advise host of completed financial transaction for offline capture
↩️
0420 / 0430
Reversal / Adjustment
Reverse or partially reverse a previously authorized or financial transaction
📊
0500 / 0510
Reconciliation
End-of-day settlement — acquirer reconciles totals with roXSAKHARE host
🔗
0800 / 0810
Network Management
Sign-on/off, PIN key exchange, echo test and working key changes
Field Requirement Legend
M Mandatory — must be present
C Conditional — required under specific conditions
O Optional — may be included
Key / Critical field
Message Flow
0100
Auth Request
0110
Auth Response
·
0120
Auth Advice
0130
Advice Response
Request MTI
0100
Authorization Request
Response MTI
0110
Authorization Response
Processing Code
Field 003
00=Purchase, 01=Withdraw, 20=Refund
Approval Field
Field 039
00 = Approved
0100 RequestAuthorization Request
0110 ResponseAuthorization Response
REQ0100 Authorization Request — Data Elements
— fieldsMTI: 0100
BitField NameTypeReqNotes
0.1Terminal Application Headerans 3CRequired for Terminal Processing platform merchants
0.2Message Type IDnP4MValue: 0100
0.3Primary Bit Mapb64MIndicates presence of fields 1–64
001Secondary Bit Mapb64CRequired if message includes fields 65–128
002Primary Account Number (PAN)LLd nP19CFor manually entered PAN; or Field 35/45. Contains token for card network tokens.
003Processing CodenP6M00=Purchase · 01=Withdrawal · 09=Balance · 20=Refund · 28=Deferred · 99=Admin
004Transaction AmountnP12MTransaction amount in currency minor units
005Settlement AmountnP12CIf transaction and settlement currencies differ
006Cardholder Billing AmountnP12CIf cardholder and settlement currencies differ
007Transmission Date and TimenP10MFormat: MMDDhhmmss
009Settlement Conversion RatenP8O
010Cardholder Billing Conversion RatenP8CIf cardholder and transaction currencies differ
011Systems Trace Audit Number (STAN)nP6MUnique trace number for message matching
012Local Transaction TimenP6MFormat: hhmmss
013Local Transaction DatenP4MFormat: MMDD
014Expiration DatenP4CRequired for key-entered transactions. Format: YYMM
015Settlement DatenP4OFormat: MMDD
016Conversion DatenP4CIf transaction and settlement currencies differ
017Capture DatenP4OFormat: MMDD
018Merchant Type (MCC)nP4MMerchant Category Code
019Acquiring Institution Country CodenP3CRequired if country code is not 840 (US)
022Point of Service Entry ModenP4CRequired for POS device transactions
023Card Sequence NumbernP3CFor key-entered or chip data
025Point of Service Condition CodenP2O
032Acquiring Institution ID CodeLLd nP11MAcquiring institution identifier
035Track II DataLLd nP37CFor machine-read cards. Either F35 or F45 required.
037Retrieval Reference Numbern12MUsed for transaction matching and retrieval
038Authorization Identification Responsean6OAuth code from previous response
041Card Acceptor Terminal IDans15MTerminal identifier at point of acceptance
042Card Acceptor Identificationans15CroXSAKHARE-assigned Merchant ID must go here
043Card Acceptor Name and Locationans40MMerchant name, city, state, country
045Track I DataLLL ans76CFor machine-read cards. Either F35 or F45 required.
048Additional Data (Private)LLL ans255CRequired for WIC inquiries
049Transaction Currency CodenP3MISO 4217 numeric code (840 = USD)
052Personal Identification Number Datab64CRequired if cardholder enters PIN
054Additional AmountsLLL ans120OContains balance, tip, cashback amounts
055Integrated Circuit Card (EMV) DataLLL nP999CRequired when EMV data is available from chip card
060Additional POS DataLLL ans999MTerminal type, entry capability, routing indicator
062Vantiv Transaction Data062.2 Terminal Seq# · 062.4 Acquiring Acronym · 062.6 Owner SettlementLLL ans999MroXSAKHARE-specific subfields; 8-byte bitmap follows length
100P2P Encryption DataLLL ans999CRequired for P2P-encrypted transactions only
115Terminal Specific DataLLLL ans9999CRequired for Terminal Processing platform
126Electronic Commerce/MOTO IndicatorLLL ans999CRequired for e-commerce transactions
M Mandatory
C Conditional
O Optional
Key field
RES0110 Authorization Response — Data Elements
— fieldsMTI: 0110
BitField NameTypeReqNotes
0.2Message Type IDnP4MValue: 0110
001Secondary Bit Mapb64CRequired if fields 65–128 present
002Primary Account Number (PAN)LLd nP19CCopied from 0100 if present
003Processing CodenP6MEchoed from request
004Transaction AmountnP12MCopied from 0100; may differ for partial approvals
007Transmission Date and TimenP10MFormat: MMDDhhmmss
011Systems Trace Audit Number (STAN)nP6MCopied from 0100
012Local Transaction TimenP6M
013Local Transaction DatenP4M
015Settlement DatenP4M
032Acquiring Institution ID CodeLLd nP11MCopied from 0100
037Retrieval Reference Numberan12MCopied from 0100
038Authorization Identification Responsean6CApproval code — present for approved transactions
039Response Codean2M00=Approved · 05=Declined · 51=Insufficient funds · 54=Expired card
041Card Acceptor Terminal IDans15M
044Additional Response DataLLL ans5CContains AVS result data if applicable
049Transaction Currency CodenP3MCopied from 0100
054Additional AmountsLLL ans120CBalance inquiry response — contains available/ledger balance
055Integrated Circuit Card (EMV) DataLLL nP999CReturned if EMV data present
060Additional POS DataLLL ans999M
062Vantiv Transaction Data062.2 STAN · 062.4 Acquiring Acronym · 062.5 Issuing AcronymLLL ans999MroXSAKHARE-specific subfields
M Mandatory
C Conditional
O Optional
Request MTI
0120
Auth Advice Request
Response MTI
0130
Auth Advice Response
Purpose
Forced/Offline
Notify issuer of completed auth
0120 Advice RequestAuthorization Advice
0130 Advice ResponseAuth Advice Response
REQ0120 Auth Advice Request — Data Elements
— fieldsMTI: 0120
BitField NameTypeReqNotes
0.1Message Type IDnP4MValue: 0120
001Secondary Bit Mapb64CRequired if fields 65–128 present
002Primary Account Number (PAN)LLd nP19CMandatory except for P2P/token transactions
003Processing CodenP6MLimit optional fields for refund (value=20)
004Transaction AmountnP12M
007Transmission Date and TimenP10M
011Systems Trace Audit Number (STAN)nP6MTransaction identifier
012Local Transaction TimenP6MCopied from 01XX message
013Local Transaction DatenP4MCopied from 01XX message
018Merchant Type (MCC)nP4M
032Acquiring Institution ID CodeLLd nP11M
037Retrieval Reference Numberan12M
041Card Acceptor Terminal IDans15M
043Card Acceptor Name and Locationans40M
049Transaction Currency CodenP3M
060Additional POS DataLLL ans999M
062Vantiv Transaction DataLLL ans999M062.2 STAN required
M Mandatory
C Conditional
O Optional
RES0130 Auth Advice Response — Data Elements
— fieldsMTI: 0130
BitField NameTypeReqNotes
003Processing CodenP6MCopied from 0120
007Transmission Date and TimenP10M
011STANnP6MCopied from 0120
012Local Transaction TimenP6MCopied from 0120
013Local Transaction DatenP4MCopied from 0120
015Settlement DatenP4M
037Retrieval Reference Numberan12MCopied from 0120
038Authorization Identification Responsean6OAuth code
039Response Codean2MMust be 00 for acceptance
049Transaction Currency CodenP3MCopied from 0120
062Vantiv Transaction DataLLL ans999M062.2 STAN, 062.4–062.7 institutions required
M Mandatory
C Conditional
O Optional
Important: All submissions and resubmissions must contain original data element values for Fields 004, 012, 013, 018, 022, 035, 041, 043. These must remain the same throughout the entire lifecycle.
Message Flow
0200
Financial Request
0210
Financial Response
·
0220
Financial Advice
0230
Advice Response
Request MTI
0200
Financial Request
Response MTI
0210
Financial Response
Key Difference
Real-time
Account debited/credited immediately
Surcharge Field
Field 028
Required for acquirer surcharge/rebate
0200 Financial RequestPurchase / Withdrawal / Refund
0210 Financial ResponseApproval / Decline
REQ0200 Financial Transaction Request — Data Elements
— fieldsMTI: 0200
BitField NameTypeReqNotes
002Primary Account Number (PAN)LLd nP19CFor manually entered PAN or non-original resubmission
003Processing CodenP6M00=Purchase · 01=Withdrawal · 09=Balance · 20=Refund · 28=Deferred
004Transaction AmountnP12MMust remain same throughout resubmission lifecycle
007Transmission Date and TimenP10M
011Systems Trace Audit Number (STAN)nP6MUnique per transaction
012Local Transaction TimenP6MMust remain same throughout lifecycle
013Local Transaction DatenP4MMust remain same throughout lifecycle
018Merchant Type (MCC)nP4MMust remain same throughout lifecycle
022Point of Service Entry ModenP4CRequired for POS. Must remain same throughout lifecycle.
028Transaction Fee AmountX+an8CMandatory for acquirers imposing surcharge/rebate
032Acquiring Institution ID CodeLLd nP11M
035Track II DataLLd nP37CMust remain same throughout lifecycle. Omit in non-original.
037Retrieval Reference Numberan12MTransaction matching reference
041Card Acceptor Terminal IDans15MMust remain same throughout lifecycle
043Card Acceptor Name and Locationans40MMust remain same throughout lifecycle
049Transaction Currency CodenP3MISO 4217 code
052Personal Identification Number Datab64CRequired if cardholder enters PIN
055Integrated Circuit Card (EMV) DataLLL nP999CPresent if EMV chip data available
060Additional POS DataLLL ans999MSubfield 6 must be 4 for preauthorized debit
062Vantiv Transaction Data062.2 STAN M · 062.16 Check# for stop pmt · 062.21 New PIN for PIN changeLLL ans999MroXSAKHARE private data field
M Mandatory
C Conditional
O Optional
RES0210 Financial Transaction Response — Data Elements
— fieldsMTI: 0210
BitField NameTypeReqNotes
003Processing CodenP6MEchoed from request
004Transaction AmountnP12MAuthorized amount (may differ for partial approvals)
007Transmission Date and TimenP10M
011STANnP6MEchoed from 0200
015Settlement DatenP4M
037Retrieval Reference Numberan12MEchoed from 0200
038Authorization Identification Responsean6CApproval code for approved transactions
039Response Codean2M00=Approved · 05=Declined · 51=Insufficient funds · 54=Expired card
049Transaction Currency CodenP3M
054Additional AmountsLLL ans120CBalance inquiry: available balance and ledger balance returned here
062Vantiv Transaction DataLLL ans999M062.2 STAN, 062.4–062.7 required
M Mandatory
C Conditional
O Optional
Request MTI
0220
Financial Advice Request
Response MTI
0230
Financial Advice Response
Use Case
Host Capture
Completion / offline post-auth
0220 Advice RequestFinancial Advice
0230 Advice ResponseFinancial Advice Response
REQ0220 Financial Advice Request — Data Elements
— fieldsMTI: 0220
BitField NameTypeReqNotes
002PANLLd nP19CMandatory except P2P/token transactions
003Processing CodenP6MLimit optional fields if refund (value=20)
004Transaction AmountnP12M
007Transmission Date and TimenP10M
011STANnP6M
012Local Transaction TimenP6MCopied from 02XX
013Local Transaction DatenP4MCopied from 02XX
018Merchant Type (MCC)nP4M
037Retrieval Reference Numberan12MCopied from 02XX
039Response Codean2CCopied from original response
041Card Acceptor Terminal IDans15M
049Transaction Currency CodenP3M
060Additional POS DataLLL ans999MCopied from 02XX
062Vantiv Transaction DataLLL ans999M062.2 Terminal Seq# required
M Mandatory
C Conditional
O Optional
RES0230 Financial Advice Response — Data Elements
— fieldsMTI: 0230
BitField NameTypeReqNotes
003Processing CodenP6MCopied from 0220
004Transaction AmountnP12MCopied from 0220
007Transmission Date and TimenP10M
011STANnP6MCopied from 0220
015Settlement DatenP4M
037Retrieval Reference Numberan12M
039Response Codean2M00=Accepted · non-00=Rejected
049Transaction Currency CodenP3M
062Vantiv Transaction DataLLL ans999M
M Mandatory
C Conditional
O Optional
Critical: Field 090 (Original Data Elements) is MANDATORY: original MTI, original STAN, original transmission date/time, and original acquiring institution ID. Field 095 required for partial reversals.
Message Flow
0420
Reversal Request
0430
Reversal Response
Request MTI
0420
Reversal/Adjustment Advice
Response MTI
0430
Reversal/Adjustment Response
Critical Field
Field 090
Original Data Elements — MANDATORY
Reason Code
Field 063
02=Timeout · 07=Partial · 00=Unable
0420 Reversal RequestReversal / Adjustment
0430 Reversal ResponseReversal Response
REQ0420 Reversal Request — Data Elements
— fieldsMTI: 0420
BitField NameTypeReqNotes
002Primary Account Number (PAN)LLd nP19MMandatory; replaced by F100.2 for P2P encrypted.
003Processing CodenP6MAccount type may be updated by issuer
004Transaction AmountnP12MCopied from 01XX or 02XX message
007Transmission Date and TimenP10MNew timestamp for reversal
011STANnP6MNew STAN for reversal (not original STAN)
012Local Transaction TimenP6MCopied from 01XX or 02XX
013Local Transaction DatenP4MCopied from 01XX or 02XX
018Merchant Type (MCC)nP4M
032Acquiring Institution ID CodeLLd nP11M
037Retrieval Reference Numberan12MCopied from 01XX or 02XX — used to match original
039Response Codean2MCopied from original 01XX/02XX response
041Card Acceptor Terminal IDans15M
049Transaction Currency CodenP3M
060Additional POS DataLLL ans999MCopied from 01XX or 02XX
062Vantiv Transaction Data062.2 Terminal Seq# M — copied from 0110/0210LLL ans999M062.2 copied from approval response
063Reversal Reason Codean2M02=Timeout · 07=Partial · 00=Unable to complete
090Original Data Elements090.1 MTI · 090.2 STAN · 090.3 TX DateTime · 090.4 Acq IDnP42M🔴 CRITICAL — Links reversal to original transaction
095Replacement Amounts095.1 Actual TX · 095.2 Settlement · 095.3–4 Surchargean42CRequired for partial reversal or misdispense
M Mandatory
C Conditional
O Optional
RES0430 Reversal Response — Data Elements
— fieldsMTI: 0430
BitField NameTypeReqNotes
002PANLLd nP19MMandatory in response
003Processing CodenP6MCopied from 0420
004Transaction AmountnP12MCopied from 0420
007Transmission Date and TimenP10M
011STANnP6MCopied from 0420
015Settlement DatenP4M
037Retrieval Reference Numberan12M
039Response Codean2M00=Accepted · non-00=Rejected reversal
049Transaction Currency CodenP3M
062Vantiv Transaction DataLLL ans999M
090Original Data ElementsnP42MCopied from 0420 request
095Replacement Amountsan42CIf present in 0420 request
M Mandatory
C Conditional
O Optional
Request MTI
0500
Reconciliation Request
Response MTI
0510
Reconciliation Response
Totals Field
Field 124
Batch totals by card type
Response Codes
00/95/96
Balanced · Unbalanced · Error
0500 RequestAcquirer Settlement
0510 ResponseBatch Totals
REQ0500 Reconciliation Request — Data Elements
— fieldsMTI: 0500
BitField NameTypeReqNotes
003Processing CodenP6M920000 = Settlement/Reconciliation
007Transmission Date and TimenP10M
011STANnP6MUnique trace for session
041Card Acceptor Terminal IDans15MTerminal being settled
042Card Acceptor Identificationans15MMerchant ID being settled
060Additional POS DataLLL ans999MTerminal configuration data
062Vantiv Transaction Data062.3 Transaction QualifierLLL ans999C062.3 determines totals in response
M Mandatory
C Conditional
O Optional
RES0510 Reconciliation Response — Data Elements
— fieldsMTI: 0510
BitField NameTypeReqNotes
003Processing CodenP6M920000 for settlement
007Transmission Date and TimenP10M
011STANnP6MCopied from 0500
015Settlement DatenP4MContains data corresponding to totals
039Response Codean2M00=Balanced · 95=Unbalanced · 96=System error
041Card Acceptor Terminal IDans15M
042Card Acceptor Identificationans15M
124Transaction Dependent Data124.1–x Batch totals by card type, count, amountsLLL ans999CAll batch totals: debit/credit count and amounts
M Mandatory
C Conditional
O Optional
Field 070 values: 0001=Sign-on · 0002=Sign-off · 0101=PIN Key Exchange · 0160=Change Key (to roXSAKHARE) · 0161=Change Key (from roXSAKHARE) · 0301=Echo/Handshake
Request MTI
0800
Network Management Request
Response MTI
0810
Network Management Response
Key Field
Field 070
Network Mgmt Info Code
Common Codes
0001/0002
Sign-on / Sign-off
0800 Network RequestSign-on / Key Exchange / Echo
0810 Network ResponseNetwork Management Response
REQ0800 Network Management Request — Data Elements
— fieldsMTI: 0800
BitField NameTypeReqNotes
001Secondary Bit Mapb64MMandatory for network messages
007Transmission Date and TimenP10M
011STANnP6M
070Network Management Information CodenP3M0001=Sign-on · 0002=Sign-off · 0101=PIN Key Exchange · 0301=Echo
115Terminal Specific DataLLLL ans9999CRequired for Terminal Processing platform
125Network Management InformationLLL ans999CRequired when Field 070 = 0101 (PIN Key Exchange)
M Mandatory
C Conditional
O Optional
RES0810 Network Management Response — Data Elements
— fieldsMTI: 0810
BitField NameTypeReqNotes
001Secondary Bit Mapb64M
007Transmission Date and TimenP10M
011STANnP6MCopied from 0800
039Response Codean2M00=Accepted · non-00=Rejected
070Network Management Information CodenP3MEchoed from 0800 request
124Transaction Dependent Data124.01 Encryption Key · 124.02 Check Digits · 124.03 Key FormatLLL ans999CContains new key data for PIN Key Exchange responses
M Mandatory
C Conditional
O Optional