You are on page 1of 62

SMARTVISTA FRONT END

EXTERNAL INTERFACE SPECIFICATION


ISO-8583 CORE BANKING SYSTEM (CBS)

28.03.2014 10:45:03

Copyright 1999-2011 Banking Production Center

Banking Production Center

Contents
OVERVIEW ....................................................................................................................................... 5
CBSCOMMUNICATION PROTOCOL ......................................................................................... 6
CBS ISO-8583 MESSAGE TYPES .................................................................................................. 7
1.
2.
3.
4.

Authorization Messages ............................................................................................................................................. 7


Reversal Messages ..................................................................................................................................................... 8
Administrative Messages ............................................................................................................................................ 8
Network Management Messages ................................................................................................................................ 8

CBS ISO 8583 MESSAGE FLOWS .............................................................................................. 9


1.
2.
3.

Authorization Messages ............................................................................................................................................. 9


Authorization Advice Messages ................................................................................................................................. 9
Reversal Messages ..................................................................................................................................................... 9

3.1. Normal processing ............................................................................................................... 9


3.2. Time-out processing .......................................................................................................... 10
4.
5.

Administrative Messages .......................................................................................................................................... 11


Network Management Messages .............................................................................................................................. 11

5.1. Normal processing ............................................................................................................. 11


5.2. SAF List End processing ................................................................................................... 12
DATA FIELDS ................................................................................................................................. 14
1.
2.
3.
4.

Data Field Attributes ................................................................................................................................................ 14


Data Field Format..................................................................................................................................................... 14
Data Field Presence Conditions................................................................................................................................ 15
Data Field Description ............................................................................................................................................. 15

4.1.
4.2.
4.3.
4.4.
4.5.
4.6.
4.7.
4.8.
4.9.
4.10.
4.11.
4.12.
4.13.
4.14.
4.15.
4.16.
4.17.
4.18.
4.19.
4.20.

Field 1: Secondary Bit-Map............................................................................................... 15


Field 2: Primary Account Number .................................................................................... 15
Field 3: Processing Code ................................................................................................... 16
Field 4: Amount, Transaction ............................................................................................ 18
Field 5: Amount, Account ................................................................................................. 18
Field 6: Amount, Cardholder Billing................................................................................. 18
Field 9: Conversion Rate, Cardholder Billing ................................................................... 19
Field 10: Conversion Rate, Account ................................................................................. 19
Field 11: Systems Trace Audit Number ............................................................................ 19
Field 12: Time, Local Transaction .................................................................................... 20
Field 14: Date, Expiration ................................................................................................. 20
Field 15: Settlement Date .................................................................................................. 20
Field 18: Merchant Type ................................................................................................... 21
Field 22: Point of Service Date Code ................................................................................ 21
Field 24: Function Code .................................................................................................... 23
Field 32: Acquiring Institution Identification Code .......................................................... 23
Field 37: Retrieval Reference Number .............................................................................. 24
Field 38: Authorisation Identification Response ............................................................... 24
Field 39: Response Code ................................................................................................... 25
Field 41: Card Acceptor Terminal Identification .............................................................. 27

SmartVista Front-End

ISO-8583 CBS INTERFACE


2

Banking Production Center


4.21.
4.22.
4.23.
4.24.
4.25.
4.26.
4.27.
4.28.
4.29.
4.30.
4.31.
4.32.
4.33.
4.34.
4.35.
4.36.

Field 43: Card Acceptor Name and Location .................................................................... 27


Field 48: Additional Data .................................................................................................. 28
Field 49: Currency Code, Transaction ............................................................................... 28
Field 50: Currency Code, Account .................................................................................... 28
Field 51: Currency Code, Cardholder Billing.................................................................... 29
Field 54: Additional Amounts ........................................................................................... 29
Field 61: Additional Amounts and Counters ..................................................................... 33
Field 62: Mini-statement data ............................................................................................ 34
Field 63: Account Balance ................................................................................................ 35
Field 64: Primary MAC Data ............................................................................................ 35
Field 91: Action Code ....................................................................................................... 35
Field 95: Replacement Amounts ....................................................................................... 36
Field 100: SVFE Issuer Institution Identifier .................................................................... 37
Field 102: Account Identification ...................................................................................... 37
Field 103: Account Identification 2 ................................................................................ 37
Field 128: Secondary MAC Data ...................................................................................... 37

MESSAGE FORMATS ................................................................................................................... 40


1.

Authorization Message ............................................................................................................................................. 40

1.1. Request .............................................................................................................................. 40


1.2. Response ............................................................................................................................ 41
2.

Authorization Advice Messages ............................................................................................................................... 42

2.1. Request .............................................................................................................................. 42


2.2. Response ............................................................................................................................ 44
3.

Reversal Messages ................................................................................................................................................... 45

3.1. Request .............................................................................................................................. 45


3.2. Response ............................................................................................................................ 46
4.

Administrative Messages .......................................................................................................................................... 47

4.1. Request .............................................................................................................................. 47


4.2. Response ............................................................................................................................ 47
5.

Network Management Messages .............................................................................................................................. 48

5.1. Request .............................................................................................................................. 48


5.2. Response ............................................................................................................................ 48
MESSAGE MATCHING ................................................................................................................ 49
1.
2.

Message Matching Data Fields................................................................................................................................. 49


Search of original request for responses ................................................................................................................... 49

APPENDIX A (FIELD 48) .............................................................................................................. 50


1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.

Structure Field 48 ..................................................................................................................................................... 50


Structure Tags of Data Field 48 ............................................................................................................................... 50
Tag 001 Settlement type ......................................................................................................................................... 50
Tag 002 SVFE Transaction Type .......................................................................................................................... 50
Tag 004 Full Name ................................................................................................................................................ 50
Tag 005 Credit Type ............................................................................................................................................. 51
Tag 006 Credit Issue Date ..................................................................................................................................... 51
Tag 007 Credit Issue Interval ................................................................................................................................ 51
Tag 008 Credit End Date....................................................................................................................................... 51
Tag 009 Credit Enable Date .................................................................................................................................. 51
Tag 010 Service Identifier ..................................................................................................................................... 52
Tag 011 Service Data ............................................................................................................................................ 52

SmartVista Front-End

ISO-8583 CBS INTERFACE


3

Banking Production Center


13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.

Tag 012 Prepaid Card Type .................................................................................................................................. 52


Tag 013 Contract ID.............................................................................................................................................. 52
Tag 014 Address Verification Data ....................................................................................................................... 52
Tag 015 Postal Code Data ..................................................................................................................................... 52
Tag 016 Installment Payment Quantity ................................................................................................................. 53
Tag 017 Text Information Data ............................................................................................................................. 53
Tag 018 Card status ............................................................................................................................................... 53
Tag 019 Account status ......................................................................................................................................... 54
Tag 020 External code for operation ..................................................................................................................... 54
Tag 021 Customer external account number ......................................................................................................... 54
Tag 022 Customer mobile phone number ............................................................................................................. 54
Tag 023 Account Type .......................................................................................................................................... 55
Tag 090-099 Payment specific data ...................................................................................................................... 55

APPENDIX B (FIELD 54)............................................................................................................... 56


1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.

Structure Field 54 ..................................................................................................................................................... 56


Structure Tags of Data Field 54 ............................................................................................................................... 56
Tag 001 Acquirer Fee Amount .............................................................................................................................. 56
Tag 002 Transaction Amount, Transaction Currency............................................................................................ 56
Tag 003 Transaction Currency .............................................................................................................................. 57
Tag 004 Amount, Credit Initial ............................................................................................................................. 57
Tag 005 Amount, Total Credit .............................................................................................................................. 57
Tag 006 Issuer Fee Amount and Currency ............................................................................................................ 57
Tag 007 Current Account Available Balance and Currency.................................................................................. 58
Tag 008 Amount, Exceed Limit ............................................................................. Error! Bookmark not defined.
Tag 009 Amount, Available Exceed Limit ............................................................................................................ 58

APPENDIX C (FIELD 61) .............................................................................................................. 59


1.
2.
3.
4.
5.

Structure Field 61 ..................................................................................................................................................... 59


Structure Tags of Data Field 61 ............................................................................................................................... 59
Tag 001 Cash-In Counters ..................................................................................................................................... 59
Tag 002 Recycling Counters ................................................................................................................................. 59
Tag 003 Recycling Cash-Out Counters ................................................................................................................. 59

APPENDIX D (FIELD 95) .............................................................................................................. 60


1.
2.
3.
4.
5.
6.
7.
8.

Structure Field 95 ..................................................................................................................................................... 60


