Uploaded by Anton Polunin

POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1

advertisement
POSLine ISO8583 Interface Specifications
POSLine ISO8583 Specifications
Revision History
Author
Revision Date
Comments
Christodoulos
Stavrou
Vangelis
Anastasiades
Akis Sykopetritis
01/06/01
Initial Creation of Document
06/07/01
Chip Support Added
07/07/01
Akis Sykopetritis
14/11/01
PID01191,
RN12565
PID01191,
RN12565
Christodoulos
Stavrou
Andrey
Brook
17/01/2003
Christodoulos
Stavrou
Christodoulos
Stavrou
Christodoulos
Stavrou
Christodoulos
Stavrou
Christodoulos
Stavrou
02-04-03
Update field 63 to support
Installments
Update field 63 for
instalment response
processing
Added the OTB-Settlement
Table
Added P2P support
(processing code 10 and
filed 48)
Updated Chip related fields
17-02-04
Added LRC on TCP/IP
MSCC
ONLINE 3.4r10+
03-05-04
Added Payment Indicator
EB
ONLINE 3.4r10+
26-11-04
MSCC
Christodoulos
Stavrou
Christodoulos
Stavrou
Christodoulos
17-02-05
10-01-06
Added field 55 and made
field 62 mandatory
Added key fields section
and highlighted the timeout
cases of reconciliation
Updated key fields
explanation
Added value 79 for field 22
09-02-06
Added value 2 in Payment
29/01/2003
26-01-05
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
Reference
02 July 2013
Included in online
version
online 3.4r06+
online 3.4r07-1+
online 3.4r07-1+
online 3.4r07+
MSCC
MSCC
Compliance
06.1
WSCB
ONLINE 3,4R08+
Comment [C1]: TO BE
IMPLEMENTED
Page 1-48
POSLine ISO8583 Interface Specifications
Stavrou
Christodoulos
Stavrou
Christodoulos
Stavrou
Christodoulos
Stavrou
Christodoulos
Stavrou
Christodoulos
Stavrou
28-02-06
Maria Hadjiona
12/12/2011
Nikolas Parpas
Eirini Mari
31/08/2012
11/09/2012
12-10-2006
25-04-2007
25/04/2009
17/11/2009
Indicator (60) for Recurring
Payments
Added Table id 17 for 4DBC
Added support for PIN
Change
Added support for Fee
Amount in Field 63
Added Table 33 for KSN in
Field 063
Added Table 18 for
Terminal Serial Number in
Field 063
Reversed Offline Sale,
Acknowledgement
Multicurrency support
Purchase Fee Acquirer
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
CAMB
Comment [C2]: TO BE
IMPLEMENTED
HAIBP
CTL-R001
Available only for
3.7r02 and above
Comment [CS3]: To be implemented
Comment [CS4]: To be implemented
12-2 Release
RQM-2855
RQM - 2857
C12-12
C12-12
Page 2-48
POSLine ISO8583 Interface Specifications
Table of Contents
1.
Message Structure _____________________________________________________________ 7
1.1.
ASYNC Message Structure _________________________________________________________ 7
1.2.
SYNC (X25) Message Structure _____________________________________________________ 7
1.3.
TCP/IP Message Structure _________________________________________________________ 7
1.4.
Transport Protocol Data Unit (TPDU) ________________________________________________ 7
1.5.
Communication Set-up_____________________________________________________________ 8
1.6.
Application Data Structure _________________________________________________________ 8
1.6.1.
Message Type Identifier __________________________________________________________ 8
1.6.2.
Bit Map _______________________________________________________________________ 9
1.6.3.
DATA ELEMENTS ________________________________________________________________ 9
2.
Transaction Data ______________________________________________________________ 9
2.1.
Message Type / Processing Code Table _______________________________________________ 12
2.1.
Primary Account Number, Field 2 __________________________________________________ 12
2.2.
Processing Code, Field 3 __________________________________________________________ 13
2.2.1.
Account Selections______________________________________________________________________ 13
2.3.
Processing / Flow Control Definition _________________________________________________________ 13
2.4.
Amount, Transaction, Field 4 ______________________________________________________ 13
2.5.
Systems Trace Audit Number, Field 11 ______________________________________________ 13
2.6.
Time, Local Transaction, Field 12 ___________________________________________________ 13
2.7.
Date, Local Transaction, Field 13 ___________________________________________________ 13
2.8.
Date, Expiration, Field 14 _________________________________________________________ 13
2.9.
Point of Service (POS) Entry Mode, Field 22 __________________________________________ 13
2.10.
Network International Identifier (NII), Field 24______________________________________ 14
2.11.
Point of Service (POS) Condition Code, Field 25 _____________________________________ 14
2.12.
Fee Amount, Field 28 ___________________________________________________________ 14
2.13.
Track II Data, Field 35 __________________________________________________________ 14
2.14.
Retrieval Reference Number (RRN), Field 37 _______________________________________ 14
2.15.
Authorization Identification Response, Field 38 ______________________________________ 14
2.16.
Response Code, Field 39 _________________________________________________________ 14
2.17.
Card Acceptor Terminal Id., Field 41 ______________________________________________ 14
2.18.
Card Acceptor Acquirer Id., Field 42 ______________________________________________ 15
2.19.
Card Acceptor Acquirer Name, Field 43 ____________________________________________ 15
2.20.
Track I Data, Field 45 ___________________________________________________________ 15
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 3-48
POSLine ISO8583 Interface Specifications
2.21.
Additional Text Data, Field 48 ____________________________________________________ 15
2.22.
Currency Code, Field 49 _________________________________________________________ 16
2.23.
Personal Identification Number (PIN) Data, Field 52 _________________________________ 16
2.24.
Security Related Control Information, Field 53 ______________________________________ 16
2.25.
Additional Amounts, Field 54 ____________________________________________________ 16
2.26.
ICC Related Data, Field 55 ______________________________________________________ 16
2.27.
Private Use Fields ______________________________________________________________ 17
2.27.1.
Private Use Field 60 ___________________________________________________________ 17
2.27.1.1.
Batch Number _______________________________________________________________ 17
2.27.1.2.
Original Message Data ________________________________________________________ 17
2.27.1.3.
Original Amount _____________________________________________________________ 17
2.27.2.
Private Use Field 62 ___________________________________________________________ 18
2.27.2.1.
Invoice/ECR Reference Number ________________________________________________ 18
2.27.3.
Private Use Field 63 ___________________________________________________________ 18
2.27.3.1.
Section 1 - Reconciliation Request Totals _________________________________________ 18
2.27.3.2.
Section 2 - Reconciliation Request Totals (Multi-Currency processing, Option 2) _________ 19
2.27.3.3.
Section 3 – Balance Inquiry Response ____________________________________________ 20
2.27.3.4.
Section 4 - Additional Data _____________________________________________________ 20
2.27.3.4.1.
P2P Data (10) _____________________________________________________________ 21
2.27.3.4.2.
P2P/Payment Data (11)______________________________________________________ 21
2.27.3.4.3.
CVV2 DATA (16)___________________________________________________________ 22
2.27.3.4.4.
AMEX 4DBC (17) __________________________________________________________ 23
2.27.3.4.5.
Installment Data (90) ________________________________________________________ 23
2.27.3.4.6.
Payment Indicator (60) ______________________________________________________ 24
2.27.3.4.7.
New PIN (77) ______________________________________________________________ 24
2.27.3.4.8.
Additional Fee Data (44) _____________________________________________________ 24
2.27.3.4.9.
KSN (33) _________________________________________________________________ 25
2.27.3.4.10.
2.28.
3.
Terminal Serial Number (18) _______________________________________________ 25
Key Fields ____________________________________________________________________ 25
Transaction Format Definitions _________________________________________________ 26
3.1.
Authorization/ Preauthorization ____________________________________________________ 26
3.2.
Balance Inquiry/Fee Inquiry _______________________________________________________ 26
3.3.
Sale / Debit _____________________________________________________________________ 27
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 4-48
POSLine ISO8583 Interface Specifications
3.4.
Refund _________________________________________________________________________ 28
3.5.
Cash ___________________________________________________________________________ 29
3.6.
Sale & Cash_____________________________________________________________________ 29
3.7.
Off-line Sale ____________________________________________________________________ 30
3.8.
Off-line Refund __________________________________________________________________ 31
3.9.
Adjust, Sale _____________________________________________________________________ 31
3.10.
Adjust, Credit _________________________________________________________________ 32
3.11.
Void, Sale _____________________________________________________________________ 33
3.12.
Void, Credit ___________________________________________________________________ 34
3.13.
Reversal ______________________________________________________________________ 34
3.14.
Test Transaction _______________________________________________________________ 35
3.15.
Please Wait Advice _____________________________________________________________ 37
3.16.
Settlement ____________________________________________________________________ 37
3.17.
Settlement Trailer ______________________________________________________________ 38
3.18.
Batch Upload __________________________________________________________________ 39
4.
Message Flows ______________________________________________________________ 40
4.1.
MESSAGE TYPE: 0100 _____________________________________________________________ 40
4.2.
MESSAGE TYPE: 0200 _____________________________________________________________ 40
4.3.
MESSAGE TYPE: 0200 - REFUND_____________________________________________________ 40
BASE I ______________________________________________________________________________ 40
POSLINE ____________________________________________________________________________ 40
4.4.
MESSAGE TYPE: 0200 - VOID REFUND ________________________________________________ 41
4.5.
MESSAGE TYPE: 0200 - VOID SALE __________________________________________________ 41
4.6.
MESSAGE TYPE: 0220 _____________________________________________________________ 41
4.7.
MESSAGE TYPE: 0400 - REVERSAL __________________________________________________ 42
4.8.
MESSAGE TYPE: 0500 - SETTLEMENT ________________________________________________ 42
4.9.
MESSAGE TYPE: 0320 - BATCH UPLOAD ______________________________________________ 42
4.10.
MESSAGE TYPE: 0800 ___________________________________________________________ 42
4.11.
MESSAGE TYPE: 0830 ___________________________________________________________ 43
5.
Settlement Process Flow _______________________________________________________ 43
5.1.
Balanced Settlement ______________________________________________________________ 43
5.2.
Balanced Settlement With Advices __________________________________________________ 43
5.3.
Out Of Balance Settlement ________________________________________________________ 44
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 5-48
POSLine ISO8583 Interface Specifications
5.4.
Balanced Settlement Or Batch Upload Time Out ______________________________________ 45
5.5.
Delayed Settlement _______________________________________________________________ 45
6.
Multicurrency Processing ______________________________________________________ 45
6.1.
Option 1. Standard. ______________________________________________________________ 45
6.2.
Option 2. Multi-currency merchant _________________________________________________ 45
7.
Payment System Support _______________________________________________________ 46
8.
Installment Processing ________________________________________________________ 46
9. OTB-Settlement Table ___________________________________________________________ 47
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 6-48
POSLine ISO8583 Interface Specifications
1. Message Structure
The structure of a terminal/host message consists of two major parts, the TPDU and Application Data. Depending on the
Communication Protocol (Controller Card in NAC), the message may have leading and/or trailing protocol-related
information.
1.1.
ASYNC Message Structure
Start
Chr
STX
Message
Length
Ascii 2
TPDU + Data
60h or 68h
1 Byte
4 Bytes BCD
1 Byte
1.2.
TPDU
Id
Dest.
Addr.
No
check
Orig.
Addr.
No check
2 Byt.
2 Byt.
App. Data
End
Chr
ETX
LRC
ISO8583
Message
Ascii
3
10 – 240
Bytes
1
Byte
XOr Operation with the
Message Length, TPDU,
Data and ETX.
1 Byte
SYNC (X25) Message Structure
Id
60h or 68h
TPDU
Dest. Addr.
No check
Orig. Addr.
No check
ISO8583 Message
1 Byte
2 Byt.
2 Byt.
10 – 240 Bytes
1.3.
TCP/IP Message Structure
Message
Length
Number
of bytes
following
in Hex
2 Bytes
Application Data
TPDU
Id
Dest. Addr.
60h or
68h
or
61h
or 62h
1 Byte
Application Data
No check
Orig.
Addr.
No check
ISO8583 Message
2 Bytes
2 Bytes
10 – 240 Bytes
LRC
(Conditional, exists if id in TPDU
is 61h)
XOr Operation with the TPDU
and Application Data.
The Message Length is not taken
in consideration.
1 Byte
Note:
LRC Failure
In case that the LRC verification fails, a message having only TPDU will be returned as response. In this
case, id in TPDU will have the value 62h.
1.4.
Transport Protocol Data Unit (TPDU)
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 7-48
POSLine ISO8583 Interface Specifications
The TPDU contains addressing information currently not used by the Host.
Host will only accept the as Id the values 60h or 68h. Any other value will be ignored.
The Destination Address is switched with the Originator Address in the Response TPDU.
1.5.
Communication Set-up
Single Session is expected which remains active through out. All messages will be exchanged through this
session.
That is, for X25 protocol only one SVS is required which remains active, for TCP/IP only one Socket is
required which remains open.
1.6.
Application Data Structure
Each application message consists of three components in the following sequence; Message Type Identifier, Bit Map, and a
variable number of data elements. The maximum data content of a message is 240 bytes.
Msg.Type
2 bytes
Bit Map
8 bytes
Application data
Data Elements
0-230 bytes
10-240
1.6.1.
Message Type Identifier
The Message Type Identifier (Msg.Type) consists of four (4) digits and is used to define the message type
of the transaction.
The first and second digits identify the class of message. The third and fourth digits identify the message
function and transmission mode:
Message type definition:
Digits 1 and 2
01
02
03
04
05
08
Message Class
Authorization
Financial
Batch Upload
Reversal
Reconciliation control
Network management
Digits 3 and 4
00
10
20
30
Transmission Mode
Interactive request
Interactive response
Non-interactive advice
Non-interactive advice response
The following Message Type Identifiers are used:
Message Type
0100/0110
0200/0210
0220/0230
0320/0330
0400/0410
Application
Authorization Request/Response
Financial Transaction Request/Response
Financial Transaction Advice/Response
Batch Upload/Response
Reversal Request/Response
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 8-48
POSLine ISO8583 Interface Specifications
0500/0510
0800/0810
1.6.2.
Reconciliation Request/Response
Network Management Request/Response
Bit Map
ISO 8583 uses a concept called "bit map", where each data element is assigned a position indicator in a control field, or bit map.
The presence of a data element in a specific message is indicated by a one (1) in the assigned position; the absence of a data
element is indicated by a zero (0) in the assigned position.
Each application transaction includes one (1) bit map. A bit map consists of 64 bits numbered from the left
starting with bit 1.
The first bit of the bit map represents a secondary bit map. Since no secondary bit map is supported, the first
bit of the bit map is always „0‟.
bit
1
Field 1
Secondary bit
map
Always „0‟
2
Field 2
Primary Acct No.
3
Field 3
Processing Code
4
Field 4
Amount, Trans
•••••
64
Field 64
Message Auth
Code
1.6.3.
DATA ELEMENTS
Data Element characteristics - names, formats, attributes, conditional code values - are described fully
in the current specification.
The following rules apply to the data elements within a message:
All data elements begin on a byte boundary.
Fixed length “n” type fields with an odd length are right-justified to a byte boundary, and zero-filled on
the left. For example, a field type “n3” field will occupy 2 bytes, and the most significant nibble of the
first byte will be 0.
All lengths for variable length fields are represented in binary coded decimal (BCD), right-justified to a
byte boundary, and zero-filled on the left. For example, an „LLVAR‟ field with a length of 15 will have
a length indicator of „15h‟ occupying one byte. An „LLLVAR‟ field with a length of 15 will have a
length indicator of „0015h‟, occupying two bytes.
The length indicator for a variable length field is a count of the number of data elements to follow. It
does not include the length of the length indicator.
The variable length Primary Account Number field, field 2, with an odd length is left justified within
the field and “F” filled.
If the message contains a field not descripted in this specification then the message will not be
processed therefore no response will be send from the Host.
2. Transaction Data
The following table shows the fields as implemented by the Host. This section will describe the use of the following table and
define each field.
Bit Data Element Name
Message Type Id
Attribute
n
4
Request
Response Comments
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 9-48
POSLine ISO8583 Interface Specifications
02
03
04
11
12
13
14
22
24
25
28
35
37
38
39
41
42
43
45
48
49
52
53
54
55
60
61
62
63
64
Bit Map
Primary Acct. Num.
Processing Code
Amount, Trans.
Systems Trace No
Time, Local Trans.
Date, Local Trans.
Date, Expiration
POS Entry Mode
NII
POS Condition Code
Fee Amount
Track 2 Data
Retrieval Ref. No.
Auth. Id. Response
Response Code
Terminal Id
Card Acq. Id
Card Acq. Name
Track 1 Data
Additional Text Data
Currency Code
PIN Data
Security Control Info
Additional Amounts
ICC Related Data
Private Use
Private Use
Private Use
Private Use
Message Auth. Code
b
64
n
..19
n
6
n
12
n
6
n
6
n
4
n
4
n
3
n
3
n
2
n
12
z
..37
an
12
an
6
an
2
ans
8
ans
15
ans
40
ans ..76
ans ..999
n
3
B
64
N
16
an ...120
b …255
ans ...999
ans ...999
ans ...999
ans ...999
b
64
Mandatory for multi-currency processing. Option 2
NOT USED
The first two columns, Bit, Data Element Name show the data element assignment to a bit position, refer to Table 2 ISO
8583. The following sections will define the use of each field.
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 10-48
POSLine ISO8583 Interface Specifications
The “Attribute” column lists the format and size of the data element. The size of the field is the number of data elements
contained in the field. Variable length fields are shown with preceding “.” characters indicating the number of variable leng th
digits. (...999 defines a field that‟s maximum length is 999 data elements.) The following table defines each attribute.
Attribute Meaning
A
Alpha characters (a-z, A-Z)
Each data element represents 1 byte
An
Alpha-numeric characters (1-9, a-z, A-Z)
Each data element represents 1 byte
Ans
Alpha-numeric and special characters (All characters)
Each data element represents 1 byte
B
Binary data
Each data element represents 1 bit. (8 data elements = 1 byte)
N
Numeric data
Each data element represents 1 nibble (2 data elements = 1 byte)
Z
Track 2 data, as read from the magnetic strip.
Each data element represents 1 nibble (2 data elements = 1 byte)
K
Key Field, Refer to section 2.6 Key fields for more information
The “Request” and “Response” columns show the contents of the terminal request and response messages comprising a
transaction. These contents can be one of the following:
M
O
Cxx
01
02
03
04
05
06
07
Mandatory
Optional
Conditional field, where xx is:
The primary account number is included when the transaction is entered manually via the keyboard.
The expiration date field will be included if the card number was entered manually, and the card processing
options are set to accept a date, expiration to be entered.
For on-line transactions when the account number is read from the magnetic stripe reader track I and/or
track II will be included.
Terminal only stores the primary account number and expiration date from a track read. Any transactions
processed other than an on-line transaction will include the primary account number and expiration date.
The first two digits of the POS entry mode will be set to „02‟ if the card is read by the card reader, and „01‟
if the card number is entered via the keyboard. The last digit will indicate the PIN entry capability of the
terminal. It will have a value of „1‟ if there is PIN entry capability, and „2‟ if there is no PIN entry
capability. This information should be treated as additional transaction information, and not used to
determine which field to use for the card number.
Some check guarantee services use primary account numbers for data. If account number is entered
manually the bit 2 will be included in the request. If the account number is read via the magnetic card
reader then either track I and/or track II will be included.
Present if Chip Card was used.
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 11-48
POSLine ISO8583 Interface Specifications
2.1.
Message Type / Processing Code Table
The following is a table specifying the message type and processing code for each transaction type. The
stroked through messages are mentioned in the Specifications but are not supported by the Host.
Transaction
Message Type
Authorization
0100
Pre-Authorization
Balance Inquiry
Fee Inquiry
Check Verification
Card Verification
PIN Change
Sale
0200
P2P
Refund
Payment
Cash
Sale & Cash
Void, Sale, on-line
Void, Refund, on-line
Off-line Sale
0220
Off-line Refund
Sales Completion
Adjust, Sale
Adjust, Refund
Guaranteed Late Arrival
Reversal
0400
Settlement Request
0500
Settlement, after upload
Batch Down Line Load
Batch upload
0320
Signature Data
0320
Statistics
0800
Logon
Initialization
Test Transaction
0800
Please Wait Advice
0830
EBT Food Stamps
0200
EBT Cash Card Purchase
EBT Cash w/Cash Back
EBT Cash Only
a = Account Selection
x = Processing / Flow control
Processing Code
00 a0 0x
30 a0 0x
31 a0 0x
32a0 0x
04 a0 0x
38 a0 0x
70 a0 0x
00 a0 0x
10 a0 0x
20 a0 0x
50 a0 0x
01 a0 0x
09 a0 0x
02 a0 0x
22 a0 0x
00 a0 0x
20 a0 0x
00 a0 0x
02 a0 0x
22 a0 0x
90 a0 0x
Same as original transaction
92 00 0x
96 00 0x
95 00 0x
Same as original transaction
90 00 0x
91 00 0x
92 00 0x
93 00 0x
99 00 0x
90 00 0x
00 a8 0x
00 a0 0x
09 a0 0x
01 a0 0x
2.1. Primary Account Number, Field 2
The Primary Account Number (PAN) contains the card account number when track I or track II is not
available. The PAN is sent on all advice transactions (i.e. adjust, off-line, etc.).
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 12-48
POSLine ISO8583 Interface Specifications
2.2. Processing Code, Field 3
The processing code is used in conjunction with the message type to define the type of transaction being
sent by the terminal to the host. It also includes account selection information.
For example:
00 a0 0x
where
a = Account Selection
x = Processing / Flow control
2.2.1. Account Selections
The account information is represented in the third digit of the processing code. The following values are
used:
Code
0
1
2
3
4
9
Account Selected
Default Account
Savings Account
Checking Account
Credit Facility
Universal Account
EBT
2.3. Processing / Flow Control Definition
Host does not use this information. It is returned in the Response.
2.4. Amount, Transaction, Field 4
The transaction amount is the total amount of the transaction.
2.5. Systems Trace Audit Number, Field 11
The systems trace audit number (STAN) is generated automatically by the terminal. It is incremented for
each transaction processed. The terminal will never generate a STAN of 000000.
2.6. Time, Local Transaction, Field 12
The time stamp of the transaction when it originally was entered. This time stamp is permanent, it does not
change on subsequent transactions (i.e. adjust).
2.7. Date, Local Transaction, Field 13
The date stamp of the transaction when it originally was entered. This date stamp is permanent, it does not
change on subsequent transactions (i.e. adjust).
2.8. Date, Expiration, Field 14
The expiration date of the PAN. It is included when the track I or track II data is not present. The
expiration date is included as part of the track data when track data is present.
2.9. Point of Service (POS) Entry Mode, Field 22
The POS entry mode is used to indicate how the primary account number was entered into the terminal.
Positions 1 and 2
00
01
02
05
79
PAN entry mode
Unspecified
Manual
Magnetic stripe
ICC Read
Manual PAN entry as a
fallback to PAN entry via ICC
Position 3
0
1
2
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
PIN entry capability
Unspecified
PIN entry capability
No PIN entry capability
02 July 2013
Page 13-48
POSLine ISO8583 Interface Specifications
80
95
when the chip card or chipcapable terminal is unable to
process the transaction using
the data on the chip or
magnetic stripe.
Mag Stripe even though it is an
ICC capable
Integrated circuit card; CVV data
may be unreliable
2.10. Network International Identifier (NII), Field 24
The NII is used to identify the acquiring host.
2.11. Point of Service (POS) Condition Code, Field 25
The POS condition code is used to identify the condition which the transaction takes place.
Code
00
04
05
06
08
51
52
Meaning
Normal presentment
ECR Interface
Card not present
Pre-authorized request
Mail and/or telephone order
Open Tab
Frequency transaction
2.12. Fee Amount, Field 28
The Fee Amount is present when in a Fee Inquiry response and in every financial transaction response for
which the acquirer has added a Fee. The Fee amount is in the Transaction Currency (Field 49) with implied
decimal places.
2.13. Track II Data, Field 35
The Track II data field is present when valid track II is used to initiate the transaction. It contains the track II
image excluding the start sentinel, end sentinel and LRC characters.
2.14. Retrieval Reference Number (RRN), Field 37
The RRN is assigned by the host. The terminal stores the reference number and includes it on all advice
transactions. If an advice receives a new RRN the terminal will replace the old RRN with the new value.
2.15. Authorization Identification Response, Field 38
Usually referred to as the “approval code.” Assigned by the authorization host when the transaction is
approved.
2.16. Response Code, Field 39
Returned to the terminal from the authorization host to indicate the status of the transaction. A “00”
response code indicates an approval status. All other values are non-approval or error responses
2.17. Card Acceptor Terminal Id., Field 41
The terminal id used to uniquely identify the terminal. In case of Multicurrency support (Option 1), the
Terminal ID is different for each currency. In case of Multi-currency support (Option 2), the same Terminal
ID can be use for up to 4 currencies.
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 14-48
POSLine ISO8583 Interface Specifications
2.18. Card Acceptor Acquirer Id., Field 42
The merchant number assigned to the terminal. In case of Multicurrency support (Option 1), the Merchant
ID is different for each currency. In case of Multi-currency support (Option 2), the same Merchant ID can
be use for up to 4 currencies.
2.19. Card Acceptor Acquirer Name, Field 43
The name of the establishment. This field is typically not used. The name and address for the printer is
loaded in the terminal configuration table.
2.20. Track I Data, Field 45
The Track I data field is present when valid track II is used to initiate the transaction. It contains the track I
image excluding the start sentinel, end sentinel and LRC characters.
2.21. Additional Text Data, Field 48
The additional text data field can be used:
1. For capturing text data send by the POS terminal.
The contents may vary based on the implementation:
1.1. Account Funding Transaction Details:
The field should start with „USRDT „ followed by any text data up to 100 characters.
2. Requesting the Fee for a transaction (Fee Inquiry). In this case, the field should have the next format:
FEEINQnn where
- „FEEINQ‟ is a hardcoded string
- nn is a two digit code which identifies the transaction code for which the fee inquiry is requested.
The table below shows the possible values of nn
Code
00
01
10
11
20
30
38
40
50
90
91
92
93
97
Transaction Description
Purchase
Cash
P2P
Quasi Cash
Credit
Balance Inquiry
Mini Statement
Funds Transfer
Payment
PIN change
Deposit
Checkbook request
Full Statement
PIN Unblock
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 15-48
POSLine ISO8583 Interface Specifications
2.22. Currency Code, Field 49
Field 49 contains a code that identifies the currency of Field 4 (Transaction amount). This field is
mandatory for multi-currency processing (Option 2).
2.23. Personal Identification Number (PIN) Data, Field 52
PIN data as received from the PIN pad.
2.24. Security Related Control Information, Field 53
The security related control information is used to identify the terminal to the host. Its use is application
dependant.
2.25. Additional Amounts, Field 54
The additional amounts field contains other amounts associated with the transaction for example tip or cash
back or balance inquiry
Field
Length Attribute
Additional Amount
Attribute Bytes Values
n
3
2 0LLL - BCD length of data to follow, maximum 120 digits.
an 12..13 12..13 For Tip Amount only 12 bytes are required (only the amount).
For Cashback Amount only 12 bytes are required (only the amount).
For Balance Inquiry 13 bytes, are required with the next contents:
1. First 12 bytes are the Balance Inquiry Amount
2. The 13 byte is „C‟ for Positive Balance Inquiry Amount or „D‟
for Negative Balance Inquiry Amount.
2.26. ICC Related Data, Field 55
This field is used to transport chip-specific data over . For EMV compliant ICC data, DE 055 has its own generic structure
and may contain one or more Private Data Sub-elemnts (PDS‟s) as shown in the figure below:
Variable data zone – max 255 bytes
One or more PDS occurrences
Length
First PDS
PDS Tag
Second PDS
Length
Nth pds
PDS Data
More information can be found in the Europay,MasterCard,and Visa (MV ‟96) chip specification. EMV uses Basic encoding
Rules (B R). Reference the EMV ‟96 specification for details regarding coding of BER-tag,length,value (TLV) data objects.
There are mandatory tags that need to be send for both online and offline transactions.
Refer to EMV Tags for Field 55 document for more information.
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 16-48
POSLine ISO8583 Interface Specifications
2.27. Private Use Fields
Use has been made of private fields to provide for Data Elements not included in ISO 8583 and these are
defined in the following section, and referenced in the message format section.
Field
60
61
62
63
Name
Batch Number
Software ID
Original Message Data
Terminal Configuration Parameters (T4/T6)
Original Amount
Logon Request
Product Codes
Card Definition Tables (T4/T6)
Invoice/ECR Reference Number
Reconciliation Response Text
Product codes (T4/T6 Table Load to Terminal)
Logon Response
Reconciliation Request Totals
Terminal Statistics
Lodging Details
Additional Data
Applicable Message Type
0500
0800
0320
0810
0220
0800
0100, 0200, 0220, 0320
0810
0100, 0200, 0220, 0320
0510
0810
0810
0500
0800
0220
0100, 0200, 0220, 0320, 0110, 0210, 0310, 0510, 0810
2.27.1.
Private Use Field 60
The following sections define the use of each private use field 60.
2.27.1.1. Batch Number
The batch number is sent to the host in the settlement request message (message type 0500). The batch
number is assigned by the terminal when the batch is closed. Batch numbers may be set during terminal
initialization.
Message Type: 0500
Field
Length Attribute
Batch Number
Attribute Bytes Values
n
3
2 0LLL - BCD length of data to follow
ans
6
6
2.27.1.2. Original Message Data
The original message data is used to carry data in the transaction upload (message type 0320) of the original
transaction, since the message type and system trace audit number of the 0320 is not the same as the
original transaction.
Message Type: 0320
Field
Length Attribute
Original Message Type
Original Systems Trace
Audit Number
Reserved
Attribute
n
3
an
4
an
6
an
12
Bytes
2
4
6
Values
0LLL - BCD length of data to follow
Message type of original transaction
Trace number of original transaction
12 Space fill - Reserved for future use.
2.27.1.3. Original Amount
The original amount field is used to carry the amount of the transaction prior to a void or adjustment.
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 17-48
POSLine ISO8583 Interface Specifications
Message Type: 0220
Field
Length Attribute
Original Amount
Attribute Bytes Values
n
3
2 0LLL - BCD Length of data to follow
an
12
12 Original amount of the transaction being adjusted
2.27.2.
Private Use Field 62
The following sections define the use of each private use field 62.
2.27.2.1. Invoice/ECR Reference Number
Message Type: 0100, 0200, 0220, 0320, 0400
Field
Length Attribute
Invoice/ECR reference
number
2.27.3.
Attribute Bytes Values
n
3
2 0LLL – BCD Length of data to follow
an
6
6 Invoice number as entered by the operator or generated
automatically by the terminal. Must be unique within the same
Batch. This is the key field to be used for the above messages.
Private Use Field 63
The following sections define the use of each private use field 63. Only one section is applicable at a time. A
request/response can not contain more than one section.
2.27.3.1. Section 1 - Reconciliation Request Totals
The reconciliation totals are sent to the host in the settlement message (message type 0500). The totals are
all the financial transactions of the current open batch. In the case of multi-host applications, the totals are
only those totals associated with each acquirer.
Message Type: 0500
Field
Length Attribute
First Set
Sales Count
Sales Amount
Refund Count
Refund Amount
Second Set
Sales Count
Sales Amount
Refund Count
Refund Amount
Third Set
Sales Count
Sales Amount
Refund Count
Refund Amount
Forth Set
Sales Count
Sales Amount
Refund Count
Refund Amount
Attribute Bytes Values
N
3
2 0LLL - BCD Length of data to follow
an
3
3 000-999
an
12
12 $$$$$$$$$$¢¢
an
3
3 000-999
an
12
12 $$$$$$$$$$¢¢
an
3
3 000-999
an
12
12 $$$$$$$$$$¢¢
an
3
3 000-999
an
12
12 $$$$$$$$$$¢¢
an
3
3 000
an
12
12 000000000000
an
3
3 000
an
12
12 000000000000
an
3
3 000-999
an
12
12 $$$$$$$$$$¢¢
an
3
3 000-999
an
12
12 $$$$$$$$$$¢¢
The Reconciliation Totals are calculated using the following rules:
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 18-48
POSLine ISO8583 Interface Specifications
Any set of fields (First, Second, Third) can be used to contain the totals. The Host will sum up these
totals to a Total Sales Count, Total Sales Amount, Total Refund Count and Total Refund Amount.
The Fourth Set of totals is ignored.
The totals do not include any Reversals since a reversal and its original will be cancelled out.
Refund Totals (amount/count) refer only to the Refund requests (and the Adjustment Refund if any)
Sales Totals (amount/count) refer to the transactions other than Refund (or the Adjustment Refund)
and do not include the authorizations.
2.27.3.2. Section 2 - Reconciliation Request Totals (Multi-Currency processing, Option 2)
The reconciliation totals are sent to the host in the settlement message (message type 0500).
The totals are all the financial transactions of the current open batch.
In the case of multi-currency terminals the totals are associated with specific currencies.
Number of currencies and sets is limited to 4.
For backward compatibility format of first 120 bytes are the same as described in Section 1. Each set
contains totals for currency specified in positions 121-132. Currency is specified if totals in corresponding
set are presented. For example, for two currencies length of field 63 is 126=30*4+3*2.
Message Type: 0500
Field
Length Attribute
Attribute Bytes Values
N
3
2 0LLL - BCD
Length of data to
follow
First Set
Comments
Mandatory
Sales Count
Sales Amount
Refund Count
Refund Amount
Second Set
Sales Count
Sales Amount
Refund Count
Refund Amount
Third Set
Sales Count
Sales Amount
Refund Count
Refund Amount
an
an
an
an
3
12
3
12
3
12
3
12
000-999
$$$$$$$$$$¢¢
000-999
$$$$$$$$$$¢¢
an
an
an
an
3
12
3
12
3
12
3
12
000-999
$$$$$$$$$$¢¢
000-999
$$$$$$$$$$¢¢
an
an
an
an
3
12
3
12
3
12
3
12
000-999
$$$$$$$$$$¢¢
000-999
$$$$$$$$$$¢¢
an
an
an
an
3
12
3
12
3
12
3
12
000-999
$$$$$$$$$$¢¢
000-999
$$$$$$$$$$¢¢
n
n
n
n
3
3
3
3
3
3
3
3
Fourth Set
Sales Count
Sales Amount
Refund Count
Refund Amount
First CurrencyCode
Second Currency Code
Third Currency Code
Fourth Currency Code
ISO code
ISO code
ISO code
ISO code
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
Optional
If not presented should be filled by 30 spaces
(0x20)
Optional
If not presented should be filled by 30 spaces
(0x20)
Optional
If not presented should be filled by 30 spaces
(0x20)
Mandatory
Conditional. If totals in 2nd set presented
Conditional. If totals in 3rd set presented
Conditional. If totals in 4th set presented
02 July 2013
Page 19-48
POSLine ISO8583 Interface Specifications
The Reconciliation Totals are calculated using the following rules:
Any set of fields is used to contain the totals for specific currency. The Host will sum up these totals to
a Total Sales Count, Total Sales Amount, Total Refund Count and Total Refund Amount.
The totals do not include any Reversals since a reversal and its original will be cancelled out.
Refund Totals (amount/count) refer only to the Refund requests (and the Adjustment Refund if any)
Sales Totals (amount/count) refer to the transactions other than Refund (or the Adjustment Refund).
2.27.3.3. Section 3 – Balance Inquiry Response
Message Type: 0110, 0210
Field
Length Attribute
Balance Currency
Attribute Bytes Values
N
3
2 0LLL - BCD Length of data to follow
an
3
3 ISO Alpha Code
an
1
1 [space]
an
1
1 Balance Sign:
[-] for Negative Balance
[space] for Positive Balance
an
12
12 The Balance Amount in Balance Currency (no decimals implied)
Balance Sign
Balance Amount
2.27.3.4. Section 4 - Additional Data
Message Type: 0100, 0200, 0220, 0320, 0110, 0210, 0310, 0510 and 0810
The additional data can consist of one or more of the following fields immediately following each other.
Each of the fields contains its own length indicator to allow any fields that are not recognized by the host to
be stepped over and ignored, with any following fields still being processed successfully.
Field
Length Attribute
Additional Data (1)
Additional Data (2)
.
.
.
.
.
.
Additional Data (x)
Attribute
n3
.
.
.
.
.
.
Bytes
2
var
var
.
.
.
.
.
.
var
Values
„0LLL‟ – BCD length of the data to follow
First additional data element
Second additional data elements
The additional data can be any number of data elements in any
order. Each data element contains its own identifier and length.
Unknown elements may be skipped over.
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 20-48
POSLine ISO8583 Interface Specifications
2.27.3.4.1.
P2P Data (10)
Message type '0200', processing code '10' (Deprecated refer to P2P Data (11), Only for ON-US)
Field 063 is used to carry the sender‟s and recipient‟s information, such as the card number to be credited
(recipient). For this purpose, a new usage is defined for this field, called “P2P Data” with table ID “10”:
Field
Additional Data Length
Table Id
Request Processing
Recipient Account Number
Sender Reference Number
Sender Name
Attribute
n4
ans 2
Bytes
2
2
Values
„0LLL‟ – BCD length of the data to follow.
„10‟ – P2P Data.
n 19
ans 16
ans 51
19
16
51
Sender Address
ans 40
40
Sender City
ans 25
25
Sender State/Province
a2
2
Sender Country
a3
3
The card number to be credited. Mandatory.
The sender‟s reference number.
This tag contains the sender‟s name in the following
format:
- First Name
- Space (as a delimiter)
- Last Name
e.g. “John Doe”
Optional*.
The sender‟s address.
Optional*.
The sender‟s city.
Optional*.
The sender‟s State/Province when sender‟s country is
USA or CAN.
Optional*.
The sender‟s 3-digit numeric country code.
Optional*.
* If any of the optional fields is used, all preceding optional unused fields must be filled with spaces. The length
indicator must be accounting for all data, up-to the last used field.
2.27.3.4.2.
P2P/Payment Data (11)
Message type '0200', processing code '10xxxx', „50xxxx‟
Field 063 is used to carry the sender‟s and recipient‟s information.The data of the field will be in TLV
format.
Field
Additional Data Length
Table Id
Request Processing
Tag
Length
Value
Attribute
n4
ans 2
Bytes
2
2
Values
„0LLL‟ – BCD length of the data to follow.
„11‟ – P2P/Payment Data.
an2
n2
ans
tag from the list below
„LL‟ – BCD length of the Value to follow
values, as described in the table below
Tag
an2
2
1
up to 99
…
2
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
tag from the list below
02 July 2013
Page 21-48
POSLine ISO8583 Interface Specifications
Length
Value
n2
ans
1
up to 99
„LL‟ – BCD length of the Value to follow
values, as described in the table below
The next tags are supported:
Tag
01
Format
ans 16
Field Name
Sender Reference Number
Description
Provided by the originator and uniquely
identifies the sender
(Required if Tag 02 not present.)
02
ans 34
Sender Account Number
03
04
05
06
07
21
22
23
24
ans 30
ans 50
ans 25
ans 3
ans 3
ans 10
ans 20
ans 45
Ans2
Sender Name
Sender Address
Sender City
Sender State
Sender Country
ZIP/Postal Code
Recipient Telephone Number
Text Message
Source of Funds
Contains the sender‟s card number or bank
account number from which the funds are to be
taken (debited).
(Required if Tag 01 not present)
Required for International
Required for International
Required for International
Required for International
Required for International
Required for International
Optional
Optional
Indicates the method used by the
sender to fund the payment:
Value
01
02
03
04
05
06
Description
Credit Card
Debit Card
Prepaid Card
Cash
Debit/Saving/Checking
Account
Credit Account other
than those linked to a
Credit Card.
Required for International (U.S. recipient
Issuers)
F2
Ans19
Receiver Card Number
Card that will receive the funds (to be credited)
Required for P2P
Note:
For Payment transaction, the receiver card is in
Field 2 and this tag is not used.
2.27.3.4.3.
CVV2 DATA (16)
Field
Additional Data Length
Attribute
n4
Bytes
2
Values
„0LLL‟ – BCD length of the data to follow
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 22-48
POSLine ISO8583 Interface Specifications
Table Id
Request Processing
Request Value
ans 2
2
„16‟ – CVV2 data
an 6
6
The 6 character CVV2 Request Value sent to the Host
Position 1
0 – CVV2 Value is intentionally not provided
1 – CVV2 Value is Present
2 – CVV2 Value is Present but illegible
9 – Cardholder states that no CVV2 value is imprinted
Position 2
0 – Only the normal Response Code should be returned
1 – Both the Response Code and the CVV2 Result Code should
be returned
Positions 3 - 6
The CVV2 Value as imprinted on the card
(right – justify and space fill the entry)
If position 1 = 0, 2, or 9, positions 3 – 6 should be space filled
Response Processing
Result Code
an 1
1
The 1 character CVV2 Result Code returned from the Host
M – CVV2 Match
N – CVV2 No Match
P – Not Processed
S – Merchant has indicated that CVV2 is not present on card
U – Issuer is not certified and / or has not provided Visa
encryption keys
2.27.3.4.4.
AMEX 4DBC (17)
Field
Additional Data Length
Table Id
Value
2.27.3.4.5.
Attribute
n4
ans 2
an 4
Bytes
2
2
4
Values
„0LLL‟ – BCD length of the data to follow
„17‟ – AMEX 4DBC
The 4DBC figure as it is printed on the AMEX Card
Installment Data (90)
Field
Additional Data Length
Table Id
Request Processing
Request Value
Attribute
n4
ans 2
an 4
Bytes
2
2
Values
„0LLL‟ – BCD length of the data to follow
„90‟ – Installment data
4
Positions 1 – 4
Loan Period in months with leading zeros
(For example: „0012‟ for 12 months)
Positions 5 – 8
Offset Period in months with leading zeros
(For example: „0012‟ for 12 months)
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
an4
4
Page 23-48
POSLine ISO8583 Interface Specifications
Response Processing
Result Code
an 40
40
Result returned from the Host for terminal prints
Positions 1 – 4
Loan Period
(For example: „0012‟ for 12 months)
Positions 4 – 16
Interest Rate
(For example: „00000002.000‟ for 2 %)
Positions 17 – 28
Amount of Monthly Amortization
Positions 29 – 40
Full Amount Including Interest
2.27.3.4.6.
Payment Indicator (60)
Field
Additional Data Length
Table Id
Request Processing
Request Value
2.27.3.4.7.
Field
an 1
Bytes
2
2
1
Values
„0LLL‟ – BCD length of the data to follow
„60‟ – Payment Indicator
„0‟ or not existing „1‟
„2‟
Refund Transaction
Payment transaction
Recurring Payment
Comment [C5]: TO BE IMPLEMETED
Comment [C6]: TO BE
IMPLEMENTED
New PIN (77)
Field
Additional Data Length
Table Id
Request Processing
Value
2.27.3.4.8.
Attribute
n4
ans 2
Attribute
n4
ans 2
an 16
Bytes
2
2
16
Values
„0LLL‟ – BCD length of the data to follow
„77‟ – New PIN Block encrypted under TPK (Same as Field 52)
New PIN Block in ASCII representation of HEX
Comment [C7]: TO BE
IMPLEMENTED
Additional Fee Data (44)
Attribute
Bytes
Values
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 24-48
POSLine ISO8583 Interface Specifications
Additional Data Length
Table Id
Response Processing
Value
n4
ans 2
2
2
„0LLL‟ – BCD length of the data to follow
„44‟ – Fee Amount that relates to this transaction
an 12
12
The Additional Fee is present in the responses (0210, 0110) for
ON-US authorizations only and if the Authorization Fee Module
has been licensed.
It contains the information about Fee associated with the
transaction from Issuer site, in the format:
cccSdddddddd
where
ccc is Fee currency (Numeric ISO)
S is the Sign flag and can have the values C (for
Credit Fee) or D (for Debit Fee)
dddddddd is the Fee amount with implied decimal
points in Fee currency.
2.27.3.4.9.
Comment [CS8]: To be implemented
KSN (33)
Field
Additional Data Length
Table Id
Request Processing
Request Value
Attribute
n4
ans 2
an 16
Bytes
2
2
Values
„0LLL‟ – BCD length of the data to follow
„33‟ – Key Serial Number(KSN)
16
The KSN up to 16 hexadecimal characters
Comment [CS9]: To be implemented
2.27.3.4.10. Terminal Serial Number (18)
Field
Additional Data Length
Table Id
Value
Attribute
n4
ans 2
an 25
Bytes
2
2
25
Values
„0LLL‟ – BCD length of the data to follow
„18‟ – Terminal Serial Number
The Terminal Serial Number up to 25 characters
2.28. Key Fields
The key fields are used to find any related transactions (0220, 0320, 400) to an original transaction (0100, 0200). These fields
needs to be echoed back to the response of any request and must have the same value of the original transaction (0100 or
0200)
Possible options are:
- Field 62 (Invoice/ECR Reference Number)
- Fields 12 Local Time, and 13 Local Date
OR
The table below shows the key fields used based on the existence of the fields 62, 12 and 13.
Fields 12 and 13 Present
Field 62 Present
Key field to be used: Field 62
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
Field 62 NOT present
Key field to be used: Fields 12 and 13
02 July 2013
Page 25-48
POSLine ISO8583 Interface Specifications
Field 12 and/or 13 NOT Present
Key field to be used: Field 62
INVALID CASE:
Field 62 must be present OR
Fields 12 and 13 must be present
3. Transaction Format Definitions
The following sections define the transactions that are used by the Host
3.1.
Authorization/ Preauthorization
Bit Data Element Name
Message Type Id
Bit Map
02 Primary Acct. Num.
03 Processing Code
04
11
12
13
14
22
24
25
28
35
37
38
39
41
42
43
45
48
49
52
53
54
55
60
61
62
63
64
3.2.
Attribute Request
N
4
0100
b
64
M
n
..19
C01
n
6 00a00x
or
30a00x
Amount, Trans.
n
12
M
Systems Trace No
n
6
M
Time, Local Trans.
n
6
K
Date, Local Trans.
n
4
K
Date, Expiration
n
4
C02
POS Entry Mode
n
3
C05
NII
n
3
M
POS Condition Code n
2
00
Fee Amount
n
12
Track 2 Data
z
..37
C03
Retrieval Ref. No.
an
12
Auth. Id. Response
an
6
Response Code
an
2
Terminal Id
ans
8
M
Card Acq. Id
ans
15
M
Card Acq. Name
ans
40
Track 1 Data
ans ..76
C03
Add. Data – Private
ans ...999
O
Currency Code
n
3
C
PIN Data
b
64
O
Security Control Info n
16
O
Additional Amounts an ...120
ICC Related data
b ...255
C07
Private Use
ans ...999
O
Product Codes
ans ...999
O
Invoice/ECR Ref #
ans ...999
K
Additional Data
ans ...999
O
Message Auth. Code b
64
O
Response Comments
0110
M
00a00x
or
30a00x
O
M
K
K
Authorization
Preauthorization
Amount is verified when included in response
M
O
M
O
M
M
O
O
In case of multi-currency processing (Option 2)
If PINs are selected
Use is application dependant
O
O
If Product codes are selected
K
O
O
If additional data is available
Balance Inquiry/Fee Inquiry
Bit Data Element Name Attribute Request Response Comments
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 26-48
POSLine ISO8583 Interface Specifications
Message Type Id
Bit Map
02 Primary Acct Num.
03 Processing Code
n
b
n
n
04
11
12
13
14
22
24
25
35
37
38
39
41
42
43
45
48
52
53
54
55
60
61
62
63
64
n
n
n
n
n
n
n
n
z
an
an
an
ans
ans
ans
ans
ans
b
n
an
b
ans
ans
ans
ans
b
3.3.
Amount, Trans.
Systems Trace No
Time, Local Trans.
Date, Local Trans.
Date, Expiration
POS Entry Mode
NII
POS Condition Code
Track 2 Data
Retrieval Ref No.
Auth. Id. Response
Response Code
Terminal Id
Card Acq. Id
Card Acq. Name
Track 1 Data
Add. Data - Private
PIN Data
Security Control Info
Additional Amounts
ICC Related data
Private Use
Private Use
Invoice/ECR Ref. #
Additional Data
Message Auth. Code
4
64
..19
6
12
6
6
4
4
3
3
2
..37
12
6
2
8
15
40
..76
...999
64
16
...120
...255
...999
...999
...999
...999
64
0100
M
C01
31a00x
or
32a00x
M
K
K
C02
C05
M
00
C03
M
M
C03
C
O
O
0110
M
31a00x
Or
32a00x
M
M
K
K
M
M
O
M
M
Required for Fee Inquiry
C07
O
O
O
K
O
O
K
O
O
Use is application dependant
Sale / Debit
Bit Data Element Name
Message Type Id
Bit Map
02 Primary Acct Num.
03 Processing Code
04 Amount, Trans.
11 Systems Trace No
12 Time, Local Trans.
13 Date, Local Trans.
14 Date, Expiration
22 POS Entry Mode
24 NII
25 POS Condition Code
28 Fee Amount
35 Track 2 Data
37 Retrieval Ref No.
Attribute Request
n
4
0200
b
64
M
n
..19
C01
n
6 00a00x
n
12
M
n
6
M
n
6
K
n
4
K
n
4
C02
n
3
C05
n
3
M
n
2
00
n
12
z
..37
C03
an
12
Response Comments
0210
M
00a00x
O
M
K
K
M
O
M
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 27-48
POSLine ISO8583 Interface Specifications
38
39
41
42
43
45
48
49
52
53
54
55
60
61
62
63
64
3.4.
Auth. Id. Response
Response Code
Terminal Id
Card Acq. Id
Card Acq. Name
Track 1 Data
Add. Data - Private
Currency Code
PIN Data
Security Control Info
Additional Amounts
ICC Related data
Private Use
Product Codes
Invoice/ECR Ref. #
Additional Data
Message Auth. Code
an
an
ans
ans
ans
ans
ans
n
b
n
an
b
ans
ans
ans
ans
b
6
2
8
15
40
..76
...999
3
64
16
...120
...255
...999
...999
...999
...999
64
M
M
O
M
M
C03
C
O
O
O
C07
O
K
O
O
O
O
In case of multi-currency processing (Option 2)
O
Use is application dependant
O
K
O
O
Refund
Bit Data Element Name
Message Type Id
Bit Map
02 Primary Acct Num.
03 Processing Code
04 Amount, Trans.
11 Systems Trace No
12 Time, Local Trans.
13 Date, Local Trans.
14 Date, Expiration
22 POS Entry Mode
24 NII
25 POS Condition Code
28 Fee Amount
35 Track 2 Data
37 Retrieval Ref No.
38 Auth. Id. Response
39 Response Code
41 Terminal Id
42 Card Acq. Id
43 Card Acq. Name
45 Track 1 Data
48 Add. Data - Private
49 Currency Code
52 PIN Data
53 Security Control Info
54 Additional Amounts
55 ICC Related data
60 Private Use
61 Product Codes
62 Invoice/ECR Ref. #
Attribute Request
n
4
0200
b
64
M
n
..19
C01
n
6 20a00x
n
12
M
n
6
M
n
6
K
n
4
K
n
4
C02
n
3
C05
n
3
M
n
2
00
n
12
z
..37
C03
an
12
an
6
an
2
ans
8
M
ans
15
M
ans
40
ans ..76
C03
ans ...999
n
3
C
b
64
O
n
16
O
an ...120
b ...255
C07
ans ...999
ans ...999
O
ans ...999
K
Response Comments
0210
M
20a00x
O
M
K
K
M
O
M
O
M
M
O
O
In case of multi-currency processing (Option 2)
O
Use is application dependant
O
K
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 28-48
POSLine ISO8583 Interface Specifications
63 Additional Data
64 Message Auth. Code
3.5.
O
O
O
O
Cash
Bit Data Element Name
Message Type Id
Bit Map
02 Primary Acct Num.
03 Processing Code
04 Amount, Trans.
11 Systems Trace No
12 Time, Local Trans.
13 Date, Local Trans.
14 Date, Expiration
22 POS Entry Mode
24 NII
25 POS Condition Code
28 Fee Amount
35 Track 2 Data
37 Retrieval Ref No.
38 Auth. Id. Response
39 Response Code
41 Terminal Id
42 Card Acq. Id
43 Card Acq. Name
45 Track 1 Data
48 Add. Data - Private
49 Currency Code
52 PIN Data
53 Security Control Info
54 Additional Amounts
55 ICC Related data
60 Private Use
61 Product Codes
62 Invoice/ECR Ref. #
63 Additional Data
64 Message Auth. Code
3.6.
ans ...999
b
64
Attribute Request
n
4
0200
b
64
M
n
..19
C01
n
6 01a00x
n
12
M
n
6
M
n
6
K
n
4
K
n
4
C02
n
3
C05
n
3
M
n
2
00
n
12
z
..37
C03
an
12
an
6
an
2
ans
8
M
ans
15
M
ans
40
ans ..76
C03
ans ...999
n
3
C
b
64
O
n
16
O
an ...120
b ...255
C07
ans ...999
ans ...999
O
ans ...999
K
ans ...999
O
b
64
O
Response Comments
0210
M
Attribute Request
n
4
0200
b
64
M
n
..19
C01
n
6 09a00x
n
12
M
n
6
M
n
6
K
n
4
K
n
4
C02
Response Comments
0210
M
01a00x
O
M
K
K
M
O
M
O
M
M
O
O
In case of multi-currency processing (Option 2)
O
Use is application dependant
O
K
O
O
Sale & Cash
Bit Data Element Name
Message Type Id
Bit Map
02 Primary Acct Num.
03 Processing Code
04 Amount, Trans.
11 Systems Trace No
12 Time, Local Trans.
13 Date, Local Trans.
14 Date, Expiration
09a00x
O
M
K
K
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 29-48
POSLine ISO8583 Interface Specifications
22
24
25
28
35
37
38
39
41
42
43
45
48
49
52
53
54
55
60
61
62
63
64
POS Entry Mode
NII
POS Condition Code
Fee Amount
Track 2 Data
Retrieval Ref No.
Auth. Id. Response
Response Code
Terminal Id
Card Acq. Id
Card Acq. Name
Track 1 Data
Add. Data - Private
Currency Code
PIN Data
Security Control Info
Additional Amounts
ICC Related data
Private Use
Product Codes
Invoice/ECR Ref. #
Additional Data
Message Auth. Code
n
n
n
n
z
an
an
an
ans
ans
ans
ans
ans
n
b
n
an
b
ans
ans
ans
ans
b
3
3
2
12
..37
12
6
2
8
15
40
..76
...999
3
64
16
...120
...255
...999
...999
...999
...999
64
C05
M
00
M
O
C03
M
M
M
O
M
M
C03
C
O
O
M
C07
O
K
O
O
O
O
O
In case of multi-currency processing (Option 2)
Use is application dependant
Contains cash component of transaction
O
K
O
O
3.7.
Off-line Sale
Offline Sale to $0.00 implies a reversed offline sale acknowledgement
Bit Data Element Name
Message Type Id
Bit Map
02 Primary Acct Num.
03 Processing Code
04 Amount, Trans.
11 Systems Trace No
12 Time, Local Trans.
13 Date, Local Trans.
14 Date, Expiration
22 POS Entry Mode
24 NII
25 POS Condition Code
35 Track 2 Data
37 Retrieval Ref No.
38 Auth. Id. Response
39 Response Code
41 Terminal Id
42 Card Acq. Id
43 Card Acq. Name
45 Track 1 Data
48 Add. Data - Private
Attribute Request
n
4
0220
b
64
M
n
..19
C06
n
6 00a00x
n
12
M
n
6
M
n
6
K
n
4
K
n
4
C06
n
3
C05
n
3
M
n
2
00
z
..37
an
12
an
6
M
an
2
ans
8
M
ans
15
M
ans
40
ans ..76
ans ...999
Response Comments
0230
M
00a00x
O
M
K
K
M
M
M
M
Host should always send „00‟ response code
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 30-48
POSLine ISO8583 Interface Specifications
49
52
53
54
55
60
61
62
63
64
3.8.
Currency Code
PIN Data
Security Control Info
Additional Amounts
ICC Related data
Private Use
Product Codes
Invoice/ECR Ref. #
Additional Data
Message Auth. Code
n
b
n
an
b
ans
ans
ans
ans
b
3
64
16
...120
...255
...999
...999
...999
...999
64
C
O
In case of multi-currency processing (Option 2)
O
O
Use is application dependant
C07
O
O
K
O
O
K
O
O
Off-line Refund
Bit Data Element Name
Message Type Id
Bit Map
02 Primary Acct Num.
03 Processing Code
04 Amount, Trans.
11 Systems Trace No
12 Time, Local Trans.
13 Date, Local Trans.
14 Date, Expiration
22 POS Entry Mode
24 NII
25 POS Condition Code
35 Track 2 Data
37 Retrieval Ref No.
38 Auth. Id. Response
39 Response Code
41 Terminal Id
42 Card Acq. Id
43 Card Acq. Name
45 Track 1 Data
48 Add. Data - Private
49 Currency Code
52 PIN Data
53 Security Control Info
54 Additional Amounts
55 ICC Related data
60 Private Use
61 Product Codes
62 Invoice/ECR Ref. #
63 Additional Data
64 Message Auth. Code
Attribute Request
n
4
0220
b
64
M
n
..19
C06
n
6 20a00x
n
12
M
n
6
M
n
6
K
n
4
K
n
4
C06
n
3
C05
n
3
M
n
2
00
z
..37
an
12
an
6
M
an
2
ans
8
M
ans
15
M
ans
40
ans ..76
ans ...999
n
3
C
b
64
n
16
O
an ...120
b ...255
C07
ans ...999
ans ...999
O
ans ...999
K
ans ...999
O
b
64
O
Response Comments
0230
M
20a00x
O
M
K
K
M
M
M
M
Host should always send „00‟ response code
O
In case of multi-currency processing (Option 2)
O
Use is application dependant
O
K
O
O
3.9.
Adjust, Sale
An adjustment to $0.00 implies a void transaction.
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 31-48
POSLine ISO8583 Interface Specifications
Bit Data Element Name
Message Type Id
Bit Map
02 Primary Acct Num.
03 Processing Code
04 Amount, Trans.
11 Systems Trace No
12 Time, Local Trans.
13 Date, Local Trans.
14 Date, Expiration
22 POS Entry Mode
24 NII
25 POS Condition Code
35 Track 2 Data
37 Retrieval Ref No.
38 Auth. Id. Response
39 Response Code
41 Terminal Id
42 Card Acq. Id
43 Card Acq. Name
45 Track 1 Data
48 Add. Data - Private
49 Currency Code
52 PIN Data
53 Security Control Info
54 Additional Amounts
55 ICC Related data
60 Original Amount
61 Product Codes
62 Invoice/ECR Ref. #
63 Additional Data
64 Message Auth. Code
Attribute Request
n
4
0220
b
64
M
n
..19
C06
n
6 02a00x
n
12
M
n
6
M
n
6
K
n
4
K
n
4
C06
n
3
C05
n
3
M
n
2
00
z
..37
an
12
M
an
6
M
an
2
M
ans
8
M
ans
15
M
ans
40
ans ..76
ans ...999
n
3
C
b
64
n
16
O
an ...120
O
b ...255
C07
ans ...999
O
ans ...999
O
ans ...999
K
ans ...999
O
b
64
O
Response Comments
0230
M
02a00x
O
M
K
K
New transaction amount after adjustment
M
M
Request contains original retrieval reference no.
M
M
Host should always send „00‟ response code
O
In case of multi-currency processing (Option 2)
O
Use is application dependant
O
Original amount before adjustment or void
K
O
O
3.10. Adjust, Credit
An adjustment to $0.00 implies a void transaction.
Bit Data Element Name
Message Type Id
Bit Map
02 Primary Acct Num.
03 Processing Code
04 Amount, Trans.
11 Systems Trace No
12 Time, Local Trans.
13 Date, Local Trans.
14 Date, Expiration
22 POS Entry Mode
24 NII
25 POS Condition Code
Attribute Request
n
4
0220
b
64
M
n
..19
C06
n
6 22a00x
n
12
M
n
6
M
n
6
K
n
4
K
n
4
C06
n
3
C05
n
3
M
n
2
00
Response Comments
0230
M
22a00x
O
M
K
K
M
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 32-48
POSLine ISO8583 Interface Specifications
35
37
38
39
41
42
43
45
48
49
52
53
54
55
60
61
62
63
64
Track 2 Data
Retrieval Ref No.
Auth. Id. Response
Response Code
Terminal Id
Card Acq. Id
Card Acq. Name
Track 1 Data
Add. Data - Private
Currency Code
PIN Data
Security Control Info
Additional Amounts
ICC Related data
Original Amount
Product Codes
Invoice/ECR Ref. #
Additional Data
Message Auth. Code
z
an
an
an
ans
ans
ans
ans
ans
n
b
n
an
b
ans
ans
ans
ans
b
..37
12
6
2
8
15
40
..76
...999
3
64
16
...120
...255
...999
...999
...999
...999
64
M
M
M
M
M
M
Request contains original retrieval reference no.
M
M
Host should always send „00‟ response code
C
O
In case of multi-currency processing (Option 2)
O
O
C07
O
O
K
O
O
O
Use is application dependant
O
Original amount before adjustment or void
K
O
O
3.11. Void, Sale
The Void transaction is used to inform the host that a transaction previously performed at the terminal has
been canceled.
Bit Data Element Name Attribute Request Response Comments
Message Type Id
n
4
0200
0210
Bit Map
b
64
M
M
02 Primary Acct Num.
n
..19
C06
03 Processing Code
n
6 02a00x
02a00x
04 Amount, Trans.
n
12
M
O
11 Systems Trace No
n
6
M
M
12 Time, Local Trans.
n
6
K
K
Request contains original transaction time
13 Date, Local Trans.
n
4
K
K
Request contains original transaction date
14 Date, Expiration
n
4
C06
22 POS Entry Mode
n
3
C05
24 NII
n
3
M
M
25 POS Condition Code n
2
00
35 Track 2 Data
z
..37
37 Retrieval Ref No.
an
12
M
M
Request contains original retrieval reference no.
38 Auth. Id. Response
an
6
O
39 Response Code
an
2
M
41 Terminal Id
ans
8
M
M
42 Card Acq. Id
ans
15
M
43 Card Acq. Name
ans
40
45 Track 1 Data
ans ..76
48 Add. Data - Private
ans ...999
O
49 Currency Code
n
3
C
O
In case of multi-currency processing (Option 2)
52 PIN Data
b
64
O
53 Security Control Info n
16
O
O
Use is application dependant
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 33-48
POSLine ISO8583 Interface Specifications
54
55
60
61
62
63
64
Additional Amounts
ICC Related data
Original Amount
Product Codes
Invoice/ECR Ref. #
Additional Data
Message Auth. Code
an
b
ans
ans
ans
ans
b
...120
...255
...999
...999
...999
...999
64
C07
O
O
K
O
O
O
Original amount before void.
K
O
O
3.12. Void, Credit
The Void transaction is used to inform the host that a transaction previously performed at the terminal has
been canceled.
Bit Data Element Name
Message Type Id
Bit Map
02 Primary Acct Num.
03 Processing Code
04 Amount, Trans.
11 Systems Trace No
12 Time, Local Trans.
13 Date, Local Trans.
14 Date, Expiration
22 POS Entry Mode
24 NII
25 POS Condition Code
35 Track 2 Data
37 Retrieval Ref No.
38 Auth. Id. Response
39 Response Code
41 Terminal Id
42 Card Acq. Id
43 Card Acq. Name
45 Track 1 Data
48 Add. Data - Private
49 Currency Code
52 PIN Data
53 Security Control Info
54 Additional Amounts
55 ICC Related data
60 Original Amount
61 Product Codes
62 Invoice/ECR Ref. #
63 Additional Data
64 Message Auth. Code
Attribute Request
n
4
0200
b
64
M
n
..19
C06
n
6 22a00x
n
12
M
n
6
M
n
6
K
n
4
K
n
4
C06
n
3
C05
n
3
M
n
2
00
z
..37
an
12
M
an
6
an
2
ans
8
M
ans
15
M
ans
40
ans ..76
ans ...999
n
3
C
b
64
O
n
16
O
an ...120
b ...255
C07
ans ...999
O
ans ...999
O
ans ...999
K
ans ...999
O
b
64
O
Response Comments
0210
M
22a00x
O
M
K
K
Request contains original transaction time
Request contains original transaction date
M
M
O
M
M
Request contains original retrieval reference no.
O
O
In case of multi-currency processing (Option 2)
O
Use is application dependant
O
Original amount before void.
K
O
O
Request Contains original ECR
3.13. Reversal
The Reversal message is sent if the terminal sent a transaction request into the network, and did not receive
a valid response before the transaction time-out period expired.
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 34-48
POSLine ISO8583 Interface Specifications
The reversal is sent persistently until a valid response to the reversal is received from the host.
Reversals will only be sent for on-line financial transaction messages.
Bit Data Element Name
Message Type Id
Bit Map
02 Primary Acct Num.
03 Processing Code
04 Amount, Trans.
11 Systems Trace No
12 Time, Local Trans.
13 Date, Local Trans.
14 Date, Expiration
22 POS Entry Mode
24 NII
25 POS Condition Code
35 Track 2 Data
37 Retrieval Ref No.
38 Auth. Id. Response
39 Response Code
41 Terminal Id
42 Card Acq. Id
43 Card Acq. Name
45 Track 1 Data
48 Add. Data - Private
49 Currency Code
52 PIN Data
53 Security Control Info
54 Additional Amounts
55 ICC Related data
60 Private Use
61 Product Codes
62 Invoice/ECR Ref. #
63 Additional Data
64 Message Auth. Code
3.14.
Attribute Request
n
4
0400
b
64
M
n
..19
C01
n
6
M
n
12
M
n
6
M
n
6
K
n
4
K
n
4
C02
n
3
C05
n
3
M
n
2
M
z
..37
C03
an
12
an
6
an
2
ans
8
M
ans
15
M
ans
40
ans ..76
C03
ans ...999
n
3
C
b
64
O
n
16
O
an ...120
b ...255
C07
ans ...999
ans ...999
O
ans ...999
K
ans ...999
O
b
64
O
Response Comments
0410
M
M
O
M
K
K
Same as original processing code
Same as original
Same as original
M
M
O
M
M
Host should always send „00‟ response code
O
In case of multi-currency processing (Option 2)
O
Use is application dependant
O
K
O
O
Same as original
Test Transaction
Bit Data Element Name Attribute Request Response Comments
Message Type Id
n
4
0800
0810
Bit Map
b
64
M
M
02 Primary Acct Num.
n
..19
03 Processing Code
n
6 99000x
99000x
04 Amount, Trans.
n
12
11 Systems Trace No
n
6
12 Time, Local Trans.
n
6
M
13 Date, Local Trans.
n
4
M
14 Date, Expiration
n
4
22 POS Entry Mode
n
3
24 NII
n
3
M
M
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 35-48
POSLine ISO8583 Interface Specifications
25
35
37
38
39
41
42
43
45
48
52
53
54
60
61
62
63
64
POS Condition Code
Track 2 Data
Retrieval Ref No.
Auth. Id. Response
Response Code
Terminal Id
Card Acq. Id
Card Acq. Name
Track 1 Data
Add. Data - Private
PIN Data
Security Control Info
Additional Amounts
Private Use
Private Use
Private Use
Private Use
Message Auth. Code
n
z
an
an
an
ans
ans
ans
ans
ans
b
n
an
ans
ans
ans
ans
b
2
..37
12
6
2
8
15
40
..76
...999
64
16
...120
...999
...999
...999
...999
64
M
O
M
O
O
O
O
Use is application dependant
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 36-48
POSLine ISO8583 Interface Specifications
3.15. Please Wait Advice
This is an unsolicited Host message that causes the terminal to display „Please Wait‟ and to extend its
transaction time-out. There is no corresponding request message for the please wait response.
Bit Data Element Name
Message Type Id
Bit Map
02 Primary Acct Num.
03 Processing Code
04 Amount, Trans.
11 Systems Trace No
12 Time, Local Trans.
13 Date, Local Trans.
14 Date, Expiration
22 POS Entry Mode
24 NII
25 POS Condition Code
35 Track 2 Data
37 Retrieval Ref No.
38 Auth. Id. Response
39 Response Code
41 Terminal Id
42 Card Acq. Id
43 Card Acq. Name
45 Track 1 Data
48 Add. Data - Private
52 PIN Data
53 Security Control Info
54 Additional Amounts
60 Private Use
61 Private Use
62 Private Use
63 Private Use
64 Message Auth. Code
3.16.
Attribute Request
n
4
b
64
n
..19
n
6
n
12
n
6
n
6
n
4
n
4
n
3
n
3
n
2
z
..37
an
12
an
6
an
2
ans
8
ans
15
ans
40
ans ..76
ans ...999
b
64
n
16
an ...120
ans ...999
ans ...999
ans ...999
ans ...999
b
64
Response Comments
0830
M
Attribute Request
n
4
0500
b
64
M
n
..19
n
6 92000x
n
12
n
6
M
n
6
n
4
n
4
n
3
n
3
M
Response Comments
0510
M
900001
M
M
M
O
Use is application dependant
Settlement
Bit Data Element Name
Message Type Id
Bit Map
02 Primary Acct Num.
03 Processing Code
04 Amount, Trans.
11 Systems Trace No
12 Time, Local Trans.
13 Date, Local Trans.
14 Date, Expiration
22 POS Entry Mode
24 NII
92000x
M
M
M
M
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 37-48
POSLine ISO8583 Interface Specifications
25
35
37
38
39
41
42
43
45
48
52
53
54
60
61
62
63
64
POS Condition Code
Track 2 Data
Retrieval Ref No.
Auth. Id. Response
Response Code
Terminal Id
Card Acq. Id
Card Acq. Name
Track 1 Data
Add. Data - Private
PIN Data
Security Control Info
Additional Amounts
Batch Number
Private Use
Private Use
Totals/Resp Text
Message Auth. Code
n
z
an
an
an
ans
ans
ans
ans
ans
b
n
an
ans
ans
ans
ans
b
2
..37
12
6
2
8
15
40
..76
...999
64
16
...120
...999
...999
...999
...999
64
M
M
M
M
M
O
O
O
M
M
O
Use is application dependant
Settlement batch number
O
O
Host response text is returned
3.17. Settlement Trailer
If the host requests the terminal to upload its batch, the terminal sends the settlement trailer following the
upload.
Bit Data Element Name Attribute Request Response Comments
Message Type Id
n
4
0500
0510
Bit Map
b
64
M
M
02 Primary Acct Num.
n
..19
03 Processing Code
n
6 96000x
96000x
04 Amount, Trans.
n
12
11 Systems Trace No
n
6
M
M
12 Time, Local Trans.
n
6
M
13 Date, Local Trans.
n
4
M
14 Date, Expiration
n
4
22 POS Entry Mode
n
3
24 NII
n
3
M
M
25 POS Condition Code n
2
35 Track 2 Data
z
..37
37 Retrieval Ref No.
an
12
M
38 Auth. Id. Response
an
6
39 Response Code
an
2
M
41 Terminal Id
ans
8
M
M
42 Card Acq. Id
ans
15
M
43 Card Acq. Name
ans
40
45 Track 1 Data
ans ..76
48 Add. Data - Private
ans ...999
O
52 PIN Data
b
64
53 Security Control Info n
16
O
O
Use is application dependant
54 Additional Amounts an ...120
60 Batch Number
ans ...999
M
Settlement batch number
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 38-48
POSLine ISO8583 Interface Specifications
61
62
63
64
Private Use
Private Use
Totals/Resp Text
Message Auth. Code
ans ...999
ans ...999
ans ...999
b
64
M
O
O
O
Host response text is returned
3.18. Batch Upload
This is the transaction set used to perform a batch up load. This occurs when the terminal and host are out
of balance or store and forward configuration.
Bit Data Element Name
Message Type Id
Bit Map
02 Primary Acct Num.
03 Processing Code
04 Amount, Trans.
11 Systems Trace No
12 Time, Local Trans.
13 Date, Local Trans.
14 Date, Expiration
22 POS Entry Mode
24 NII
25 POS Condition Code
35 Track 2 Data
37 Retrieval Ref No.
38 Auth. Id. Response
39 Response Code
41 Terminal Id
42 Card Acq. Id
43 Card Acq. Name
45 Track 1 Data
49 Currency Code
52 PIN Data
53 Security Control Info
54 Additional Amounts
55 ICC Related data
60 Original Data
61 Product Codes
62 Invoice/ECR Ref. #
63 Additional Data
64 Message Auth. Code
Attribute Request
n
4
0320
b
64
M
n
..19
C06
n
6
M
n
12
M
n
6
M
n
6
K
n
4
K
n
4
C06
n
3
M
n
3
M
n
2
M
z
..37
an
12
M
an
6
O
an
2
O
ans
8
M
ans
15
M
ans
40
ans ..76
n
3
C
b
64
n
16
O
an ...120
O
b ...255
C07
ans ...999
O
ans ...999
O
ans ...999
K
ans ...999
O
b
64
O
Response Comments
0330
M
M
O
M
K
K
Same as original transaction
M
M
M
If original response code is not present, assume „00‟
O
In case of multi-currency processing (Option 2)
O
Use is application dependant
O
K
O
O
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 39-48
POSLine ISO8583 Interface Specifications
4. Message Flows
4.1.
MESSAGE TYPE:
0100
POSLINE
0100
POS
Terminal
0100
Not Data Capture
0110
0110
4.2.
MESSAGE TYPE:
0200
POS
Terminal
0200
POSLINE
0100
BASE I
Data Capture
0210
4.3.
BASE I
MESSAGE TYPE:
0200
0110
0200 - REFUND
POSLINE
BASE I
POS
Terminal
Data Capture
0210
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 40-48
POSLine ISO8583 Interface Specifications
4.4.
MESSAGE TYPE:
0200
0200 - VOID REFUND
POSLINE
BASE I
POS
Terminal
Data Capture
0210
4.5.
MESSAGE TYPE:
0100
0200 - VOID SALE
POSLINE
0400
BASE I
POS
Terminal
Data Capture
0110
4.6.
MESSAGE TYPE:
0220
POS
Terminal
0410
0220
POSLINE
Data Capture
BASE I
0230
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 41-48
POSLine ISO8583 Interface Specifications
4.7.
MESSAGE TYPE:
0400
POS
Terminal
0400 - REVERSAL
POSLINE
Data Capture - Response is “00”
MESSAGE TYPE:
0500
POS
Terminal
BASE I
0410
0410
4.8.
0400
0500 - SETTLEMENT
POSLINE
BASE I
Not Data Capture
0510
4.9.
MESSAGE TYPE:
0320
0320 - BATCH UPLOAD
POSLINE
BASE I
POS
Terminal
Data Capture
0330
4.10.
MESSAGE TYPE:
0800
0800
POSLINE
BASE I
POS
Terminal
Not Data Capture
0810
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 42-48
POSLine ISO8583 Interface Specifications
4.11.
MESSAGE TYPE:
0830
POSLINE
BASE I
POS
Terminal
Not Data Capture, initiated by
Interface
0830
5. Settlement Process Flow
The terminal contains all the financial transactions expected to be settled. The terminal will ensure all unresolved advices are
sent to the host prior to the settlement transaction. This is done to ensure the hosts batch is up to date and in balance when the
transaction is received.
5.1.
Balanced Settlement
0500
POSLINE
POS
Terminal
0510
5.2.
Balanced Settlement With Advices
All unresolved advices are sent up to the host after the user settles to the terminal and before the settlement transaction is
sent.
0220
POS
Terminal
POSLINE
0230
…
0500
0510
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 43-48
POSLine ISO8583 Interface Specifications
5.3.
Out Of Balance Settlement
If the Host can not reconcile with the Totals received in the 0500 message of the terminal then it will
respond with Response Code 95. Then the Terminal should start to upload the financial transactions using
0320 messages. Host will respond to them with the 0330 message and the terminal should wait for the
response before sending the next 0320. After all of the financial transactions are uploaded, the terminal
should send a new 0500 message with processing code starting with 96.
If the Host still can not reconcile with the Totals received in the new 0500 then the above sequence
should be repeated until Host is able to reconcile. Host has to perform a successful reconciliation for
the transactions to be captured.
POS
Terminal
0500
0510 (95)
POSLINE
Processing Code:
 92 00 0x (Sett. Request)
 Response Code=95
