JCB Online Interface Guide (2019)
JCB Online Interface Guide (2019)
Table of Contents
1 INTRODUCTION .................................................................................... 4
APPENDIX OIG-6
ONLINE AUTHORIZATION REQUEST MESSAGE (#0100)
DATA REQUIREMENT ..................................................................... 152
1 Introduction
1.1 Purpose of This Document
“Online Interface Guide” is primarily intended to describe J-Link, which is the ISO
8583:1987-based specification of the rules and formats for online message
interchange with the JCBI Network.
This document includes information on online transaction states, online application
types, message formats, and communication protocols supported by J-Link. This
document mainly focuses on the interface between the Licensee’s system and
J/Bridge.
ATTENTION: Do NOT start programming with only this document.
NOTE: The specifications described in this document are only general definitions. Before the
start of programming or implementation of J-Link in the Licensee’s system, the details of the
specifications should be discussed and agreed upon by the Licensee and JCBI.
J-Link J-Link
2.3.1 TCP/IP
J/Bridge supports TCP/IP (Transfer Control Protocol/Internet Protocol) interface.
2.3.1.1 Physical Layer & Data Link Layer
IEEE802.3 and IEEE802.2
10Base-T or 100BASE-TX (uses Unshielded Twisted-Pair Cable)
2.3.1.2 Network Layer & Transport Layer
The parameters for TCP/IP are defined as follows:
IP Address JCBI shall assign the specified IP address for licensee.
Do not change the JCB assigned IP address.
Subnet 255.255.255.0
TCP Port Numbers JCBI shall assign the specified number for licensee.
Server or Client Licensee’s system: Server, J/Bridge: Client
TCP data
First 2-bytes of the Data Header is used for identifying the length of the data.
X’0000’ must be set in last 2-bytes.
Message Format Example
If the data length is 500 bytes, the message would be as follows:
Data Data (Length number of bytes)
Header
X’01F40000’ 500 bytes of data
Figure 2-3 General format for application messages (including network control)
2.5.1 Message
A message is the elemental unit of a transaction and is used to convey information
between systems. It consists of a message type identifier, bit maps and a set of data
elements as defined in the previous section. Transmission headers and other
attachments are not considered part of the message.
2.5.2 Transaction
A transaction is a message set made up of a request or advice message and the
subsequent corresponding messages, such as repeat or response messages.
2.5.3 Application
An application represents a specific type of message processing, and consists of a set
of transactions.
For example, the authorization application consists of an authorization request
transaction, a reversal advice transaction, and an optional authorization advice
transaction. The authorization request transaction consists of an authorization
request message (0100) and an authorization request response message (0110).
The relationship of these is illustrated in Figure 2-4.
Authorization Application
Authorization Request Reversal Advice Authorization Advice
Transaction Transaction Transaction
3 Online Transactions
This chapter specifies the requirements for online transaction processing, particularly
in terms of the transaction state.
The message types (as defined in ISO 8583:1987) listed below are used for online
transactions. Usage of the message types does not deviate from the ISO definitions,
and messages other than those listed here are not allowed by J-Link and are thus
treated as unrecognized messages.
Figure 3-1 Message Types
Message Transaction Class
0100, 0110 authorization request
0120, 0121, 0130 authorization advice
0302, 0312 record registration/inquiry
0420, 0421, 0430 reversal advice
0620, 0630 administrative
0800, 0810 network management
NOTE: The message types which are used for a particular connection depend on
the Licensee’s situation.
Figure 3-2 illustrates the state transition and message traffic for authorization request
transactions.
Issuer
Acquirer
Issuer
Acquirer
0110 (RC=43) Declined
Issuer
Issuer
Acquirer
t100 timeout
(no response) Aborted
(c) Aborted
If the time-out period expires before the corresponding response
message is received, the Acquirer system must initiate advice repeat
messages for the aborted advice message until the response message is
received or until the maximum retry count is reached.
If the response message is still not received after transmission of the
advice repeat messages, the authorization advice transaction will be
aborted.
This condition is considered a ‘suspicious system error condition’ and
the system administrator is to investigate the source of the problem.
Figure 3-3 illustrates the state transition and message traffic for authorization advice
messages.
Issuer
0130 Notified
Acquirer
Acquirer
0120 Initiated
t120 timeout,
Issuer Maximum retry
count for 0121 Aborted
exceeded
(no response)
JCBI
Issuer
Issuer
JCBI
JCBI Issuer
t302 timeout
(no response) Aborted
Also an Issuer shall be able to process this message until 30 days after
an original transaction date.
(b) Notified
Successful reversal must be indicated with the response code ‘00’ in
the reversal advice response message (0430).
Because the advice message is notification that the reversal has
already been completed, negative response codes from the Issuer in
the advice response message (such as in the case of a cardholder who
has been recently registered in Negative File that hasn’t yet been
distributed) signify only information.
The operation managers for the Acquirer’s and the Issuer’s systems
should be warned of the occurrence of such negative advice responses.
The Acquirer cannot initiate an advice repeat message for the negative
advice response.
(c) Aborted
If the time-out period expires before the corresponding response
message is received, the Acquirer system must initiate advice repeat
messages for the aborted advice message up to the bilaterally agreed
maximum retry count, until the response message is received.
If the response message is still not received after transmission of the
advice repeat messages, the authorization advice transaction will be
aborted.
This condition is considered a ‘suspicious system error condition’ and
the system administrator is to investigate the source of the problem.
Figure 3-5 illustrates the state transition and message traffic for reversal advice
transactions.
Issuer
0430 Notified
Acquirer
Acquirer
0420 Initiated
Rece iver
Orig inator
Originator
0800 Initiated
Rece iver
Receiver
Originator
t800 t imeout
(no response) Aborted
3.6.3.2 Sign-off
The sign-off function is for deactivating system linkage and applications. Even if a
negative response is returned, or no response is returned, the system that initiated the
transaction can stop its activities. However, no response or a negative response
indicates exceptional system status, so the system operator should investigate the
cause of the trouble.
3.6.3.3 Echo test
The echo test transaction is for checking whether or not the linkage is active. By
receiving a response message, the initiating system can recognize that the Licensee’s
system link is active.
Licensee Licensee
????
unrecognized
message
0620
0630
4 Online Applications
The following two types of online applications are currently supported by J-Link:
(a) Authorization application
(b) Record registration/inquiry application
The Licensee system does not need to have complete implementation for all
applications. Only the transactions for applications performed with the individual
Licensee are required (refer to Section 4.3, ‘Summary of Application Features‘).
Licensee Licensee
0100
0110
::
::
0420
0430
Issuer JCBI
0302
0312
Figure 4-3 is just an example of message types applied for a particular interface.
Contact a JCBI representative for full details on the actual interface specifications.
5 Message Format
This chapter specifies the formatting requirements for all application message texts.
Abbreviation Description
M Mandatory data element
ME Mandatory echo, shall echo the same data as the
original message
MR Mandatory repeat, shall repeat the same data as the
original message
MS Mandatory reversal, shall contain the same data of the
original message
C Conditionally required
CE Conditional echo, shall echo the same data if the data
element exists in the original message
CR Conditional repeat, shall repeat the same data if the
data element exists in the original message
CS Conditional reversal, shall contain the same data of the
original message (this field is mandatory if it is
contained in the original message)
- Not mandatory but can be present
/ Must not be present; treated as a format error by the
message receiver
X JCB Brand system insert the data element
→ Forwarded and unchanged
All other data elements which are not designated in the lists below are treated as
format errors if included in the message. If a mandatory field or echo field is
missing, the message may result in a format error or may not be recognized. Such
systematic errors should be corrected before completion of certification. If a bit
map allocation that deviates from J-Link specifications is required, it must be
confirmed with JCBI using the specification exception form. Also, the default
values for data elements which are conditionally required (marked as ‘C’) must be
defined bilaterally using the data element mapping confirmation form.
<J-Link9>
54 Additional amounts CR → C C C C C
Integrated Circuit Card (ICC)
55* CR → C** CE C CE C
System Related Data
60 STIP Related Information CR → C / / / /
61 Point of Service Information MR → M / / / /
*: This is related to EMV transaction. Licensees must receive the prior approval of
JCBI if they plan to deal with ICC card.
**: This field is not sent to an Issuer when the Issuer applies for IC Authentication
Service.
<J-Link9>
3 Processing code / MS MS ME M
4 Amount, transaction / MS MS ME M
6 Amount, cardholder billing / M M CE C
7 Transmission date and time / MS* MS ME M
10 Conversion rate, cardholder billing / M M CE C
11 System trace audit number / MS* MS ME M
12 Time, local transaction - MS* MS CE C
13 Date, local transaction / MS* MS ME M
16 Date, Conversion / M M CE C
22 Point of service entry mode / MS* MS / /
23** Card sequence number - CS CS / /
25 Point of service condition code / MS* MS / /
28 Amount, transaction fee / CS CS CE C
32 Acquiring institution identification code / MS* MS ME M
33 Forwarding institution identification code / MS* MS ME M
37 Retrieval reference number / MS MS ME M
38 Authorization identification response / → / / /
39 Response code / M M M M
42 Card acceptor identification code / CS CS CE C
43 Card acceptor name and location / MS MS / /
44 Additional response data / → / / /
49 Currency code, transaction / MS MS ME M
51 Currency code, cardholder billing / M M CE C
54 Additional amounts / → / / /
90 Original data elements / M M ME M
95 Replacement amounts / M M ME M
* It is recommended for Issuers that matching keys be selected from bits designated
as ‘MS’ in the above chart and the sub fields in bit 90.
**: This is related to EMV transaction. Licensees must receive the prior approval of
JCBI if they plan to deal with IC card.
NOTE : In case of Dynamic Key Exchange, Bit 96 or Bit 105 will be added in 0800 message.
Before the start of programming or implementation of Dynamic Key Exchange in the
Licensee’s system, the details of the specifications should be discussed and agreed upon by the
Licensee and JCBI.
00: Purchase
Note
Acquirers can initiate Balance Inquiry function by setting the value of 30 in
position 1-2. However, Balance Inquiry transactions are not sent to the issuer
and are returned as error transactions when the issuer does not support
J-Link9 or the transaction function.
*For Partial Approvals in the #0110 message, an Issuer shall set the original amount. (The
Issuer shall set the Partial Approval amount in Bit 6.) An Acquirer will receive the Partial
Approval amount in this field from JCB.
*For Partial Approval reversals in the #0420 message, an Acquirer shall set the Partial
Approval amount from the #0110 message, if the Acquirer has received a #0110
message. An Issuer will receive the original amount in this field from JCB. (The Issuer will
receive the Partial Approval amount in Bit 6.)
*For Balance Inquiry in the #0100 message, an Acquirer shall set zero amount in this field.
*For DCC transaction in the #0100/#0110 and #0120/0130 message, this field contains the
amount in cardholder billing currency .
The decimal place rules are based on ISO4217:1987. Leading zeros are required to pad
the leftover digits since this is a 12-digit fixed length field.
Note
ATM Access Fee is allowed for Acquirer which obtained prior approval from
JCBI.
*For Partial Approvals in the #0110 message, an Issuer shall set the Partial Approval
amount in this field.
*For Partial Approval reversals in the #0420 message, an Issuer will receive the Partial
Approval amount in this field.
Description Indicates the PAN entry method and PIN entry capability.
*: This is related to EMV transaction. Licensees must receive the prior approval of JCBI if
they plan to handle IC card transactions.
Description* Distinguishes between two or more separate cards having the same PAN.
If bit 55 is present, and the Application PAN Sequence Number (EMV tag 5F34**) is stated
in the ICC, the Acquirer must pad this number with two leading zeros and set the value
in bit 23.
Ex. If EMV tag 5F34 = ’01’ then bit 23 = ‘0001’
If tag 5F34 is not available, bit 23 will not be provided to an Issuer.
If bit 55 is not present, bit 23 will not be provided to an Issuer.
*: This is related to EMV transaction. Licensees must receive the prior approval of JCBI if
they plan to handle IC card transactions.
**: Tag 5F34 is not included in Bit 55.
Description
Identifies conditions under which the transaction takes place at the point of service. The value must be one of
those listed in the following table:
NOTE : Code 06 Pre-authorized request is only allowed for hotel and rent-a-car Merchants.
Description Contains the maximum number of PIN characters which the terminal can accept. This field
is mandatory if bit 52 exists.
Description This field contains ATM Access Fee charged by the acquirer for ATM transactions in the
currency of bit 4 (Amount transaction).
For Balance Inquiry transactions, the Acquirer shall not charge ATM Access Fee.
For Partial Reversal transactions, this field contains ATM Access Fee amount of bit 95
subfield 1 (Actual Amount, Transaction) in the #0420 message. This fee can be less
amount than the fee for the original transaction.
Position 1:
Indicates whether the amount is credit or debit
C = Credit
D = Debit
Position 2-9:
Indicates the fee amount in the currency of bit 4 (Amount, Transaction).
Description 0100/0420
Contains the ID of the acquiring institution sending an authorization request. Values must
be defined under bilateral agreement in accordance with the J-Link certification procedures.
0302
Contains the ID of the initiator of the record registration/inquiry request.
Description Contains the ID of the institution forwarding a request or advice message. Values must be
defined under bilateral agreements in accordance with the J-Link certification procedures.
Format LLVAR binary, numeric 4-bit BCD and hexadecimal, as defined in ISO 7811/2
Description Contains the data encoded in track 2 of the magnetic stripe as defined in ISO 7813. When
the data consists of an odd number of digits, a leading zero is required to pad the first
unused half-byte of data. This field is required if PAN entry mode in bit 22 (point of service
entry mode) indicates X'02', X'05'(*), X’07’(*), X’91’(*) or X'97'(*).
* For chip transactions, bit 35 shall contain track 2 equivalent data.
When the Track 2 data is present, an Acquirer shall send only Track 2 data.
(Track 1 data (Bit 45) is only sent for POS transactions when the Track 2 data is not
present.)
*: This is related to EMV transaction. Licensees must receive the prior approval of JCBI if
they plan to handle IC card transactions.
Format LLVAR binary, numeric 4-bit BCD and hexadecimal, as defined in ISO 7811/2
Description Contains the data encoded in track 3 of the magnetic stripe as defined in ISO 7813.
J-Link does not use this element.
Description The reference number supplied by the Acquirer, which is used to identify the original
message and the original source document.
Description 0110
This field contains the string identifying the response from the authorizing institution when a
cardholder transaction is being approved. When an Issuer sets the value of ‘85’ in Bit 39
(Response Code), this field shall be set as '000000'
0420
This field must echo the original value of 0110 when available.
Description In response messages, this field contains the response to the Issuer application or JCBI for
the corresponding request or advice message. In advice messages, this field contains the
reason for the advice initiation.
For Balance Inquiry and AVS only transaction, an Issuer shall set the value of ‘00’ or ‘85’
Refer to Appendix OIG-1.
Description 0100
An identification code of 8 characters or less for the card acceptor terminal. The Acquirer
has the responsibility of maintaining the editing rules for this field. This field must be
left-justified with trailing blanks. JCBI recommends it be used.
0302
An identification code of 8 characters or less for the record registration/inquiry request
initiator. This value must be agreed upon by both parties in accordance with the J-Link
certification procedures.
Description An identification code for the card acceptor, of 15 characters or less. The Acquirer has the
responsibility of maintaining the editing rules for this field. This field must be left-justified
with trailing blanks. JCBI recommends it be used.
Description This field contains the name and location of the card acceptor.
Positions 1-22:
Merchant Name or the ATM location, branch number, or street address
For Payment Facilitator Transactions, set the Payment Facilitator name and
Sub-merchant name using the following format:
Payment Facilitator name @ Sub-merchant name
or
Payment Facilitator name * Sub-merchant name
NOTE: Use the same Sub-merchant name displayed on the storefront or order
page.
NOTE: If there is not enough space, use the abbreviated name of the Payment
Facilitator applied for in advance using Appendix 4-34.
Position 23:
Space
Positions 24-36:
Merchant or ATM Location City
Position 37:
Space
Positions 38-40:
Country Code (alphabetic)
Note JCB will send this field space-filled when JCB does not receive the information from an
Acquirer
Description This field contains CAV2 verification result code and/or AVS result code (bit 48). Must be
present in authorization request response if either CAV2 (bit 48 tag 01) or AVS Data (bit
48 tag 03) is present in the #0100 message.
Byte 1:
Value must be X’02’ if either CAV2 (bit 48 tag 01) or AVS Data (bit 48 tag 03) is present in
#0100 message.
Note CAV2 and AVS verification results are not forwarded to the acquirer when the acquirer or
the issuer does not support J-Link9 or the authentication function.
Format LLVAR binary, Alphabetic, character (alphabetic, numeric, and special) string
Description Contains the data encoded in track 1 of the magnetic stripe as defined in ISO 7813.
ATM transactions must have Track 2 data (Bit 35). This Bit should not be sent. This Bit is
only sent for POS transactions when the Track 2 data is not present.
Format LLVAR binary, character (alphabetic, numeric, and special) string, as defined in ISO 7811/2
Format LLVAR binary, numeric and character (can be binary data) string
Description This data element is used for both the authorization messages (01xx) and the administrative
advice message (0620).
Administrative advice message (0620, used only for unrecognized message indication)
Bit 48 contains the raw data from the unrecognized message; the original unrecognized
message must be truncated if its length is 256 bytes or greater.
e e e
Bit 48 Sub-field
Note An Acquirer must send CAV2 data to an Issuer when it is sent from a merchant.
Tag 03 and Tag 04 in Bit 48 are not forwarded to the issuer who does not support J-Link9.
Description The format of this field matches the PIN block format code in the security related control
field (bit 53).
Description This field contains the check digits for the key; the last 8 bits are unused. The check digits
are the four leftmost digits of a zero PIN block encrypted with a key (with a new key in case
of 0800 message). This element is required in a 0100 message which contains bit 52 (PIN
data) and in a 0800 message with a network management information code of X'0101' (key
change). The format of this field is as follows;
Format LLVAR binary, numeric and character (can be a binary data) string
Description This field provides information on up to six sets of Account Type, Amount type Currency
Code, Credit or Debit Sign and Amount .
This field will be used for Balance Inquiry, Partial Approval and DCC transaction.
For Balance Inquiry and Partial Approval, Bit 54 will be present in the #0110 message.
For DCC transaction, Bit 54 will be present in the #0100/#0110 and #0120/#0130 message.
Note -Bit 54 is not forwarded to the acquirer when the issuer does not support J-Link9.
-For Partial Approval reversals, Bit 54 shall not be used.
-DCC information may not be included in this field, depending on the authorization network
between JCB and the acquirer.
Description
Contains the data on the chip captured by an IC card compliant POS terminal and ATM.
It is used for various processing by an Issuer and the IC card, such as card authentication, Issuer
authentication, and issuer script.
NOTE: When JCBI performs IC related authentications on behalf of an Issuer, this field is not forwarded to
the Issuer. This includes all IC Cirrus ATM Transactions, since JCBI performs the authentications for them.
NOTE: Chip data must be set according to the format of the EMV specification, which places the value in the
order of the “tag-length-value” series format as shown below.
Data Layout:
1. Tag
Contains the tag value indicating the EMV data element as specified in the EMV ’96 specification.
(Binary representation, 1 byte to 2 bytes)
Refer to next page for details of “Tag” information.
2. Length
Contains the length in bytes of the following “Value”.
(Binary representation, 1 byte)
3. Value
Contains the data as defined in each tag data specification.
(Binary representation, 1 byte to 128 bytes)
NOTE: Sub-fields should be generated until all IC chip data has been read.
JCBI will transfer the data set in bit 55 between an issuer and an acquirer without editing any of the data.
The table below lists the mandatory and conditional sub-elements that an acquirer must or may set in bit 55 of
an authorization request message (#0100).
The table below lists the conditional sub-elements that an issuer may set in bit 55 of
an authorization response message (#0110).
Format LLVAR binary, numeric and character (can be a binary data) string
Format LLVAR binary, numeric and character (can be a binary data) string
Format LLVAR binary, numeric and character (can be binary data) string
Description
Bit 60 Sub-elements
Format LLVAR binary, numeric and character (can be binary data) string
Description Consists of two sub-fields: one-byte length (currently set at ‘06’; length may be extended in
future), and POS Information.
Position 1: Mail/Telephone Order Transaction Sign
0:Unknown
1:Mail/Telephone Order Transaction
2:Non-Mail/Telephone Order Transaction
Position 2: Recurring Transaction Sign
0:Unknown
1:Recurring Transaction
2:Nonrecurring Transaction
Position 3: Pre-Authorization Sign
0:Unknown
1:Pre-Authorization
2:No Pre-Authorization
Positions 4,5 and 6: Terminal Located Country Code
Indicates the country where the terminal is located (not the acquirer) using the numeric
Country Codes defined in Code List.
If country is unknown/unspecified, indicate value as 900.
Format LLVAR binary, numeric and character (can be a binary data) string
X'0001' Sign-on
X'0002' Sign-off
X'0101' Dynamic Key Exchange
X'0301' Echo test
Description This field contains the data elements in the original message, and is used to identify a
transaction for reversal. The field consists of the five numeric sub-fields below. If there is
no data for a particular sub-field, it should be filled with zeros. Please refer to the “message
samples” of Appendix OIG-3.
*If bit 28 (Amount, transaction fee) is present, this amount includes ATM Access Fee in
the currency of bit 4 (Amount transaction)..
*If the reversal is a partial reversal, the value for this field must be less than the amount in
bit 4 (Amount, transaction).
Description If bit 70 is X'0101', a new key for encryption should be placed in this field.
This field contains encrypted KPE by KEK for Single DES.
Bit 98 Payee
Length 25 digits, 25 bytes
Description 0800
Contains the code of the final destination of the request message, i.e., the default
authorizing institution. Values must be defined under bilateral agreement in accordance
with the J-Link certification procedures.
0302
Contains institution identification code who should receive this record registration/inquiry
request. When used, this field must be set to 08’88070000’.
Description If bit 70 is X'0101', a new key for encryption should be placed in this field.
This field contains encrypted KPE by KEK for Triple DES.
Format LLLVAR binary (2 bytes : 0000 – FFFF); alphabetic, numeric, and special characters
(EBCDIC)
Description
7 USA 1 M / /
(EBCDIC)
8 Europe 1 M / /
(EBCDIC)
9 Local 1 M / /
(EBCDIC)
The format used in the reply message must be the same as that used in the request message.
Sub-field No. Sub-field Name 302 Format 302 Format 312 Format 312 Format
1 2 1 2
0 Length M M M M
1 Transaction Type M M ME ME
4 Purge Date M M ME ME
6 Asia M / ME /
7 USA M / ME /
8 Europe M / ME /
9 Local M / ME /
Sub field No. Sub Field Name 302 Format 302 Format 312 Format 312 Format
1 2 1 2
0 Length M M M M
1 Transaction Type M M ME ME
4 Purge Date M M ME ME
6 Asia M / ME /
7 USA M / ME /
8 Europe M / ME /
9 Local M / ME /
Sub Sub Field Name 302 302 302 312 312 312
field Format 1 Format 2 Format 3 Format 1 Format 2 Format 3
No.
0 Length M M M M M M
1 Transaction Type M M M ME ME ME
3 Authorization Action M M / ME ME /
Code
4 Purge Date M M / ME ME /
6 Asia M / / ME / /
7 USA M / / ME / /
8 Europe M / / ME / /
9 Local M / / ME / /
0 Length M M
1 Transaction Type M ME
4 Purge Date / M
6 Asia / M
7 USA / M
8 Europe / M
9 Local / M
Format LLLVAR binary (2 bytes : 0000 – FFFF); alphabetic, numeric, and special characters
(EBCDIC)
Description Contains negative data access code assigned to each Issuer by JCBI.