Structure Tags of Data Field 95 ............................................................................................................................... 60
Tag 001 Transaction Amount, Transaction Currency............................................................................................ 60
Tag 002 Transaction Amount, Account Currency ................................................................................................. 60
Tag 003 Transaction Amount, Cardholder Billing Currency ................................................................................ 60
Tag 006 Transaction Currency .............................................................................................................................. 60
Tag 007 Account Currency ................................................................................................................................... 61
Tag 008 Cardholder Billing Currency ................................................................................................................... 61

LIST OF REVISIONS ..................................................................................................................... 62

SmartVista Front-End

ISO-8583 CBS INTERFACE


4

Banking Production Center

OVERVIEW
This document describes specifications for the SmartVista Front End (SVFE) Core Banking
System (CBS) external message protocol. The protocol can be used to provide authorization and
information services to card processing hosts or transaction concentrators.
The current software releases are implementing an external message based on the International
Organization for Standardization (ISO) 8583-2:1993 standard.
The message specifications in this manual are applicable to the ISO-based external message only.

SmartVista Front-End

ISO-8583 CBS INTERFACE


5

Banking Production Center

CBSCOMMUNICATION PROTOCOL
CBS Interface supports the TCP/IP transport protocol.
TCP/IP is a point to point communication protocol with a delivery guarantee and data sequence
guarantee. The connection party, which initiates a connection, is a TCP/IP client. The connection
party, which accepts the connection, is a TCP/IP server. TCP/IP client establishes connection
identifying target application with an IP address of the host and a port number within that host. If
the connection is dropped by any reason it should be re-established by the client application.
SVFE host can act in a TCP/IP connection as a client or as a server depending on the host
configuration. For data transmission TCP/IP uses sessions. Each session is a bi-directional data
stream. SVFE protocol uses a single TCP/IP session to transfer data between hosts in both
directions. The continuous TCP/IP data stream is split into frames. Each ISO 8583 message is sent
in a separate frame. A Frame consists of a 2-byte length header and a message body. The header
contains the length of the following message. The high byte of value is transmitted first, and the low
byte of value is transmitted second.
2 bytes
Message Length = N

N bytes
ISO 8583 Message

SmartVista Front-End

ISO-8583 CBS INTERFACE


6

Banking Production Center

CBS ISO-8583 MESSAGE TYPES


Message Class: Authorization
1100 Authorization Request
1110 Authorization Response
1120 Authorization Advice
1130 Authorization Advice Response
Message Class: Reversal
1420 Reversal Advice
1430 Reversal Advice Response
Message Class: Administrative
1600 Administrative Request
1610 Administrative Response
Message Class: Network Management
1804 Network Management Request
1814 Network Management Response

1.

Authorization Messages

1100 Authorization Request


Message Type: 1100
Description: Authorization Request (1100) message requests approval authorization or guarantee
for the transaction to proceed. Authorization Response (1110) is expected in return for 1100
message, either approving or denying the request.
1110 Authorization Response
Message Type: 1110
Description: Authorization Request Response (1110) is returned in response to Authorization
Request (1100) to approve or deny the request.
1120 Authorization Advice
Message Type: 1120
Description: Authorization Advice (1120) advises CBS of a previously completed at SVFE (StandIn processing) transaction. Format and contents of fields at 1120 message are the same as at 1100
message. Each 1120 message must be acknowledged with 1130 message.
1130 Authorization Advice Response
Message Type: 1130
Description: Authorization Advice Response (1130) is used to acknowledge the receipt of
1120 message. Format and contents of fields at 1130 message are the same as at 1110 message.

SmartVista Front-End

ISO-8583 CBS INTERFACE


7

Banking Production Center

2.

Reversal Messages

1420 Reversal Advice Request


Message Type: 1420
Description: Reversal Advice Request (1420) is advice to cancel part or all of a previously
approved transaction. Reversal Advice Response (1430) is expected in return for 1420 message,
either approving the request.
1421 Reversal Advice Repeat
Message Type: 1421
Description: Authorization Request Repeat (1421) is identical to 1420 message, except that
it denotes to the receiver that it is a possible duplicate message. Format and contents of fields at
1421message are the same as at 1420 message. This message is used when an
expected acknowledgement to 1420 message was not received.
1430 Reversal Response
Message Type: 1430
Description: Reversal Response (1430) is used to acknowledge the receipt of 1420 message.

3.

Administrative Messages

1600 Administrative Request


Message Type: 1600
Description: Administrative Request (1600) is used to Reset ATM Counters. Administrative
Response (1610) is expected in return for 1600 message, either approving or denying the request.
1610- Administrative Response
Message Type: 1610
Description: Administrative Transaction Response (1610) is used to acknowledge the receipt of
1600

4.

Network Management Messages

1804 Network Management Request


Message Type: 1804
Description: Network Management Request (1804) message is used to perform echo tests.
1804 message always requires 1814 message in response.
1814 Network Management Response
Message Type: 1814
Description: Network Management Response (1814) message is returned in response to Network
Management Request (1804) message.

SmartVista Front-End

ISO-8583 CBS INTERFACE


8

Banking Production Center

CBS ISO 8583 MESSAGE FLOWS


1.

Authorization Messages

sd Auth
SVFE

CBS

1100()

1110()

2.

Authorization Advice Messages

Message 1121 is sent when there is no response to message 1120. Message 1121 is sent not more
than three times.
Message 1121 is sent 60 seconds after sending message 112X, for which a response has not been
received.
sd Auth Adv ice
SVFE

CBS

1120()

1130()

1121()

1130()

3.

Reversal Messages

3.1. Normal processing

SmartVista Front-End

ISO-8583 CBS INTERFACE


9

Banking Production Center


SVFE sends 1420/1421 messages in case a request for authorization cancellation has been received
from terminal devices and payment networks, or in case of authorization cancellation in SVFE
system in stand-in mode.
Message 1420 is sent 5 seconds after sending the message 1100, for which there was no response.
Message 1421 is sent 60 seconds after sending the message 142X, for which there was no response.
Message 1421 is sent not more than three times. If after sending the last message 1421 there was
still no response, the authorization request, for which there was no response, is considered to be
processed in stand-in mode.
sd Rev ersal
SVFE

CBS

1420()

1430()

1421()

1430()

3.2. Time-out processing


SVFE sends 1420/1421 messages in case the SVFE does not receive a response to 1100 message.
Message 1421 is sent in case the response to message 1420 is not received.

SmartVista Front-End

ISO-8583 CBS INTERFACE


10

Banking Production Center


sd Rev ersal
SVFE

CBS

1420()

1430()

1420()

1430()

1421()

1430()

4.

Administrative Messages

sd Administrativ e
SVFE

CBS

1600()

1610()

5.

Network Management Messages

5.1. Normal processing


The SVFE system periodically sends a message 1804 with a query of type 831 Test of
connection. A repeated message 1804 is sent 60 seconds after sending the message 1804, for which
there was no response. In case there is no response to message 1804, the message 1804 is repeated
not more than three times.
If after the last message 1804 there was no response, or if there was a response message 1814 with
response code other than 000, the SVFE system will send to CBS a message 1804 of query type
802 Sign Off and starts to process authorization requests in stand-in mode.

SmartVista Front-End

ISO-8583 CBS INTERFACE


11

Banking Production Center


sd Netw ork Management SV-CBS
SVFE

CBS

1804()

1804()

1814()

sd Netw ork Management CBS-SV


CBS

SVFE

1804()

1804()

1814()

5.2. SAF List End processing


SAF List End message is used when required notification of CBS about finishing of the Stand-In
processed transactions.
In case of logical connection between SVFE and CBS lost SVFE could process transaction in StandIn mode. After the connection is established the SVFE upload all transactions as advices. When all
transactions are uploaded SVFE sends SAF List End message to inform CBS all the transactions
were uploaded.

SmartVista Front-End

ISO-8583 CBS INTERFACE


12

Banking Production Center


sd SAF List End
CBS

SVFE

Connection Lost
Stand-In processing()

Stand-In processing()
1804(Test of connection)

1814()

1804(Sign-On)

1814()

1120()

1130()

1120()

1130(Last transaction)

1804(SAF List End)

1814()

SmartVista Front-End

ISO-8583 CBS INTERFACE


13

Banking Production Center

DATA FIELDS
1.

Data Field Attributes

Table 1. Data Field Attributes


a

Alphabetic characters only.

Numeric digits only.

Special characters

an

Alphabetic and numeric characters only.

As

Alphabetic and special characters

ns

Numeric digits and special characters

ans

Alphabetic, numeric, and special characters.

Fixed length of 4 characters.

16

Variable length up to a maximum of 16 characters. All variable length fields will also contain two or
three positions at the beginning of the field to identify the number of positions following to the end of
that field