0320
0330
…
0500
Processing Code:
 96 00 0x (Sett. Request)
 Response Code=00
0510
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 44-48
POSLine ISO8583 Interface Specifications
5.4.
Balanced Settlement Or Batch Upload Time Out
When a Settlement Request (0500) times out the terminal will not allow the batch to be changed in any matter and the
only functionality available should be to repeat the settlement.
When a Batch Upload Request (0320) times out the terminal will not allow the batch to be changed in any matter and
the only functionality available should be to repeat the settlement.
5.5.
Delayed Settlement
If the Host after it receives the Settlement Request (0500), it detects that the Reconciliation will take more time than the
Timeout of the Terminal, it will send an unsolicited “Please Wait Advice” (0830). On ce the Terminal receives this message,
it should restart its internal timer providing to the Host some more time to respond to the reconciliation message before the
Terminal times out.
The Host may repeat the 0830 message up to a specific number of times. If the Reconciliation process in not even in a
specific time, Host will respond with 91 in the Reconciliation respond.
POS
Terminal
0500
POSLINE
Processing Code:
 92 00 0x (Sett. Request)
0830
Delay Detected
0830
0510
Delay Detected
Processing Code:
 96 00 0x (Sett. Request)
 Response Code=00
6. Multicurrency Processing
6.1.
Option 1. Standard.
If Currency Code is not sent in the Request Message, the Host must use its database to decide on the Currency of the
transaction.
At the Host level, each Terminal ID can have only one Currency Code assigned.
Therefore, when the Multicurrency option is enabled at the Terminal Level, the Terminal must be sending a different
Terminal ID (field 41) for each currency that is supported by the Terminal software.
Settlement is also performed by Terminal ID so in this case, Multiple Settlements (one for each Currency) must be initiated
from the Terminal for the transactions to be captured.
In this case Field 63 format specified in Section 2.26.3.1 should be used.
6.2.
Option 2. Multi-currency merchant
If the same Merchant and Terminal ID are used with different currencies, Currency Code field should be presented in
Request Message.
In this case Field 63 format specified in Section 2.26.3.2 should be used.
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 45-48
POSLine ISO8583 Interface Specifications
7. Payment System Support
Payment System
VISA
VISA SMS
MasterCard
MDS
ONX
EuroPay
AMEX
Support







