Documentation

Defines an interface for authorization messages

Authorization request is used to authenticate the card holder. The following request and response messages are defined based on the ISO 8583-1:2003 standard interchange messaging.

Presence Indicators include mandatory, conditional, optional, echo

Messages must adhere to defined data types and indicators. Request messages are sent from the acquirer, and the response from the issuer. Messages types include 0100, 0110.

🚧

Presence Indicators

These serve as a guide to denote whether a data element should be present in the message.

  • Mandatory: The element is required in the message.
  • Conditional: The element is mandatory under certain conditions
  • Optional: The element is not always required in the message.
  • Echo: In response messages, this code indicates that the response message sender must include the same value it received in the data element in the associated request message. In other words, the responder must echo back the data element if it is present in the request message.

Authorization Request/Repeat (0100)

Authorization request from acquirer.

Bit DataElement NamePresence Indicator
0Primary BitmapMandatory
1Secondary BitmapMandatory
2Primary account numberMandatory
3Processing codeMandatory
4Amount, transactionMandatory
7Transmission date and timeMandatory
11Systems trace audit numberMandatory
12Time, local transactionMandatory
13Date, local transactionConditional
14Date, expirationMandatory
15Merchant’s typeMandatory
18Merchant’s typeMandatory
22POS entry modeMandatory
23Card sequence numberConditional
25POS condition codeMandatory
26POS PIN capture codeConditional
28Amount, transaction feeMandatory
32Acquiring institution id codeMandatory
35Track 2 dataConditional
37Retrieval reference numberMandatory
40Service restriction codeOptional
41Card acceptor terminal idMandatory
42Card acceptor id codeMandatory
43Card acceptor name/locationMandatory
49Currency code, transactionMandatory
52PIN dataConditional
53Security related control informationConditional
54Additional amountsConditional
55Integrated Circuit Card System Related DataConditional
56Message reason codeOptional
59Transport (echo) dataOptional
60Payment InformationConditional
62Private Field, Management Data 1Conditional
102Account identification 1Optional
103Account identification 2Optional
123POS data codeMandatory
124Near Field Communication DataConditional
128Secondary Message Hash ValueMandatory

Request Response (0110)

Authorization response returned by acquirer.

Bit DataElement NamePresence Indicator
0Primary BitmapMandatory
1Secondary BitmapMandatory
2Primary account numberMandatory
3Processing codeMandatory
4Amount, transactionMandatory
7Transmission date and timeMandatory
11Systems trace audit numberMandatory
12Time, local transactionMandatory
13Date, local transactionConditional
14Date, expirationMandatory
15Date, SettlementConditional
18Merchant’s typeMandatory
22POS entry modeMandatory
23Card sequence numberConditional
25POS condition codeMandatory
26POS PIN capture codeConditional
28Amount, transaction feeMandatory
32Acquiring institution id codeMandatory
35Track 2 dataConditional
37Retrieval reference numberMandatory
40Service restriction codeOptional
41Card acceptor terminal idMandatory
42Card acceptor id codeMandatory
43Card acceptor name/locationMandatory
49Currency code, transactionMandatory
52PIN dataConditional
53Security related control informationConditional
54Additional amountsConditional
55Integrated Circuit Card System Related DataConditional
56Message reason codeOptional
59Transport (echo) dataOptional
60Payment InformationConditional
62Private Field, Management Data 1Conditional
102Account identification 1Optional
103Account identification 2Optional
123POS data codeMandatory
124Near Field Communication DataConditional
128Secondary Message Hash ValueMandatory

Authorization Advice/Repeat (0120/0121)

Bit DataElement NamePresence Indicator
0Primary BitmapMandatory
1Secondary BitmapMandatory
2Primary account numberMandatory
3Processing codeMandatory
4Amount, transactionMandatory
7Transmission date and timeMandatory
11Systems trace audit numberMandatory
12Time, local transactionMandatory
13Date, local transactionConditional
14Date, expirationMandatory
15Date, SettlementConditional
18Merchant’s typeMandatory
22POS entry modeMandatory
23Card sequence numberConditional
25POS condition codeMandatory
26POS PIN capture codeConditional
28Amount, transaction feeMandatory
32Acquiring institution id codeMandatory
35Track 2 dataConditional
37Retrieval reference numberMandatory
40Service restriction codeOptional
41Card acceptor terminal idMandatory
42Card acceptor id codeMandatory
43Card acceptor name/locationMandatory
49Currency code, transactionMandatory
52PIN dataConditional
53Security related control informationConditional
54Additional amountsConditional
55Integrated Circuit Card System Related DataConditional
56Message reason codeOptional
59Transport (echo) dataOptional
60Payment InformationConditional
62Private Field, Management Data 1Conditional
102Account identification 1Optional
103Account identification 2Optional
123POS data codeMandatory
124Near Field Communication DataConditional
128Secondary Message Hash ValueMandatory