Binary representation of data.

Bit
Map

8 bytes (64 bits) in binary format. Each bit signifies the presence (1) or the absence (0) in the message
of the data field associated with that particular bit

C for credit, D for debit and shall always be associated with a numeric amount data field, i.e., x+n
16 in amount, net reconciliation means prefix C or D and 16 digits of amount, net reconciliation

2.

Data Field Format

Table 2. Data Field Format


MM

Month

DD

Day

YY

Year

hh

Hour

mm

Minute

SS

Second

SmartVista Front-End

ISO-8583 CBS INTERFACE


14

Banking Production Center


LL

Length of variable data field that follows, from 01-99. The variable length subelement is two numeric
characters.

LLL

Length of variable data field that follows, from 001-999. The variable length subelement is three
numeric characters.

VAR

Variable length data field.

3.

Data Field Presence Conditions

C Conditional. Field/value is present in the message under certain conditions, which are explained
in Data Field Description.
M Mandatory. Field/value must be present in the message.
O Optional. Field/value presence in the message is up to the message initiator or the responder.

4.

Data Field Description

4.1. Field 1: Secondary Bit-Map


4.1.1. Format
Bit-Map

4.1.2. Description
This field is a bit map indicating the presence or absence of fields in the secondary portion of the
message, bits 65-128. This field should only be present if there is at least one field from the
secondary range in the message.

4.2. Field 2: Primary Account Number


4.2.1. Format
llvar n.. 24

4.2.2. Description
This field contains the cardholders card number.

SmartVista Front-End

ISO-8583 CBS INTERFACE


15

Banking Production Center


This field is also used to match a response message with its original message.

4.3. Field 3: Processing Code


4.3.1. Format
n6

4.3.2. Description
The processing code is a series of three two-byte codes. The first two bytes (bytes 1 and 2) indicate
the type of transaction.
See the following table for valid values.
Transaction
Code
00
00
01
01
03
11
16
17
17
17
18
18
18
19
19
20
20
20
21
21
21
21
21
22
26
27
28

SVFE Transaction
Type
774
680
700
777
740
781
596
612
670
659
736
677
671
737
678
775
681
669
585
618
705
712
711
750
570
760
698

TRANSACTION
DESCRIPTION
POS Purchase/P2P Debit/Utility Payment
E-POS Purchase
ATM Cash withdrawal
POS Cash Advance
Check guarantee transaction
P2P Debit
Installment Purchase
BN Bill Payment
Manual Cash withdrawal
Debit account with presentment
POS Pre-authorisation
E-POS Pre-authorisation
Manual Purchase
POS Completion
E-POS Completion
POS Return or Refund
E-POS Return or Refund
Manual Refund Completion
Cash Deposit Account
ATM Cash Deposit
Deposit
POS Cash Deposit
E-POS Cash Deposit
Credit Adjustment
Service Reimbursement
Credit account with presentment
Credit Payment

SmartVista Front-End

ISO-8583 CBS INTERFACE


16

Banking Production Center


Transaction
Code
29
31
31
31
31
37
38
39
40
44
50
50
50
50
50
51
52
58
91
91
91
91
92
92
93
93
93
94

SVFE Transaction
Type
785
702
784
757
676
684
796
704
703
613
530
692
508
510
893
588
471
707
493
644
672
782
797
798
603
751
753
474

TRANSACTION
DESCRIPTION
P2P Credit
Balance Inquiry
POS Balance Inquiry
Balance Inquiry on Screen
E-POS Balance Inquiry
Advanced Repayment Information
Account Verification
Mini-Statement
Funds Transfer
ATM BN IBFT
Transfer to external account
Transfer to foreign account
Utility Payment
Predefined Payment
Predefined Service Payment
Full Advanced Repayment
Prepaid Card
Payment from Envelope
Block Card
Activate Card
Change Card Status
Validate Card
Service On
Service Off
Forced PIN Change
PIN Change
New PIN Reentry
Change Account Status

The second and third two bytes (bytes 3 and 4, and bytes 5 and 6) indicate the account 1 and account
2 type, respectively .
See the following table for valid values.
ACCOUNT TYPE
0X
1X
2X
3X
4X
5X
6X
7X

ACCOUNT DESCRIPTION
Default (unspecified) account
Savings account
Checking account
Credit account
Others Account
Loans Account
Envelope Account
Escrow Account

SmartVista Front-End

ISO-8583 CBS INTERFACE


17

Banking Production Center


ACCOUNT TYPE
8X
9X

ACCOUNT DESCRIPTION
Money Market Account
Loyalty Account

The second byte in each pair (i.e. byte 4 and 6) indicates an order of account that is used in
transaction in the list of card accounts with the same type. Valid values are 0-8.

4.4. Field 4: Amount, Transaction


4.4.1. Format
n 12

4.4.2. Description
Funds requested by the cardholder in the local currency of the acquirer or source location of the
transaction, exclusive of amounts, fees.
In the 1100 balance inquiry request, this field will contain zeroes. In the 1110 balance inquiry
response, this field will contain the account balance or zeroes if account balance is negative.

4.5. Field 5: Amount, Account


4.5.1. Format
n 12

4.5.2. Description
Amount in cardholder account currency, including fees.
In requests field contains transaction amount, in responses the actual account balance.

4.6. Field 6: Amount, Cardholder Billing


4.6.1. Format
n 12

4.6.2. Description

SmartVista Front-End

ISO-8583 CBS INTERFACE


18

Banking Production Center


This field contains the transaction amount (Field 4), converted to the currency used to bill the
cardholders account. The conversion rate is in Field 10. No decimal point appears in this field; the
decimal place is implied based on the currency. If it is present, the following fields are also
required: Field 10: Conversion Rate, Cardholder Billing.

4.7. Field 9: Conversion Rate, Cardholder Billing


4.7.1. Format
n8

4.7.2. Description
This field contains the rate used to convert the transaction amount (Field 4) to the cardholder
billing amount (Field 6). The Field 4 amount multiplied by this rate equals the Field 6 amount. The
left-most digit denotes the number of positions the decimal separator shall be moved from the right
(allowable values are 0 to 7). Positions 28 of the field are the actual rate.
For example: 69985022 = 9.985022.

4.8. Field 10: Conversion Rate, Account


4.8.1. Format
n8

4.8.2. Description
This field contains the rate used to convert the Cardholder Billing amount (Field 6) to the
Cardholder Account amount (Field 4). The left-most digit denotes the number of positions the
decimal separator shall be moved from the right (allowable values are 0 to 7). Positions 28 of the
field are the actual rate.
For example: 69985022 = 9.985022.

4.9. Field 11: Systems Trace Audit Number


4.9.1. Format
n6

SmartVista Front-End

ISO-8583 CBS INTERFACE


19

Banking Production Center

4.9.2. Description
A number assigned by a transaction originator to assist in identifying a transaction uniquely. The
trace number remains unchanged for all messages within the transaction.
This field is also used to match a response message with its original message.

4.10. Field 12: Time, Local Transaction


4.10.1.Format
n 12
YYMMDDhhmmss

4.10.2.Description
The local year, month, day, and time the transaction takes place at the card acceptor location in
authorization and financial messages.
This field is also used to match a response message with its original message.

4.11. Field 14: Date, Expiration


4.11.1.Format
n4
YYMM

4.11.2.Description
The year and month that the card will become expired.

4.12. Field 15: Settlement Date


4.12.1.Format
n6
YYMMDD

4.12.2.Description

SmartVista Front-End

ISO-8583 CBS INTERFACE


20

Banking Production Center


Field contains the SmartVista Front-End Acquirer settlement date.

4.13. Field 18: Merchant Type


4.13.1.Format
n4

4.13.2.Description
A code describing the merchants type of business product or service. See ISO-8583 standard
documentation for the list of valid categories.

4.14. Field 22: Point of Service Date Code


4.14.1.Format
ans 12

4.14.2.Description
A series of codes intended to identify terminal capability, terminal environment and presentation
security data. It shall be used to indicate specific conditions that are (or were) present at the time a
transaction took place at the point of service and/or when the transaction has been initiated.
See the following table for valid values.
Position
1

Position Description
Card data input
capability

Cardholder
authentication
capability

Valid Values
0 Unknown
1 Manual
2 Magnetic stripe reader
3 Bar code reader
4 OCR reader
5 EMV compatible ICC reader
6 Key entry
7 Magnetic stripe reader and key entry
8 Magnetic stripe reader, key entry and
EMV compatible ICC reader */
9 Contactless read
0 No electronic authentication
1 PIN
2 Electronic signature analysis
3 Biometrics
4 Biographic
5 Electronic authentication
6 Other

SmartVista Front-End