8. Installment Processing
When the Host receives an installment transaction, POSLINE verifies that the installment data are valid accordingly to
merchant‟s installment setup. If one of the installment checks fails, POSLINE responds with an error message. On the traffic
screen of POSLINE a message is displayed showing an error number, which corresponds to the description of why the
installment request was declined.
Errors returned by PHIM regarding installment requests:
Error Number
0
1
2
3
4
5
6
7
8
9
10
Description
Installment transactions not allowed for merchant
Installment request‟s loan period not set
Installment request‟s loan period not set equals to zero 0.
Installment request‟s loan period exceeds maximum allowed loan period for merchant
Installment request‟s loan period exceeds minimum allowed loan period for merchant.
Installment request‟s offset period exceeds maximum allowed offset period for merchant
Buy Now/Pay Later option not enable for merchant
Error during currency conversion
Monthly installment amount exceeds maximum monthly amount allowed for merchant
Monthly installment amount exceeds minimum monthly amount allowed for merchant
Installment request‟s transaction amount exceeds installment floor limit allowed for merchant.
0200
POS
Terminal
0210 (00)
POSLINE
 Field 63, set for installment
request
 Field 03, 00 x0 xx (Purchase)
 Response Code=00
0100
0110 (00)
BASE I


0200
0210 (12)
…

 Field 63, set for installment