ISO-8583 CBS INTERFACE


21

Banking Production Center


Position

Position Description

Card
capability

capture

Operating
environment

Cardholder
indicator

Card presence

Card data input mode

Cardholder
authentication method

Cardholder
authentication entity

presence

Valid Values
0 None
1 Capture
0 no terminal used
1 on premises of card acceptor, attended
2 on premises of card acceptor, untended
3 Off premises of card acceptor, attended
4 Off premises of card acceptor, unattended
5 On premises of card cardholder, unattended
9 On premises of card cardholder, attended
0 Present
1 Not present, unspecified
2 Not present, mail order
3 Not present, telephone order
4 Not present, standing order (recurring payment)
5 Not present, electronic order
S Not present, postponed payment
0 Not present
1 Present
0 Unspecified
1 Manual, no terminal
2 Magnetic stripe read
3 BAR read
4 OCR read
5 ICC read
6 Key entered
7 Contactless ICC read
8 Contactless magnetic stripe read
9 Contactless read
S E-commerce, merchant certificate only
T E-commerce, merchant and cardholder certificate / 3-D Secure
transaction
U E-commerce, no security
V E-commerce, channel encryption
0 No authentication
1 PIN
2 Electronic signature analysis
3 Biometrics
4 Biographic
5 Manual signature
6 Other manual authentication
T E-commerce, UCAF / 3DS authentication is not supported by
merchant
U E-commerce, UCAF / 3DS authentication is supported by
merchant but is not provided by issuer
V E-commerce, UCAF / 3DS authentication is supported by
merchant and is provided by issuer
0 Not authenticated
1 ICC
3 Authorizing agent, online PIN
4 Merchant/card acceptor, signature
5 Other
S Merchant suspicious

SmartVista Front-End

ISO-8583 CBS INTERFACE


22

Banking Production Center


Position

Position Description

10

Card
data
capability

output

11

Terminal
capability

output

12

PIN capture capability

Valid Values
0 Unknown
1 None
2 Magnetic stripe write
3 ICC
0 Unknown
1 None
2 Printing capability only
3 Display capability only
4 Printing and display capability
0 No PIN capture capability
1 Unknown
4 PIN capture capability 4 characters maximum
5 PIN capture capability 5 characters maximum
6 PIN capture capability 6 characters maximum
7 PIN capture capability 7 characters maximum
8 PIN capture capability 8 characters maximum
9 PIN capture capability 9 characters maximum
A PIN capture capability 10 characters maximum
B PIN capture capability 11 characters maximum
C PIN capture capability 12 characters maximum

4.15. Field 24: Function Code


4.15.1.Format
n3

4.15.2.Description
Code indicating the specific purpose of the message within its message class.
See the following table for valid values.
FUNCTION
CODE
801
802
831
841

DESCRIPTION
Sign-On
Sign-Off
Echo-test
SAF list end

MESSAGE
TYPE
1804
1804
1804
1804

4.16. Field 32: Acquiring Institution Identification Code


4.16.1.Format
llvar n.. 11

SmartVista Front-End

ISO-8583 CBS INTERFACE


23

Banking Production Center

4.16.2.Description
This code identifies the financial institution acting as the acquirer of this cardholder transaction. The
acquirer is a member or system user that installed the terminal. The ID can be a Visa BIN, a
MasterCard BIN, or another code that identifies the financial institution or branch within
SmartVista Front-End. BINs are usually six digits, but the code may be up to 11 digits long. The
value length specifies the number of digits in the ID code.

4.17. Field 37: Retrieval Reference Number


4.17.1.Format
an 12

4.17.2.Description
A reference supplied by the system retaining the original source information and used to assist in
locating that information or a copy thereof.
If no reply was received to the original transaction Field 037 must still be present, but it should
contain a string of spaces.

4.18. Field 38: Authorisation Identification Response


4.18.1.Format
ans 6

4.18.2.Description
An authorization code provided by the CBS when a transaction is approved, or a no-reason-todecline code provided for successful verifications. Value of field 38 is based on value of field 37.
In the C program shown below the input parameter u of function auth is value of Field 37, and
output parameter a is value of field 38.
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
char *voc[6]={
SmartVista Front-End

ISO-8583 CBS INTERFACE


24

Banking Production Center


"123456789",
"0123456789ABCEFHKMNRSTUVWXYZ",
"0123456789ABCEFHKMNRSTUVWXYZ",
"0123456789",
"0123456789ABCEFHKMNRSTUVWXYZ",
"0123456789ABCEFHKMNRSTUVWXYZ"
};
void auth(long u, char *a) {
int i,l;
for (i=0; i<6; i++) {
l=strlen(voc[i]);
a[i]=voc[i][u%l];
u/=l;
}}

4.19. Field 39: Response Code


4.19.1.Format
an 3

4.19.2.Description
A code which defines the action taken or to be taken as well as the reason for taking the action.
SVFE RC

CBS RC

Description

-1

000

Successful transaction

826

001

Successful transaction, but MCC is in list 6010, 4829, 6051, 7995, 7511

818

111

Currency of the account in CBS is not the same as currency of account


in FRONT END

SmartVista Front-End

ISO-8583 CBS INTERFACE


25

Banking Production Center


SVFE RC

CBS RC

Description

928

112

Account is blocked

915

116

Not enough money on account

913

124

Account not found

4811

Customer
cancellation
The cardholder aborted the transaction after an authorisation request had
been sent

482

Completed
partially
Used in reversal messages to indicate that a transaction was completed,
but for an amount less than that given in the original 0100 request

483

Response
received
too
late
Used to indicate the reason for sending a reversal an authorisation
response was not returned within the time limit set by the acquirer

496

System
malfunction
The message could not be successfully processed due to a system
malfunction (see also Note below)

812

902

Incorrect type of request of code of transaction

802

907

CBS is not available

959

909

Internal errors in the interface software

802

910

CBS is in "log off" state

959

914

This code is sent from CBS in case the cancellation request 703 was
sent when the operational day in CBS is closed.

811

913

Duplicate transaction

959

916

Errors in software of CBS

894

894

Operation could not be processed because of temporary moratorium


(TIME_MORATORIUM)

895

895

Absense of information about debt


(DEBTS_ABSENCE)

Response codes 4XX are sent by SVFE in 142X messages

SmartVista Front-End

ISO-8583 CBS INTERFACE


26

Banking Production Center


SVFE RC

CBS RC

Description

997

997

The customer doesn't have the service of advance repayment of debt


(SERVICE_NOT_ALLOWED)

4.20. Field 41: Card Acceptor Terminal Identification


4.20.1.Format
ans 8

4.20.2.Description
A code that uniquely identifies a particular terminal at the card acceptors location. An identification
code of less than eight positions must be left-justified and the remainder of the field space-filled.
This field is mandatory if the terminal id is available.

4.21. Field 43: Card Acceptor Name and Location


4.21.1.Format
ans 40

4.21.2.Description
The name and location of the card acceptor. This field is required in authorization requests, advice
messages and related reversal requests for all card-read transactions. It contains the information
necessary for printing on customer account statements and on credit card billing statements.
Subfield

Type and
length of data

ans 38

ans 2

Data dictionary
Merchant number of bank name;
Separator >
Merchant city or location of the terminal device
Trailing spaces
ISO code of the country

SmartVista Front-End

ISO-8583 CBS INTERFACE


27

Banking Production Center

4.22. Field 48: Additional Data


4.22.1.Format
lllvar ans 999
Tag data format: 3 bytes for each tag name + 3 bytes for each tag length + tag data

4.22.2.Description
This field is used to carry SmartVista Front-End internal information. There is a number of tags packed
in field 48. The tags have the TLV structure. It means they are repeated groups of Tag IDs, Tag Lengths
and Tag Values.

Banking Production Center may occasionally introduce new Field 48 tags between SVFE releases to
facilitate special processing. Banking Production Center requires members using SVFE CBS
specification to be able to successfully process various online messages that may contain new
unannounced Field 48 tags.
Refer to Appendix A (Field 48).

4.23. Field 49: Currency Code, Transaction


4.23.1.Format
n3

4.23.2.Description
This field is used in any message related to a cardholder transaction that contains one or more of the
amount fields listed above, even when the amount is zero. This field is also used in balance inquiry
requests, even when the value of field 4 equals zero. This code specifies the currency in which the
acquirer wants the balance amount to be expressed.

4.24. Field 50: Currency Code, Account


4.24.1.Format
n3

4.24.2.Description
SmartVista Front-End

ISO-8583 CBS INTERFACE


28

Banking Production Center


This code specifies the cardholder account currency.

4.25. Field 51: Currency Code, Cardholder Billing


4.25.1.Format
n3

4.25.2.Description
This field contains a 3-digit numeric code that identifies the currency used by the issuer to bill the
cardholders account.

4.26. Field 54: Additional Amounts


4.26.1.Format
lllvar an999

4.26.2.Description
This field is used to carry SmartVista Front-End account balance information. There is a number of
tags packed in Field 54. The tags have the TLV structure. It means they are repeated groups of Tag IDs,
Tag Lengths and Tag Values.

Banking Production Center may occasionally introduce new Field 54 tags between SVFE releases to
facilitate special processing. Banking Production Center requires members using SVFE CBS
specification to be able to successfully process various online messages that may contain new
unannounced Field 54 tags.

5.

Refer to Tag 011 Service Data

Tag No

Size

Data

011

Ans 32

Service Data.
If available must be present in 1100/1120/1121 messages.

SmartVista Front-End

ISO-8583 CBS INTERFACE


29

Banking Production Center

6.

Tag 012 Prepaid Card Type

Tag No

Size

Data

012

ans 28

Prepaid Card Type


Must be present for 471 SVFE transaction type only.

7.

Tag 013 Contract ID

Tag No

Size

Data

013

ans 6

Contract ID.
If available must be present in 1100/1120/1121 messages.

8.

Tag 014 Address Verification Data

Tag No

Size

Data

014

Ans 30

Cardholder address
If available must be present in 1100 messages.

9.

Tag 015 Postal Code Data

Tag No

Size

Data

015

Ans 9

Cardholder postal/ZIP code


If available must be present in 1100 messages.

10. Tag 016 Installment Payment Quantity


Tag No

Size

Data

016

n3

Quantity of payments for Installment purchase


Must be present in 1100 messages if Transaction Code = 16.

11. Tag 017 Text Information Data


Tag No

Size

Data

017

Ans 99

Free form text data


Optional for 1110 messages

SmartVista Front-End

ISO-8583 CBS INTERFACE


30

Banking Production Center

12. Tag 018 Card status


Tag No

Size

Data

018

n2

SVFE Card status:


0 valid card
1 call issuer
2 warm card
3 do not honor
4 honor with id
5 not permitted
6 lost card, capture
7 stolen card, capture
8 call security, capture
9 invalid card, capture
10 pick up card, special condition
11 call acquirer security
12 card is not activated
13 pin_attempts_exceeded
14 forced pin change
15 credit debts
17 pin activation
18 instant card personification waiting
19 fraud prevention
20 temprory blocked by client
21 permanent blocked by client
Must be present in 1100 messages if Transaction Code = 91.

13. Tag 019 Account status


Tag No

Size

Data

019

n4

New account status:


0 No restrictions
1 No withdrawals
2 No withdrawals or transfers
3 Only balance inquiries
4 Only deposits
5 Only balance inquiries and deposits
6 Only balance inquiries, deposits and transfers
7 No operations allowed (account blocked)
Must be present in 1100 messages if Transaction Code = 94.

14. Tag 020 External code for operation


Tag No

Size

Data

020

ans ..25

External code for some service.


Must be present in 1100 messages if Transaction Code = 26.

SmartVista Front-End

ISO-8583 CBS INTERFACE


31

Banking Production Center

15. Tag 021 Customer external account number


Tag No

Size

Data

021

ans ..99

External account number in service provider system.


If available must be present in 1100 messages.

16. Tag 022 Customer mobile phone number


Tag No

Size

Data

022

ans ..32

Mobile phone number for mobile top-up services.


If available must be present in 1100 messages.

17. Tag 023 Account Funds Type


Tag No

Length

Data

023

an 1

Account Funds Type:


Available value:
0 Debit.
1 Debit with overdraft.
2 Credit.
Could be present in 1110 messages.

18. Tag 024 Additional operation information


Tag No

Length

Data

024

ans ..255

Additional operation information


Free form text
Could be present in 1100 messages.

19. Tag 090-099 Payment specific data


Tag No

Size

Data

090-099

ans ..25

Specific data for payment services.


If available must be present in 1100 messages.

SmartVista Front-End

ISO-8583 CBS INTERFACE


32

Banking Production Center

Appendix B (Field 54).

19.1. Field 61: Additional Amounts and Counters


19.1.1.Format
lllvar an999

19.1.2.Description
This field is used to carry SmartVista Front-End account balance information. There is a number of
tags packed in Field 61. The tags have the TLV structure. It means they are repeated groups of Tag IDs,
Tag Lengths and Tag Values.

Banking Production Center may occasionally introduce new Field 61 tags between SVFE releases to
facilitate special processing. Banking Production Center requires members using SVFE CBS
specification to be able to successfully process various online messages that may contain new
unannounced Field 61 tags.

20. Refer to Tag 008 Amount, Installed Exceed Limit


Tag No

Length

Data

008

an 12

Exceed Limit. This amount used to show overdraft or credit limit


value assigned to card account.
Could be present in 1110 messages and contains Installed credit
limit for credit or debit with overdraft account.

21. Tag 009 Amount, Available Exceed Limit


Tag No

Length

Data

009

an 12

Available Exceed Limit. This amount used to show available


overdraft or credit limit value assigned to card account.
Could be present in 1110 messages and contains Available credit
limit for credit or debit with overdraft account.

SmartVista Front-End

ISO-8583 CBS INTERFACE


33

Banking Production Center


Appendix C (Field 61).

21.1. Field 62: Mini-statement data


21.1.1.Format
lllvar an220

21.1.2.Description
Field contains mini-statement data, only for 704 SVFE Transaction Type, up to 10 sets:
N

Description

Attributes

Comments

Transaction Date

n6

YYMMDD

Transaction Mnemonic Name

ans 3

Transaction Mnemonic Name

Debit Credit Indicator

A1

C credit transaction,
D debit transaction
noop transaction

Amount Transaction

N 12

SmartVista Front-End

ISO-8583 CBS INTERFACE


34

Banking Production Center

21.2. Field 63: Account Balance


21.2.1.Format
n 12

21.2.2.Description
Account balance.

21.3. Field 64: Primary MAC Data


21.3.1.Format
b8

21.3.2.Description
The Primary Message Authentication Code data field carries the message authentication code
(MAC) for the message. This code is generated by ANSI X9.19 Method. Fields at MAC are filled
in according type of message formats represented at next chapter MASSAGE FORMAT (look at
last column Field Used For Mac Y or N)
If the message contains secondary data fields, Field 128 is used to carry the message authentication
code. If the message authentication code is carried in Field 128, Field 64 is not included in the
message.

21.4. Field 91: Action Code


21.4.1.Format
an 1

21.4.2.Description
This field is used to indicate type of operation. See table bellow.
Value

Description

Add operation

SmartVista Front-End

ISO-8583 CBS INTERFACE


35

Banking Production Center


Value

Description

Delete operation

21.5. Field 95: Replacement Amounts


21.5.1.Format
lllvar an999

21.5.2.Description
This field is used to carry SmartVista Front-End amount information. There is a number of tags packed
in Field 95. The tags have the TLV structure. It means they are repeated groups of Tag IDs, Tag Lengths
and Tag Values.

Banking Production Center may occasionally introduce new Field 95 tags between SVFE releases to
facilitate special processing. Banking Production Center requires members using SVFE CBS
specification to be able to successfully process various online messages that may contain new
unannounced Field 95 tags.

22. Refer to Tag 003 Recycling Cash-Out Counters


Tag No

Length

Data

003

n 15
or n 30
or n 45

Cash-out counters at each active cassette (from 1 to 3) in format:


n 3 currency of cassette
n 12 - cash-out amount from cassette

SmartVista Front-End

ISO-8583 CBS INTERFACE


36

Banking Production Center


Appendix D (Field 95).

22.1. Field 100: SVFE Issuer Institution Identifier


22.1.1.Format
LLVAR ans 4

22.1.2.Description
Field contains SVFE Issuer Institution Identifier.

22.2. Field 102: Account Identification


22.2.1.Format
llvar ans.. 32

22.2.2.Description
Field is used in cardholder transactions. Field identifies an account number of cardholder
relationship.

22.3. Field 103: Account Identification 2


22.3.1.Format
llvar ans.. 32

22.3.2.Description
Field is used in cardholder transactions. Field identifies second account number of cardholder
relationship. For example, TO account for transfers.

22.4. Field 128: Secondary MAC Data


22.4.1.Format
b8
SmartVista Front-End

ISO-8583 CBS INTERFACE


37

Banking Production Center

22.4.2.Description
The Secondary Message Authentication Code data field carries the message authentication code
(MAC) for the message. See Field 61: Additional Amounts and Counters

22.4.3.Format
lllvar an999