request
 Field 03, 00 x0 xx (Purchase)
 Response Code=12
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Field 048, set
with installment
data
Field 03, 00 x0
xx (Purchase)
Response
Code=00
Page 46-48
POSLine ISO8583 Interface Specifications
9. OTB-Settlement Table
Transaction
Message Type
Authorisation
Pre-Authorisation
Balance Inquiry
Fee inquiry
Check Verification
Card Verification
Sale
Refund
Cash
Sale & Cash
Void, Sale, on-line
Void, Refund, on-line
Off-line Sale
Off-line Refund
Sales Completion
Adjust, Sale
(void off-line)
Adjust, Refund
(void off-line)
Off-line Sale with zero
amount (Reversed
Offline Sale,
Acknowledgement)
Guaranteed Late Arrival
Reversal
0100
Settlement Request
0500
0200
0220
0400
Settlement, after upload
Batch Down Line Load
Batch upload
0320
Processing
Code
00 a0 0x
30 a0 0x
31 a0 0x
32 a0 0x
04 a0 0x
38 a0 0x
00 a0 0x
20 a0 0x
01 a0 0x
09 a0 0x
02 a0 0x
22 a0 0x
00 a0 0x
20 a0 0x
00 a0 0x
02 a0 0x
OTB
change
(Send to
Issuer)
db
db
0
0
Db
Db
Db
Db
Cr
-
Settlement
(Included in
the EDC
file)
db
cr
db
db
cr
db
db
cr
db
db/cr
22 a0 0x
-
cr/db
00 a0 0x
-
-
cr/db
cr/db
-
Confirms
the
settlement
Confirms
the
settlement
for the
second time
db/cr
90 a0 0x
Same as
original
transaction
92 00 0x
96 00 0x
-
95 00 0x
Same as
original
-
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
02 July 2013
Page 47-48
POSLine ISO8583 Interface Specifications
Signature Data
Statistics
Logon
Initialisation
Test Transaction
Please Wait Advice
Features
1. Dual Currency Terminals
0320
0800
0830
transaction
90 00 0x
91 00 0x
92 00 0x
93 00 0x
99 00 0x
90 00 0x
-
Terminal ID
The POS Terminal must
be able to send a different
id for each currency
POSLine ISO8583 Specifications (ONLINE 4 12-12) v1.1.docx
-
Merchant ID
The POS Terminal must
be able to send a different
id for each currency
02 July 2013
Page 48-48
Download