22.4.4.Description
This field is used to carry SmartVista Front-End account balance information. There is a number of
tags packed in Field 61. The tags have the TLV structure. It means they are repeated groups of Tag IDs,
Tag Lengths and Tag Values.

Banking Production Center may occasionally introduce new Field 61 tags between SVFE releases to
facilitate special processing. Banking Production Center requires members using SVFE CBS
specification to be able to successfully process various online messages that may contain new
unannounced Field 61 tags.

23. Refer to Tag 008 Amount, Installed Exceed Limit


Tag No

Length

Data

008

an 12

Exceed Limit. This amount used to show overdraft or credit limit


value assigned to card account.
Could be present in 1110 messages and contains Installed credit
limit for credit or debit with overdraft account.

24. Tag 009 Amount, Available Exceed Limit


Tag No

Length

Data

009

an 12

Available Exceed Limit. This amount used to show available


overdraft or credit limit value assigned to card account.
Could be present in 1110 messages and contains Available credit
limit for credit or debit with overdraft account.

SmartVista Front-End

ISO-8583 CBS INTERFACE


38

Banking Production Center


Appendix C (Field 61).

24.1. Field 62: Mini-statement data


24.1.1.Format
lllvar an220

24.1.2.Description
Field contains mini-statement data, only for 704 SVFE Transaction Type, up to 10 sets:
N

Description

Attributes

Comments

Transaction Date

n6

YYMMDD

Transaction Mnemonic Name

ans 3

Transaction Mnemonic Name

Debit Credit Indicator

A1

C credit transaction,
D debit transaction
noop transaction

Amount Transaction

N 12

24.2. Field 63: Account Balance


24.2.1.Format
n 12

24.2.2.Description
Account balance.
.

SmartVista Front-End

ISO-8583 CBS INTERFACE


39

Banking Production Center

MESSAGE FORMATS
1.

Authorization Message

1.1. Request
Bit
No.

Data field Name

Field Used
For Mac
Y or N

Attributes

Status

Comments / Remarks

Message Type

n4

Value is 1100

Bit Map, Primary

b64

Bit Map, Secondary

b64

Primary Account
Number

n24

Processing Code

n6

Amount, Transaction

n12

Amount, Account

n12

Amount, Cardholder
Billing

n12

Conversion Rate,
Cardholder Billing

n8

10

Conversion Rate,
Account

n8

11

Systems Trace Audit


Number

n6

12

Date & Time, Local


Transaction

YYMMDDhhmmss

n12

14

Date, Expiration

YYMM

n4

15

Settlement Date

YYMMDD

n6

18

Merchant Type

n4

22

Point of Service Date


Code

ans12

MO

32

Acquiring Institution
Identification Code

n11

37

Retrieval Reference
Number

an12

41

Card Acceptor
Terminal Identification

ans 8

Format

LLVAR

LLVAR

SmartVista Front-End

ISO-8583 CBS INTERFACE


40

Banking Production Center

Bit
No.

Field Used
For Mac
Y or N

Data field Name

Format

Attributes

Status

43

Card Acceptor Name


and Location

LLLVAR

ans136

48

Additional Data

LLLVAR

ans.. 999

49

Currency Code,
Transaction

n3

50

Currency Code,
Account

n3

51

Currency Code,
Cardholder Billing

n3

54

Additional Amounts

ans.. 999

64

Primary MAC Data

b8

For future used

91

Action Code

an 1

Must be present if
Transaction Code = 92

100

SVFE Issuer Institution


Identifier

LLVAR

ans 4

102

Account Identification

LLVAR

ans32

103

Account Identification2

LLVAR

ans32

128

Secondary MAC Data

b8

For future used

Attributes

Status

Comments / Remarks
Value is 1110

LLLVAR

Comments / Remarks

1.2. Response
Field Used
For Mac
Y or N

Bit
No.

Data field Name

Message Type

n4

Bit Map, Primary

b64

Bit Map, Secondary

b64

Primary Account
Number

n24

Processing Code

n6

Amount, Transaction

n12

Amount, Account

n12

11

Systems Trace Audit


Number

n6

37

Retrieval Reference

an12

Format

LLVAR

SmartVista Front-End

ISO-8583 CBS INTERFACE


41

Banking Production Center

Bit
No.

Data field Name

Format

Attributes

Status

Comments / Remarks

Field Used
For Mac
Y or N

Number
38

Authorisation
Identification Response

ans6

39

Response Code

An3

41

Card Acceptor
Terminal Identification

ans 8

48

Additional Data

ans.. 999

50

Currency Code,
Account

n3

54

Additional Amounts

LLLVAR

ans.. 999

62

Mini-statement data

LLLVAR

ans220

63

Account Balance

n 12

64

Primary MAC Data

b8

102

Account Identification

ans32

128

Secondary MAC Data

b8

2.

LLLVAR

LLVAR

For future used

N
Y

For future used

Authorization Advice Messages

2.1. Request
Bit
No.

Data field Name

Field Used
For Mac
Y or N

Attributes

Status

Comments / Remarks

Message Type

n4

Value is 1120

Bit Map, Primary

b64

Bit Map, Secondary

b64

Primary Account
Number

n24

Processing Code

n6

Amount, Transaction

n12

Amount, Account

n12

Amount, Cardholder
Billing

n12

Conversion Rate,
Cardholder Billing

n8

Format

LLVAR

SmartVista Front-End

ISO-8583 CBS INTERFACE


42

Banking Production Center

Bit
No.

Data field Name

Format

Attributes

Status

Comments / Remarks

Field Used
For Mac
Y or N

10

Conversion Rate,
Account

n8

11

Systems Trace Audit


Number

n6

12

Date & Time, Local


Transaction

YYMMDDhhmmss

n12

14

Date, Expiration

YYMM

n4

15

Settlement Date

YYMMDD

n6

18

Merchant Type

n4

22

Point of Service Date


Code

ans12

MO

32

Acquiring Institution
Identification Code

n11

37

Retrieval Reference
Number

an12

38

Authorisation
Identification Response

ans6

39

Response Code

An3

41

Card Acceptor
Terminal Identification

ans 8

43

Card Acceptor Name


and Location

LLLVAR

ans136

48

Additional Data

LLLVAR

ans.. 999

49

Currency Code,
Transaction

n3

50

Currency Code,
Account

n3

51

Currency Code,
Cardholder Billing

n3

64

Primary MAC Data

b8

For future used

91

Action Code

an 1

Must be present if
Transaction Code = 92

100

SVFE Issuer Institution


Identifier

LLVAR

ans 4

102

Account Identification

LLVAR

ans32

103

Account Identification2

LLVAR

ans32

LLVAR

SmartVista Front-End

ISO-8583 CBS INTERFACE


43

Banking Production Center

Bit
No.

Data field Name

128

Secondary MAC Data

Format

Attributes

Status

Comments / Remarks

b8

For future used

Attributes

Status

Comments / Remarks
Value is 1130

Field Used
For Mac
Y or N
N

2.2. Response
Field Used
For Mac
Y or N

Bit
No.

Data field Name

Message Type

n4

Bit Map, Primary

b64

Bit Map, Secondary

b64

Primary Account
Number

n24

Processing Code

n6

11

Systems Trace Audit


Number

n6

37

Retrieval Reference
Number

an12

39

Response Code

An3

41

Card Acceptor
Terminal Identification

ans 8

48

Additional Data

ans.. 999

50

Currency Code,
Account

n3

54

Additional Amounts

ans.. 999

63

Account Balance

n 12

64

Primary MAC Data

b8

102

Account Identification

ans32

128

Secondary MAC Data

b8

Format

LLVAR

LLLVAR

LLLVAR

LLVAR

SmartVista Front-End

For future used

N
Y

For future used

ISO-8583 CBS INTERFACE


44

Banking Production Center

3.

Reversal Messages

3.1. Request
Bit
No.

Data field Name

Field Used
For Mac
Y or N

Attributes

Status

Comments / Remarks

Message Type

n4

Value is 1420

Bit Map, Primary

b64

Bit Map, Secondary

b64

Primary Account
Number

n24

Processing Code

n6

Amount, Transaction

n12

Amount, Account

n12

Amount, Cardholder
Billing

n12

Conversion Rate,
Cardholder Billing

n8

10

Conversion Rate,
Account

n8

11

Systems Trace Audit


Number

n6

12

Date & Time, Local


Transaction

YYMMDDhhmmss

n12

14

Date, Expiration

YYMM

n4

15

Settlement Date

YYMMDD

n6

18

Merchant Type

n4

22

Point of Service Date


Code

ans12

MO

32

Acquiring Institution
Identification Code

n11

37

Retrieval Reference
Number

an12

39

Response Code

An3

41

Card Acceptor
Terminal Identification

ans 8

43

Card Acceptor Name


and Location

ans136

Format

LLVAR

LLVAR

LLLVAR

SmartVista Front-End

ISO-8583 CBS INTERFACE


45

Banking Production Center


Field Used
For Mac
Y or N

Bit
No.

Data field Name

Format

Attributes

Status

48

Additional Data

LLLVAR

ans.. 999

49

Currency Code,
Transaction

n3

50

Currency Code,
Account

n3

51

Currency Code,
Cardholder Billing

n3

54

Additional Amounts

ans999

64

Primary MAC Data

b8

For future used

91

Action Code

an 1

Must be present if
Transaction Code = 92

95

Replacement Amounts

LLLVAR

ans999

100

SVFE Issuer Institution


Identifier

LLVAR

ans 4

102

Account Identification

LLVAR

Ans32

103

Account Identification2

LLVAR

ans32

128

Secondary MAC Data

b8

For future used

Attributes

Status

Comments / Remarks
Value is 1430

LLLVAR

Comments / Remarks

3.2. Response
Field Used
For Mac
Y or N

Bit
No.

Data field Name

Message Type

n4

Bit Map, Primary

b64

Bit Map, Secondary

b64

Primary Account
Number

n24

Processing Code

n6

11

Systems Trace Audit


Number

n6

37

Retrieval Reference
Number

an12

39

Response Code

An3

41

Card Acceptor
Terminal Identification

ans 8

Format

LLVAR

SmartVista Front-End

ISO-8583 CBS INTERFACE


46

Banking Production Center

Bit
No.

Data field Name

Format

Attributes

Status

54

Additional Amounts

LLLVAR

ans.. 999

64

Primary MAC Data

b8

For future used

Attributes

Status

Comments / Remarks
Value is 1600

4.

Comments / Remarks

Field Used
For Mac
Y or N
Y
N

Administrative Messages

4.1. Request
Field Used
For Mac
Y or N

Bit
No.

Data field Name

Message Type

n4

Bit Map, Primary

b64

Primary Account
Number

n24

11

Systems Trace Audit


Number

n6

12

Date & Time, Local


Transaction

n12

41

Card Acceptor
Terminal Identification

ans 8

48

Additional Data

LLLVAR

ans.. 999

61

Additional Amounts
and Counters

LLLVAR

ans.. 999

64

Primary MAC Data

b8

For future used

Attributes

Status

Comments / Remarks
Value is 1610

Format

LLVAR

YYMMDDhhmmss

4.2. Response
Field Used
For Mac
Y or N

Bit
No.

Data field Name

Message Type

n4

Bit Map, Primary

b64

Primary Account
Number

n24

11

Systems Trace Audit


Number

n6

12

Date & Time, Local

n12

Format

LLVAR

YYMMDDhhmmss

SmartVista Front-End

ISO-8583 CBS INTERFACE


47

Banking Production Center

Bit
No.

Data field Name

Format

Attributes

Status

Comments / Remarks

Field Used
For Mac
Y or N

Transaction
39

Response Code

An3

41

Card Acceptor
Terminal Identification

ans 8

64

Primary MAC Data

b8

5.

For future used

Network Management Messages

5.1. Request
Bit
No.

Data field Name

Attributes

Status

Comments / Remarks

Message Type

n4

Value is 1804

Bit Map, Primary

b64

11

Systems Trace Audit


Number

n6

12

Date & Time, Local


Transaction

n12

24

Function Code

N3

Attributes

Status

Comments / Remarks
Value is 1814

Format

YYMMDDhhmmss

5.2. Response
Bit
No.

Data field Name

Message Type

n4

Bit Map, Primary

b64

11

Systems Trace Audit


Number

n6

24

Function Code

N3

39

Response Code

An3

Format

SmartVista Front-End

ISO-8583 CBS INTERFACE


48

Banking Production Center

MESSAGE MATCHING
1.

Message Matching Data Fields

Following set of fields takes part in message matching:

2.

Field 2. Primary Account Number;

Field 11. Systems Trace Audit Number;

Message Type.

Search of original request for responses

Key fields in matching response with request are Primary Account Number (field 2), and System
Trace Audit Number (field 11). Appropriate request message type (1100/1120/1420) is used as
value for matching.
The 810 response matching fields are Message Type and System Trace Audit Number (field 11).
Appropriate request message type (0800) is used as value for matching.

SmartVista Front-End

ISO-8583 CBS INTERFACE


49

Banking Production Center

APPENDIX A (FIELD 48)


1.

Structure Field 48

Size

Data

LLL

Tag 001

LLL 3

2.

Tag 002

Structure Tags of Data Field 48

Tag No

Length

Data

NNN

NNN

Ans .. 993

3.

Tag N

NNN bytes

Tag 001 Settlement type

Tag No

Length

Data

001

n1

Settlement type:
1 US-ON-US
2 US-ON-THEM
Must be present in 1100/1120/1121/1420/1421/1600 messages.

4.

Tag 002 SVFE Transaction Type

Tag No

Size

Data

002

n3

SVFE Transaction Type, refer to Field 3: Processing Code.


Must be present in 1100/1120/1121/1420/1421/1600 messages.
For 1600 message the value is 594.

5.

Tag 004 Full Name

Tag No

Size

Data

004

ans 40

Full Name.
Must be present in 1110 message for 684 SVFE transactions
type only.

SmartVista Front-End

ISO-8583 CBS INTERFACE


50

Banking Production Center

6.

Tag 005 Credit Type

Tag No

Size

Data

005

n3

Credit Type.
Must be present in 1110 message for 684 SVFE transactions
type only.

7.

Tag 006 Credit Issue Date

Tag No

Size

Data

006

N6

Credit Issue Date.


Format: YYMMDD
Must be present in 1110 message for 684 SVFE transactions
type only.

8.

Tag 007 Credit Issue Interval

Tag No

Size

Data

007

N6

Credit Issue Interval.


YYMMDD
Must be present in 1110 message for 684 SVFE transactions
type only.

9.

Tag 008 Credit End Date

Tag No

Size

Data

008

N6

YYMMDD
Must be present in 1110 message for 684 SVFE transactions
type only.

10. Tag 009 Credit Enable Date


Tag No

Size

Data

009

N6

YYMMDD
Must be present in 1110 message for 684 SVFE transactions
type only.

SmartVista Front-End

ISO-8583 CBS INTERFACE


51

Banking Production Center

11. Tag 010 Service Identifier


Tag No

Size

Data

010

Ans8

Service Identifier.
If available must be present in 1100/1120/1121 messages.

12. Tag 011 Service Data


Tag No

Size

Data

011

Ans 32

Service Data.
If available must be present in 1100/1120/1121 messages.

13. Tag 012 Prepaid Card Type


Tag No

Size

Data

012

ans 28

Prepaid Card Type


Must be present for 471 SVFE transaction type only.

14. Tag 013 Contract ID


Tag No

Size

Data

013

ans 6

Contract ID.
If available must be present in 1100/1120/1121 messages.

15. Tag 014 Address Verification Data


Tag No

Size

Data

014

Ans 30

Cardholder address
If available must be present in 1100 messages.

16. Tag 015 Postal Code Data


Tag No

Size

Data

015

Ans 9

Cardholder postal/ZIP code


If available must be present in 1100 messages.

SmartVista Front-End

ISO-8583 CBS INTERFACE


52

Banking Production Center

17. Tag 016 Installment Payment Quantity


Tag No

Size

Data

016

n3

Quantity of payments for Installment purchase


Must be present in 1100 messages if Transaction Code = 16.

18. Tag 017 Text Information Data


Tag No

Size

Data

017

Ans 99

Free form text data


Optional for 1110 messages

19. Tag 018 Card status


Tag No

Size

Data

018

n2

SVFE Card status:


0 valid card
1 call issuer
2 warm card
3 do not honor
4 honor with id
5 not permitted
6 lost card, capture
7 stolen card, capture
8 call security, capture
9 invalid card, capture
10 pick up card, special condition
11 call acquirer security
12 card is not activated
13 pin_attempts_exceeded
14 forced pin change
15 credit debts
17 pin activation
18 instant card personification waiting
19 fraud prevention
20 temprory blocked by client
21 permanent blocked by client
Must be present in 1100 messages if Transaction Code = 91.

SmartVista Front-End

ISO-8583 CBS INTERFACE


53

Banking Production Center

20. Tag 019 Account status


Tag No

Size

Data

019

n4

New account status:


0 No restrictions
1 No withdrawals
2 No withdrawals or transfers
3 Only balance inquiries
4 Only deposits
5 Only balance inquiries and deposits
6 Only balance inquiries, deposits and transfers
7 No operations allowed (account blocked)
Must be present in 1100 messages if Transaction Code = 94.

21. Tag 020 External code for operation


Tag No

Size

Data

020

ans ..25

External code for some service.


Must be present in 1100 messages if Transaction Code = 26.

22. Tag 021 Customer external account number


Tag No

Size

Data

021

ans ..99

External account number in service provider system.


If available must be present in 1100 messages.

23. Tag 022 Customer mobile phone number


Tag No

Size

Data

022

ans ..32

Mobile phone number for mobile top-up services.


If available must be present in 1100 messages.

SmartVista Front-End

ISO-8583 CBS INTERFACE


54

Banking Production Center

24. Tag 023 Account Funds Type


Tag No

Length

Data

023

an 1

Account Funds Type:


Available value:
0 Debit.
1 Debit with overdraft.
2 Credit.
Could be present in 1110 messages.

25. Tag 024 Additional operation information


Tag No

Length

Data

024

ans ..255

Additional operation information


Free form text
Could be present in 1100 messages.

26. Tag 090-099 Payment specific data


Tag No

Size

Data

090-099

ans ..25

Specific data for payment services.


If available must be present in 1100 messages.

SmartVista Front-End

ISO-8583 CBS INTERFACE


55

Banking Production Center

APPENDIX B (FIELD 54)


1.

Structure Field 54

Size

Data

LLL

Tag 001

LLL 3

2.

Tag 002

Structure Tags of Data Field 54

Tag No

Length

Data

NNN

NNN

Ans .. 99

3.

Tag N

NNN bytes

Tag 001 Acquirer Fee Amount

Tag No

Length

Data

001

N12

Acquirer Fee Amount


Could be present in 1100/1120/1420/1421 messages if acquirer
fee is available.

4.

Tag 002 Transaction Amount, Transaction


Currency

Tag No

Length

Data

002

N12

Transaction Amount, Transaction Currency.


Must be present in 1100/1420/1421 messages for 775, 705, 750,
703, 691, 692, 785 SVFE transactions type only.

SmartVista Front-End

ISO-8583 CBS INTERFACE


56

Banking Production Center

5.

Tag 003 Transaction Currency

Tag No

Length

Data

003

N13

Transaction Currency.
Must be present in 1100/1420/1421 messages for 775, 705, 750,
703, 691, 692, 785 SVFE transactions type only.
For 703 SVFE transactions type it contains Account TO
Currency.

6.

Tag 004 Amount, Credit Initial

Tag No

Length

Data

004

N12

Amount, Credit Initial.


Must be present in 1110 message for 684 SVFE transactions
type only.

7.

Tag 005 Amount, Total Credit

Tag No

Length

Data

005

n 12

Amount, Total Credit.


Must be present in 1110 message for 684 SVFE transactions
type only.

8.

Tag 006 Issuer Fee Amount and Currency

Tag No

Length

Data

006

an 16

Issuer Fee Amount and Currency:


Position 1 Fee Sign (C or D)
Positions 2-3 Fee Amount
Positions 14-16 Fee Currency (ISO N3 Format)
Could be present in 1100/1120/1420/1421 messages if issuer fee
is available.

SmartVista Front-End

ISO-8583 CBS INTERFACE


57

Banking Production Center

9.

Tag 007 Current Account Available Balance and


Currency

Tag No

Length

Data

007

an 16

Current Account Available Balance:


Position 1 Balance Sign (C or D)
Positions 2-3 Account Balance, amount
Positions 14-16 Account Currency (ISO N3 Format)
Could be present in 1110/1130/1430 messages and contains
account available balance.

10. Tag 008 Amount, Installed Exceed Limit


Tag No

Length

Data

008

an 12

Exceed Limit. This amount used to show overdraft or credit limit


value assigned to card account.
Could be present in 1110 messages and contains Installed credit
limit for credit or debit with overdraft account.

11. Tag 009 Amount, Available Exceed Limit


Tag No

Length

Data

009

an 12

Available Exceed Limit. This amount used to show available


overdraft or credit limit value assigned to card account.
Could be present in 1110 messages and contains Available credit
limit for credit or debit with overdraft account.

SmartVista Front-End

ISO-8583 CBS INTERFACE


58

Banking Production Center

APPENDIX C (FIELD 61)


1.

Structure Field 61

Size

Data

LLL

Tag 001

LLL 3

2.

Tag 002

Structure Tags of Data Field 61

Tag No

Length

Data

NNN

NNN

Ans .. 99

3.

Tag N

NNN bytes

Tag 001 Cash-In Counters

Tag No

Length

Data

001

n 15
or n 30
or n 45
or n 60

Counters at each active cassette (from 1 to 4) in format:


n 3 currency of cassette

4.

n 12 - amount in cassette

Tag 002 Recycling Counters

Tag No

Length

Data

002

n 15
or n 30
or n 45

Counters at each active cassette (from 1 to 3) in format:


n 3 currency of cassette

5.

n 12 - amount in cassette

Tag 003 Recycling Cash-Out Counters

Tag No

Length

Data

003

n 15
or n 30
or n 45

Cash-out counters at each active cassette (from 1 to 3) in format:


n 3 currency of cassette
n 12 - cash-out amount from cassette

SmartVista Front-End

ISO-8583 CBS INTERFACE


59

Banking Production Center

APPENDIX D (FIELD 95)


1.

Structure Field 95

Size

Data

LLL

Tag 001

LLL 3

2.

Tag 002

Structure Tags of Data Field 95

Tag No

Length

Data

NNN

NNN

Ans .. 99

3.

Tag N

NNN bytes

Tag 001 Transaction Amount, Transaction


Currency

Tag No

Length

Data

001

N12

Transaction Amount, Transaction Currency

4.

Tag 002 Transaction Amount, Account Currency

Tag No

Length

Data

002

N12

Transaction Amount, Account Currency

5.

Tag 003 Transaction Amount, Cardholder Billing


Currency

Tag No

Length

Data

003

N12

Transaction Amount, Cardholder Billing Currency

6.

Tag 006 Transaction Currency

Tag No

Length

Data

006

N3

Transaction Currency

SmartVista Front-End

ISO-8583 CBS INTERFACE


60

Banking Production Center

7.

Tag 007 Account Currency

Tag No

Length

Data

007

N3

Account Currency

8.

Tag 008 Cardholder Billing Currency

Tag No

Length

Data

008

N3

Cardholder Billing Currency

SmartVista Front-End

ISO-8583 CBS INTERFACE


61

Banking Production Center

LIST OF REVISIONS

Date

Name, Surname

Modifications

2010-10-14

Grigoriev A.S.

English version of document created. Revised edition.

2010-11-24

Grigoriev A.S.

Added operations: Debit account with presentment, Credit


account with presentment.

2011-02-04

Sasin S.S.

Changes in accordance with the Main Project: transaction


type for P2P_DEBIT (781) and UTILITY_PAYMENT
(508) is being changed to POSP (774), and CBS will never
know original operation type

2011-02-21

Ustinchenko A.G.

Added tag 002 to field 61

2011-05-25

Dudnikov V.M.

Added Account Verification transaction. Added tag 14, 15 to


field 48.

2011-05-27

Ustinchenko A.G.

Added tag 003 to field 61

2011-07-29

Dudnikov V.M.

Added tags 16, 17, 18 to field 48. Added field 91, Added
SVFE transaction types 493, 508, 510, 596, 603, 644, 672,
751, 753, 782, 797, 798, transaction codes 16, 91, 92, 93.
Added value 841 to field 24. Changed transaction code for
transaction types 585, 618. Removed transaction type 587.

2011-08-30

Sasin S.S.

New processing codes were added: 26 Service


Reimbursement, 94 Change Account Status.
New parameters for status and payments were added: tag
019 Account status, tag 020 External code for operation,
tag 021 Customer external account number, tag 022
Customer mobile phone number, tags 090-099 Payment
specific data.

2011-09-19

Kondrashin E.K.

Changed field 43 format and comment field 62.3

10

2011-09-19

Sasin S.S.

New processing code Predefined Service Payment (50)


was added.

11

2011-09-28

Dudnikov V.M.

Changed description of field 39.

12

2011-10-18

Ustinchenko A.G.

Added tag 008, 009 to field 54


Added tag 023 to field 48
Changed name of tag 007 of field 54

13

2011-11-03

Dudnikov V.M.

Added tag 24 to field 48.

14

2011-12-16

Dudnikov V.M.

Field 22 marked as optional.

15

2011-12-27

Dudnikov V.M.

Added SVFE transaction type 781.

SmartVista Front-End

ISO-8583 CBS INTERFACE


62

You might also like