GlobalPayments Technical Specifications
GlobalPayments Technical Specifications
SETTLEMENT
TECHNICAL
SPECIFICATIONS
VERSION 1.4
OCTOBER 2017
For settlement, all file formats are for a 640 byte variable file length. For backward compatibility, we also
support both 90 byte and 380 byte files but, these formats are outside the scope of this document and are not
permitted for new file submission certifications.
Both the authorisation and settlement formats contained within this document are derived from the UK Cards
Association Standard 70 and should be used to define the exact requirements for populating authorisation and
settlement messages into the Global Payments host systems. This document should be read in conjunction
with the UK Cards Association Standard 70, which can be obtained from them using the details below:
UK Payments Administration
2 Thomas Moore Square
London
E1W 1YN
Message formats and fields contained within Standard 70 but not defined within this document should be
assumed as being unsupported by Global Payments.
Revised versions of this document will be issued when new functionality is released onto our host systems.
If you use a Payment Service Provider, bureau, or any other kind of third party to assist in the processing of
your card transactions, they will act, at all times, as your agent and you will be responsible for any acts or
omissions on their part. You must ensure that they comply, at all times, with the terms of our Card Processing
Agreement and ensure you promptly pass on to them all communications or information we provide to you that
will have an impact on the processing services they provide to you.
Furthermore, you agree to indemnify us against any losses, damages or liability that we may suffer as a result
of acting on your agent’s instructions or any other action or omission of theirs. Whilst we may provide details
of third party processors to you, you are responsible for making a selection appropriate to your requirements
and negotiating contractual terms directly with the third party in question. You remain fully responsible for
paying any fees charged by your agent and in no circumstances will we collect these for your agent or remit
them to your agent before making payment to you.
1
2. NORMATIVE REFRENCES
The following documents are referenced within this document and are indispensable for the application of this
document. For dated references, only the edition cited applies. For undated references, the latest version of
the referenced document (including any amendments) applies.
PCI DSS Payment Card Industry Data Security Standards; maintained by PCI
SSC.
PCI SSC Payment Card Industry Security Standards Council
www.pcisecuritystandards.org.
3. ABBREVIATIONS
Abbreviation Meaning
Alphanumeric: Alphanumeric fields are to be left justified and padded with spaces
A
unless specifically defined as otherwise in this specification.
Numeric: Numeric fields are to be right justified and padded with leading zeros
N
unless specifically defined as otherwise in this specification.
8 bit binary data converted into printable hexadecimal.
AB Note: All alpha characters must be upper case.
Abbreviation Meaning
POS Position
Type The type of data to be submitted in the field (see 3.1 for full details)
2
4. GLOSSARY OF TERMS
Acquirer The entity processing the card transaction (Global Payments)
Alternate Card Number A different card number to the one used for completion of the
transaction that relates to the same actual card account.
Card Acceptor The person accepting the card payments – for example the
merchant
Form Factor A Contactless device can take on many forms, for example,
physical cards, NFC mobile phones, watches. The Form Factor is a
code that enables the Card Schemes to identify the type of
Contactless device that was used for a particular transaction.
Funding PAN The actual card number for applying debits/credits to, which may
have been replaced by a tokenised PAN during the transaction for
security.
IC Integrated Circuit
Tokenised PAN A card number that has been replaced by a different number for the
undertaking of the transaction for security purposes. Tokens are
typically linked to merchants or payment channels and cannot be
used outside of these environments.
3
5. SETTLEMENT
Each file shall comprise of file header and trailer records encapsulating data records. The format of all these
records shall be as defined within this document.
Any additional records or variations to these records contained within the UK Cards Association Standard 70,
Book 3, are not supported by Global Payments and must not be included in a file.
The contents of the file shall show structural and, where appropriate, financial integrity to be deemed as a valid
file.
The purpose of non-financial data records is indicated in the Transaction Code data element.
The combination of segments required determines the length of the record and, on a Variable Length File, the
presence of sub-records. The following table shows the combinations of segments and sub-records allowed
for a Variable Length File and, for each file format, the transaction code and record length (note record lengths
do not include any associated sub-records).
4
5.1.2 TRANSACTION CODES
The following table shows the permitted values for Digit 1 of the Transaction Code and which segments
should be present:
Note: A Transaction Code Digit 1 of E shall only be used in Summary Records and Claim Records. All
Transaction Records shall use a Transaction Code Digit 1 value of either L or R depending on the
card data capture method of the transaction (i.e. R for all IC read transactions and L for all swiped or
key entered transactions) – see individual record layouts for full details.
The following table shows the permitted values for Digit 2 of the Transaction Code:
Transaction
Description
Code Digit 2
1 Sale
2 Refund
3 Cash Advance
D Instalment Transaction
*Cash Advances: A batch containing Cash Advance transactions must not contain any Sales or Refunds.
Note: The Cash Advance transaction type is only to be used by Financial Institutions and therefore, prior
written approval from Global Payments is required before submitting this transaction type.
5
File Submission Rules
• Although 90 byte file structures are supported for existing customers, new customers must submit files in
640 byte variable format.
• Empty files or zero value files must not be submitted (for example, files containing headers and trailers
but, no transactions).
• E4 records – All fields should be set to zero except for the Record Count, which should be set to ‘1’.
• E8 records – All fields should be set to zero except for the Debit Item Count, which should be set to ‘1’
and, the Record Count which should be set to ‘2’.
• UTL records – All fields should be set to zero except for the Debit Item Count, which should be set to ‘1’
and the Record Count which should be set to ‘2’.
• Files must be written in ASCII – The United Kingdom 7-bit data code.
• Settlement files must be batched by merchant outlet.
• Each transaction must have the 8 digit Global Payments Merchant Number.
• There is no batch limit (number of batches or number of transactions) for an incoming file to Global
Payments, except for merchants submitting VGIS Data.
There are two levels of integrity checking when you submit a file into us:
• A check for financial integrity.
• A check for logical integrity.
If either of these integrity checks fails, the entire file will be invalidated and rejected.
Transaction Records from a single source are netted by both number and value onto a single summary record
using either transaction code E4, E5 or E6:
• E4 is used when sales equal or exceed refunds.
• E5 is used when refunds exceed sales.
• E6 is used for cash advances, which shall not be intermixed with other transaction types that will always
appear in a different summary (E4 or E5).
Summary Records from one or more sources are then netted in both number and value into a single Claim
Record using either transaction code E7 or E8:
• E7 is used when refund summaries (E5) exceed sales summaries (E4) and cash advance summaries
(E6).
• E8 is used when sales summaries (E4) and cash advance summaries (E6) equal or exceed refund
summaries (E5).
Claim Records are netted together both in number and value into the audit fields of User Trailer Label.
All Transaction Records must be included in a Summary Record, all Summary Records must be included in a
Claim Record and all Claim Records must be included in the User Trailer Record.
If any of the levels of totalling do not reconcile, there is an integrity failure and the whole file will be invalidated.
6
Logical Integrity Checking
Logical Integrity is achieved by the numbering of the records within the file starting at 0000001 and
incrementing in single units with each subsequent record.
The audit fields on the User Trailer Label must contain the total record count, which must be equal to the
highest sequence number used.
Any break in the numbering sequence or, failure to record the correct number of records on the file shall cause
an integrity failure and the whole file will be invalidated.
5.1.4 TESTING
We strongly recommended that when making any changes to the format or content of your settlement file you
submit a test file to us to ensure errors have not been introduced into the file, which in turn could cause your
file to reject.
Testing can be arranged by contacting your Relationship Manager or, if you do not have a Relationship
Manager, by emailing Jane Sellwood at: [email protected].
2 Label Number +3 A 1 1
7
5.2.2 FIRST FILE HEADER LABEL FORMAT (HDR1)
8
5.2.3 SECOND FILE HEADER LABEL FORMAT (HDR2)
9
5.3 TRANSACTIONAL RECORD FORMATS
5.3.1 SEGMENT 1
10
Num Name POS Type Len Value
11
5.3.2 SEGMENT 2 FORMATS
0 = By Terminal
1 = Online To Acquirer
8 Method Of Authorisation +90 N 1
2 = Voice To Acquirer
5 = Method Of Authorisation Not Known
9 Type Of Transaction +91 N 1 1 = Purchase With Cashback
Cashback amount in the minor
10 Cash Amount +92 N 6 denomination of the transaction
currency.
11 Filler +98 A 69 Space Fill
Total number of sub-records within the
12 Sub-Record Count +167 N 4
transaction (minimum = 0001)
13 Format Type +171 N 2 ‘20’
Note 1: Segment 2 Type 50 must be used for transactions that do not naturally have a segment 2 (i.e.
transactions other than PWCB, Reference Number/XML/VGIS and DCC) as a segment 2 must
be present to allow the addition of sub-records.
Note 2: Where Segment 2 Type 50 is used purely to allow for the inclusion of sub-records (i.e. transactions
other than PWCB, Reference Number/XML/VGIS and DCC), fields 8, 9 and 10 should be space
filled.
12
5.3.2.3 SEGMENT 2 – Type 80: Dynamic Currency Conversion (DCC)
Note: The column POS 1 gives the positions for data in Segment 4 when Segment 2 is not present.
POS 2 column gives the positions for the data in Segment 4 when Segment 2 is present.
EMV
Num Name POS 1 POS 2 Type Len Value
Tag
Application PAN Populate with the value of Tag
1 Sequence 0 +173 A 2 5F32 from the card. If Tag 9F34 5F34
Number is not present, zero fill
The response code sent back by
the acquirer in the authorisation
response or the code generated
locally by the terminal for
transactions completed locally,
when real time authorisation
could not be achieved. For
locally generated ARCs the
Authorisation following values shall be used:
2 Response Code +2 +175 A 2 Y1 = Offline Approved 8A
(ARC) Z1 = Offline Declined
Y2 = Approval after card
initiated referral
Z2 = Decline after card initiated
referral
Y3 = Unable to go online, offline
approved
Z3 = Unable to go online, offline
declined
Cryptogram The authorised amount of the
3 Transaction +4 +177 N 11 transaction excluding 9F02
Amount adjustments
Cryptogram
4 +15 +188 N 2 Cryptogram transaction type 9C
Transaction Type
The date supplied to the card
Terminal
5 +17 +190 N 6 during the creation of the 9A
Transaction Date
cryptogram in YYMMDD format
13
EMV
Num Name POS 1 POS 2 Type Len Value
Tag
The ISO 4217 numeric currency
Transaction code of the transaction (see
6 +23 +196 N 3 5F2A
Currency Appendix 1 for a full list of
currencies supported)
826 (the ISO 3166 numeric
Terminal Country
7 +26 +199 N 3 country code for the United 9F1A
Code
Kingdom)
The transaction cryptogram
Transaction being submitted to settle the
8 +29 +202 AB 16 9F26
Cryptogram transaction. This may be a TC,
an ARQC or an AAC
Application The Application Interchange
9 Interchange +45 +218 AB 4 Profile taken from Tag 82 of the 82
Profile card
Application The Application Transaction
10 Transaction +49 +222 AB 4 Counter taken from Tag 9F36 of 9F36
Counter the card
The Unpredictable Number
Unpredictable generated by the terminal to
11 +53 +226 AB 8 9F37
Number ensure the generation of a
unique application cryptogram
Terminal The Terminal Verification
12 Verification +61 +234 AB 10 Results generated by the 95
Results terminal for the transaction
Undefined data sent by the card
issuer to enable authentication
of the card. The data returned
Issuer Application by the issuer may be shorter
13 +71 +244 AB 64 9F10
Data than the total 32 bytes that is
allowed, in which case, it should
be right justified and padded
with leading FF (Hex)
The Application Usage Control
Application Usage
14 +135 +308 AB 4 taken from Tag 9F07 on the 9F07
control
card.
00 = AAC
Cryptogram
15 +139 +312 AB 2 40 = TC 9F27
Information Data
80 = ARQC
Cardholder The results of cardholder
16 Verification +141 +314 AB 6 verification as sent from the 9F34
Method Results terminal in Tag 9F34
The Application Identifier from
card, the application provider
Application and the business function or the
17 +147 +320 AB 32 4F
Identifier DF name if it is longer. Right
justified and padded with leading
FF (Hex)
Application The version of the card
18 +179 +352 AB 4 9F08
Version Number application from Tag 9F08
The transaction status
Transaction
19 +183 +356 AB 4 information generated by the 9B
Status Information
terminal in Tag 9B
22 = Attended Terminal
20 Terminal Type +187 +360 AB 2 9F35
25 = Unattended Terminal
14
EMV
Num Name POS 1 POS 2 Type Len Value
Tag
The Terminal Capabilities
Terminal
21 +189 +362 AB 6 defined in the terminal using 9F33
Capabilities
EMV tag 9F33
A two digit code identifying how
a transaction was completed
and, what cardholder verification
was used;
Digit 1: Card Transaction
Information;
1 = Swiped
2 = Keyed
3 = ICC
4 = Recovered data, keyed
5 = Recovered data, electronic
6 = Reserved for future use
7 = Downgraded ICC
transaction
22 POS Entry Mode +195 +368 A 2 8 = Swipe, ICC fallback
9 = Proximity
Digit 2: Cardholder
Verification, if any;
1 = Customer present, signature
2 = Customer present, PIN
3 = Reserved for future use
4 = Customer present, UPT, no
CVM
5 = Customer Present, UPT,
PIN
6 = reserved for future use
7 = Customer not present
8 = No cardholder verification
9 = Reserved for future use
23 Filler +197 +370 A 59 Space Filled
Sub-records provide a means of sending additional data for a transaction, some of which may be required for
settlement (for example, Scheme Reference Data), whilst some is required for other purposes such as MI
production (for example, DCC).
• In order to submit sub-records, the file must contain a segment 2 record regardless of whether, or not,
there is an appropriate sub-record for the transaction type (for example, PWCB and DCC).
• Where there is no matching segment 2 for a transaction type (i.e. for a straight forward sale transaction)
Segment 2 Type 50 (Reference Number or XML Layout) should be used.
• When using Segment 2 Type 50 for a non XML/Reference transaction, all fields should be space filled
except the sub-record counter and, the Format Type.
• Sub-Record Type 01 is mandatory for mPoS devices and optional for all other devices unless, data in the
POI Capabilities or Payment Attributes fields are being used.
• Sub-Record Type 26 is mandatory for all online transactions as this carries the Scheme Reference Data
that is used to link the settlement record to the corresponding authorisation record.
• Sub-records must be sent in ascending transaction code order and failure to do so will result in the file
being rejected.
15
• The Transaction Code in Segment 1 must reflect the requirement for Segment 2 and Sub-records to be
included. For example:
• An offline IC transaction would have a Transaction Code of ‘N’ and would contain only Segment 1
and Segment 4.
• An online IC transaction would have a Transaction Code of ‘R’ and would contain Segment 1,
Segment 2, Segment 4 and at least 1 sub-record (Sub-Record Type 26, Scheme Reference Data is
mandatory for an online transaction).
16
5.4.2 SUB-RECORD FORMAT TYPE 02: TOKENISATION SUB-RECORD
17
5.4.3 SUB-RECORD FORMAT TYPE 25: REFERENCE NUMBER/XML/VGIS
18
5.4.4 SUB-RECORD FORMAT TYPE 26: AUTHORISATION NETWORK REFERENCE DATA
Note: Submission of Scheme Reference Data is mandatory for all transactions that were authorised online.
Global Payments will not accept responsibility for any Card Scheme fees or charges resulting from
Scheme Reference Data not being submitted with the settlement data for any transactions that
received Scheme Reference Data back as part of the authorisation process.
19
5.4.5 SUB-RECORD FORMAT TYPE 27: DYNAMIC CURRENCY CONVERSION (DCC) DATA
Note 1: The format of the DCC conversion rate applied shall be as follow: xnnnnnnnnnn, where x is the number
of decimal places to be used. For example, 60001234567 indicates an exchange rate of 1.234567.
20
5.4.6 SUB-RECORD FORMAT TYPE 30: MASTERPASS ONLINE
21
5.4.8 SUB-RECORD FORMAT TYPE 39: CONTACTLESS SUB-RECORD
The card acceptor will provide the whole data element in BER-TLV format as described in EMV as the Tag will
vary from Card Scheme to Card Scheme. When the data is converted to hexadecimal, the value of the length
component shall still represent the length of the binary data.
The card acceptor will provide the whole data element in BER-TLV format as described in EMV as the Tag will
vary from Card Scheme to Card Scheme. When the data is converted to hexadecimal, the value of the length
component shall still represent the length of the binary data.
22
5.5 NET SUMMARY RECORD
23
5.6 NET CLAIM RECORD
24
Num Name POS Type Len Value
25
Num Name POS Type Len Value
26
5.7.3 USER TRAILER LABEL: UTL1
27
6. AUTHORISATION
The information in this section is valid for all transactions sent to the Global Payments authorisation host
individually.
An authorisation request message is a standard message sent to Global Payments by a merchant when a
transaction amount is above the merchant’s floor limit or, the transaction has been forced online either by a
velocity check being exceeded in the merchant’s POI (Point of Interaction) terminal or, on a cardholder’s IC
(Integrated Chip) card.
Authorisation request messages must have a transaction value of greater than zero except for when using the
Account Verification message type, in which case the transaction amount must always be set to zero.
6.1.2 REVERSALS
In order to reverse a transaction, the reversal message must be sent on the same day as the original
transaction authorisation message. This is to prevent transactions, where the authorisation has been reversed,
being inadvertently settled.
When an authorisation has been reversed, it is essential to ensure that any settlement transactions relating to
the original authorisation are not included in any settlement files.
Whilst the reversal messages do not need to follow immediately after the original sales transaction, the Scheme
Reference Data and the Acquirer Reference Data from the original authorisation response must be provided
in the Reversal Request Message.
Failure to include the Scheme and Acquirer Reference Data may result in the reversal request being rejected
by the Global Payments Authorisation System.
Where there is a need to reverse a transaction after the original transaction has been included in a settlement
file, a refund should be performed.
Global Payments will not accept responsibility for any Card Scheme fees or charges resulting from
authorisation messages being reversed after they have been settled or, where the necessary Scheme or
Acquirer Reference Data was not provided on the Reversal Request Message.
For a reversal, the transaction amount in the reversal should contain the amount to be reversed. For a partial
reversal, this must be less than the amount originally authorised.
The Global Payments authorisation host does not require the originally authorised amount to be sent in the
Auxiliary Data Record Type 09 Partial/Alternative Amount Approval when submitting a Partial Reversal
Request.
28
6.2 CONDITION CODES USED IN AUTHORISATION MESSAGES (M/O/C)
Code Meaning
M Mandatory
O Optional
Mandatory if subsequent fields are present. If subsequent fields are present, the delimiter
C1
(FS,GS,US etc.) for an omitted field must be present
Mandatory for Purchase With Cash Back Transactions (including reversals) prohibited for other
C2
transaction types
C3 Mandatory for ICC transaction, optional for non ICC transactions
C4 Mandatory if subsequent sub fields within the field are present
C5 Mandatory for ICC transaction, prohibited for non ICC transactions
C6 Mandatory if returned by issuer
C7 Mandatory for tokenization request messages otherwise optional
29
Num Name F/V Type Len M/O/C Value
30
Num Name F/V Type Len M/O/C Value
31
Num Name F/V Type Len M/O/C Value
15 Date F N 4 O YYMM
32
6.4 AUXILIARY DATA RECORDS
33
6.5 AUXILIARY DATA RECORD FORMATS
For valid combinations of Cardholder Authentication Value (Field 31.3.7), Electronic Commerce Indicator (Field
31.3.17), Additional Transaction Security Data (Field 31.3.5) and Customer Instruction (see Field 6.8 on page
11), please see Table 14.
Failure to use the correct combinations of values in these fields may result in transactions being rejected.
34
Num Name F/V Type Len M/O/C Value
Ecommerce auxiliary data record Sub-Type 02 should be used for any application initiated purchases (for
example, Apple Pay or Android Pay).
It should be noted that these transactions always use an Electronic Commerce Indicator of ‘07’, indicating that
these transactions have not been verified using the 3D Secure process.
35
Num Name F/V Type Len M/O/C Value
6.5.2 AUXILIARY DATA RECORD TYPE 03: DYNAMIC CURRENCY CONVERSION (DCC)
36
Num Name F/V Type Len M/O/C Comment
Note 1: The conversion rate should be formatted in the following way:- DCC Exponent<US>Conversion
Rate (shown without decimal places) The DCC Exponent should contain up to 2 numeric
characters and denote the number of positions the decimal point should be moved from the right
in the Conversion Rate, which may contain up to 21 numeric characters. For example, a value of
6<US> 9977522 specifies a Conversion Rate of 9.977522.
6.5.3 AUXILIARY DATA RECORD TYPE 06: TERMINAL CAPABILITIES AND TERMINAL
ATTRIBUTES
37
Num Name F/V Type Len M/O/C Value
The Partial/Alternative Amount Approval auxiliary record is returned in the authorisation response message
and is used when an issuer approves an amount that is different to the amount requested in the authorisation
request message.
In order to indicate that a terminal can support the use of this Auxiliary Data Record, the terminal must also
submit the Terminal Capabilities and Terminal Attributes Auxiliary Data Record (see table above) and, must
set bit 1 of position 2 of the Terminal Attributes Code (see Table 10) to indicate that Partial/Alternative Amount
Approvals are supported.
When a card issuer returns a Partial/Alternative Amount Approval, the acquirer shall set the Authorisation
Response Code to a value of 10 to differentiate between a normal approval (i.e. the full transaction amount
was approved) and a Partial/Alternative Amount Approval.
1 Record Separator F RS 1 M
Data Record Type –
Partial/Alternative
2 Amount Approval F N 2 M
Auxiliary Data Record –
Type 09
Data Record Sub-Type =
3 F N 2 M
01
4 Group Separator F GS 1 M
5 Approval Amount V N 11 M
6 Group Separator F GS 1 M
01 = Amount is the partial
amount
02 = Amount is the alternative
7 Approval Amount Type F N 2 M
amount
03 – 99 = Reserved for future
use
Partial/Alternative Amount Approvals are typically used for pre-paid cards and are used to prevent transactions
being declined if there are insufficient funds on the pre-paid card to complete the transaction.
Upon receipt of a Partial/Alternative Amount Approval, the terminal will need to prompt the merchant to either,
complete the remaining amount of the transaction by an alternative method or, cancel the transaction and
reverse the amount that was authorised.
38
Although theoretically, the transaction could be completed using a second card transaction, this could then
prevent the merchant from being able to reverse the original transaction should the second transaction be
declined or only partially approved.
Only allowing completion of the transaction using cash will retain the ability to reverse the initial authorisation,
if the overall transaction cannot be completed.
6.5.5 AUXILIARY DATA RECORD TYPE 10: AUTHORISATION NETWORK REFERENCE DATA
This data is sent and received in the Auxiliary Data Field in the Authorisation Request/Response messages.
This data is passed to the Global Payments authorising host by the Card Scheme and forwarded by the Global
Payments authorising host if the terminal has indicated that it is capable of processing transaction identifiers.
It should be captured and submitted as part of the Clearing Data (see Sub-Record Format 26) for the original
authorisation and any associated consequent authorisations, for example, on incremental authorisations or
recurring transaction.
39
Sub-Type 02: Acquirer Reference Data
This data is sent and received in the Auxiliary Data Field in the Authorisation Request/Response messages.
This data is generated by the Global Payments authorising host if the terminal indicates that it can support
transaction identifiers (in Position 2 of the Terminal Attribute Codes in Auxiliary Data Record 6) and passed to
the Point of Sale in the Authorisation Response message. The data must be included on any consequent
reversal; otherwise the Global Payments authorising host will not send the reversal online to the card issuer.
With the advent of NFC mobile phone payment technology (for example, Apple Pay) that use tokenised PANs
for security, it has become necessary to be able to return the last four digits of the Cardholder’s Funding PAN
to the POS to allow both the merchant and the cardholder to identify which card the tokenised PAN relates to.
This is particularly useful for identifying the card that was used for the original purchase when performing a
refund.
This is achieved through the use of Auxiliary Data Record Type 12: Alternate Card Number.
In order for a terminal to receive the Alternate Card Number in the Authorisation Response it must indicate
that Alternate Card Number is supported by (a) sending the Terminal Capabilities and Terminal Attributes
Auxiliary Data record in the Authorisation Request and (b) setting a value of 4 position 2 of the Terminal
Attributes Codes.
Note: It is likely that other values will also be set in position 2 of the Terminal Attributes Codes, which means
that the actual value sent must equal the total for all functions supported.
40
Num Name F/V Type Len M/O/C Value
6.5.8 AUXILIARY DATA RECORD TYPE 15: CONTACTLESS DEVICE INFORMATION DATA
41
Contactless Form Factor
The contents of this data element will vary by Card Scheme; for Mastercard and Visa it is Tag 9F6E, for
American Express it is Tag 9F67. The definition of these data elements can be found in the appropriate Card
Scheme’s Contactless specifications.
The card acceptor will provide the whole data element in BER-TLV format as described in EMV as the Tag will
vary from Card Scheme to Card Scheme. When the data is converted to hexadecimal, the value of the length
component shall still represent the length of the binary data.
The contents of this data will vary by Card Scheme and will be as agreed by interchange parties. For Visa the
discretionary data will be the content of Tag 9F7C. The definitions for these data elements can be found in the
appropriate Card Scheme’s Contactless specifications.
The card acceptor will provide the whole data element in BER-TLV format as described in EMV as the Tag will
vary from Card Scheme to Card Scheme. When the data is converted to hexadecimal, the value of the length
component shall still represent the length of the binary data.
42
6.5.10 AUXILIARY DATA RECORD TYPE 22: TOKENISATION RESPONSE DATA
When a scheme issued token is used to perform a transaction, Auxiliary Data Record Type 22 can be used
to return details of the token (if/when returned by the card issuer) to the terminal.
Receipt of this record is controlled by the setting Position 5 of the Terminal Attribute Codes (see Table 10).
43
Num Name F/V Type Len M/O/C Comment
6.5.11 AUXILIARY DATA RECORD TYPE 23: PAYMENT ACCOUT REFERENCE (PAR)
It is essential that the following data is as accurate as possible. If the terminal’s true capabilities are not
accurately described by this data, then the Global Payments authorising host or the card issuer may not
approve the transaction. For example, Mastercard have strict rules concerning the acceptance of cards at
Unattended/Cardholder Activated Terminals that are triggered if the fourth position indicates ‘Unattended
Device’ support.
Feature 8 4 2 1
ICC Reader X
44
Feature 8 4 2 1
Unattended device X
Fourth Position:
PINPAD available X
Additional Features and
Capabilities. (0) indicates no
Terminal or operator able to capture cards X
additional capabilities
supported Cardholders device (for example, may be a
PC, mobile phone, PDA, digital TV or similar X
device for E or M commerce
Note 1: If this bit is set then the data supplied is the extended terminal capabilities and attributes auxiliary
data messages takes priority. See Table 10.
Message
Type Description Direction Category Notes
Class
Purchase With
03 Authorisation Request Card 1st try Swipe
Cashback
Purchase With
04 Authorisation Request Keyed 1st try
Cashback
Purchase With
05 Authorisation Request Card Re-try Swipe
Cashback
Purchase With
06 Authorisation Request Keyed Re-try
Cashback
Purchase Cardholder No
09 Authorisation Request 1st try Keyed
Not Present cardholder
10 Purchase Authorisation Request Card 1st try Swipe
45
Message
Type Description Direction Category Notes
Class
46
Table 3: Card Details
a 1 F M US Unit Separator
b 25 V M N PAN
c 1 F O US Unit Separator
b 1 F M US Unit Separator
b 1 F M US Unit Separator
Leftmost 4 characters (YYMM) of ICC expiry date (ICC (Tag
c 4 F M N
‘5F24’))
d 1 F O US Unit Separator
Note 1: When a Start Date has been entered as part of the key entered transaction, the Start Date must
not be transmitted with the Authorisation Request message.
Note 2: Each 4 bit nibble of data in sub-field ‘a’ will be prefixed with binary ‘011’ with even parity inserted
on bit 8.
If rightmost (least significant) 4 bit nibble of data element ‘a’ is hex value ‘F’ this should be
discarded.
47
Sub field ‘c’ is missing if the ‘Application PAN sequence number’ data object Tag ‘5F34’ is not
present on the card. Sub field ‘b’ is mandatory if sub field ‘c’ is present.
Note 3: Sub field ‘d’ and ‘e’ are missing if ‘Application PAN sequence number’ data object Tag 5F34’ is
not present on the card. Sub field ‘e’ is mandatory is sub field ‘e’ is present.
The terminal shall always check for the presence of ‘Track 2 Equivalent Data object Tag ‘57’ and,
if it is present, use this in the authorisation message from the terminal.
Field Data
2 US – Unit Separator
3 The first 5 numeric from the Postcode (In the UK this will be 2 or 3 digits only)
4 US – Unit Separator
Numerics from address, truncated if required (these are the leading numerics from
5
each line of the address up to maximum 5 digits)
Note 1: The validation of the CSC depends on the correct Expiry Date being submitted in addition to the
CSC value. All address data shall relate to the customer’s statement/billing address.
Note 2: If this format is used, the two US characters are mandatory even if one or more of the sub
elements are not populated.
More than one value from the table below may be applicable to any one given transaction.
The codes are listed in priority order so that in the event of more than one code applying to a transaction, the
first code encountered in the list will apply. For example, a transaction could have fallen back from chip to mag
stripe – Reason Online Code 04, and also be above the merchant’s floor limit – Reason Online Code 10. In
this example, the Reason Online Code sent in the Authorisation Request message would be 04.
48
Value Description Example Conditions
Hot card
25 IC processed IC authorised
Amount less than the pre-communications
26 Under floor limit
floor limit in a non IC transaction
Advice of a sale that has already been
authorised by means of one or more
27 Stand-in processing at the acquirer’s option
previously -authorised transactions,
completed real-time to the acquirer.
The following table details the response codes that may be returned to a terminal along with the message text
that will be returned for the terminal to display and/or print.
49
Response Code Message Text Reason
The Referral telephone number data element is a variable length data element up to 16 characters. The
Referral telephone number is a structured number returned to a terminal to assist the terminal in dialling the
acquirer should voice contact be necessary. The number is in 3 parts;
A. is the code required to access an exchange line on a PABX (exchange line),
B. is the code which identifies the distant exchange national number group (dial code),
C. is the exchange number.
By sub-dividing the Referral telephone number it is possible for the acquirer to change all or part of the number
previously stored in the terminal.
If the acquirer wishes to change all elements stored in the terminal then the number in the Referral telephone
number data element shall contain no US character. If the acquirer wishes the terminal to dial the number as
defined in the terminal then it shall send a single US character.
Sending the appropriate combination of numbers and US character can change any other parts of the stored
referral number. The table below lists the structures that may be sent:
50
Referral Telephone Number
Terminal Response
Contents
No voice referral. Disconnect and display Text message
None
immediately.
Numbers Dial contents of A (if any) followed by numbers.
Feature 8 4 2 1
Not Checked X
Matched X
First Position:
CSC
Not Matched X
Not Checked X
Matched X
Second Position:
Post Code
Not Matched X
Partial Match X
Not Checked X
Matched X
Third Position:
Address Numeric
Not Matched X
Partial Match X
Issuer X
Acquirer X
Fourth Position:
Authorising Entity
Not Used by GP X
Not Used by GP X
Reserved X
Fifth Position:
Reserved For Future Use
Reserved X
51
Feature 8 4 2 1
Reserved X
Reserved X
Reserved X
Reserved X
Sixth Position:
Reserved For Future Use
Reserved X
Reserved X
Feature 8 4 2 1
Mastercard SecureCode X
Reserved X
First Position:
Security Capability
Verified by Visa X
Reserved X
Reserved X
Second Position:
Certificates
Reserved X
Reserved X
Mastercard SecureCode X
Reserved X
Third Position:
Security Attempted
Verified by Visa X
Authentication Successful X
Evidence Of Attempted
X
Fourth Position: Authentication
Security Results
System Unable To Verify X
V.Me By Visa X
Fifth Position:
Reserved For Future Use
Mastercard PayPass Online X
52
Feature 8 4 2 1
Reserved X
Reserved X
Reserved X
Reserved X
Sixth Position:
Reserved For Future Use
Reserved X
Reserved X
The values of the first second and third positions are each cumulative in that they record all the features
available or that are used in a transaction. Value settings for position 4 are mutually exclusive.
The terminal codes in the table below list the values used for both the Terminal Attributes Data Element and
the Terminal Attributes Used Data Element. The Terminal Attributes Data Element identifies the features
supported by the terminal and the Terminal Attributes Used Data Element identifies which of those features
were used in the transaction being processed. For any terminal that supports these data elements, the
Terminal Attributes Data Element shall be included in all authorisation and financial presentment messages
regardless of the terminal attributes used for the transaction being processed.
Feature 8 4 2 1
Contactless CDCVM X
Position 3:
Contactless CVM Reserved For The UK Cards
X
Association
Reserved For The UK Cards
X
Association
53
Feature 8 4 2 1
The POI Capabilities is a set of 24 single character indicators that indicate the capabilities of the POI device
accepting the transactions.
Note: Global Payments does not currently support the full range of values shown in UK Cards Association
Standard 70, only the values indicated below should be submitted in settlement files.
C Contact IC device
6 Contact ICC
N No contact ICC
54
POS Capability Value Meaning
N No Contactless capability
K Keying Possible
11 Keyed
N Keying Not Possible
55
Table 12 – Payment Attributes – For Use With General Sub Record Type 01
A Re Authorisation
C Unscheduled Payment
D Delayed Charges
I Instalment
Card Acceptor/Cardholder Agreement
1 L Incremental
(see Note 1)
N Not Applicable
R Recurring Payment
S Re Submission
X No show
C Cardholder Not Present (unspecified)
M Mail Order
56
Posn. Attribute Value Meaning
17 Reserved For The UK Cards Association
18 Reserved For The UK Cards Association
19 Reserved For The UK Cards Association
20 Reserved For The UK Cards Association
21 Reserved For The UK Cards Association
22 Reserved For The UK Cards Association
23 Reserved For The UK Cards Association
24 Reserved For The UK Cards Association
Note 1: Values other than N only to be used with cardholder present, cardholder not present, continuous
authority or electronic commerce sale message types.
Note 2: Values other than N only to be used with cardholder not present or electronic commerce message
types
Table 13 – Payment Attributes – For Use With Auxiliary Data Record Type 18
A Re Authorisation
C Unscheduled Payment
D Delayed Charges
I Instalment
Card Acceptor/Cardholder Agreement
1 L Incremental
(see Note 1)
N Not Applicable
R Recurring Payment
S Re Submission
X No show
C Cardholder Not Present (unspecified)
M Mail Order
57
Posn. Attribute Value Meaning
S Using Previously Stored Payment Details
Note 1: Values other than N only to be used with cardholder present, cardholder not present, continuous
authority or electronic commerce sale message types.
Note 2: Values other than N only to be used with cardholder not present or electronic commerce message
types
Mastercard
Customer
Data To Be Sent In Ecommerce Auxiliary
Description Instruction Value
Data Record Type 0101
To Be Used
ECI = 02
Cardholder was successfully
ATSD = D091 G
authenticated.
CAV = UCAF value that starts with a ‘j’
Authentication could not be ECI = 01
completed but a proof of ATSD = D092 H
authentication attempt was provided. CAV = UCAF value that starts with an ‘h’
58
Customer
Data To Be Sent In Ecommerce Auxiliary
Description Instruction Value
Data Record Type 0101
To Be Used
Authentication could not be
ECI = not present
completed because of technical or
ATSD = D080 J
other problems or SecureCode
CAV = not present
processing was not performed.
Visa
Customer
Data To Be Sent In Ecommerce Auxiliary
Description Instruction Value
Data Record Type 0101
To Be Used
ECI = 05
Secure electronic commerce
ATSD = D0C1 G
transaction.
CAV = CAVV
Non-authenticated security
transaction at a 3D Secure-capable ECI = 06
merchant, and merchant attempted ATSD = D0C2 H
to authenticate the cardholder using CAV = CAVV
3D Secure.
Authentication could not be ECI = 07
completed because of technical or ATSD = D0C4 J
other problems. CAV = not present
ECI = 07
Verified By Visa processing was not
ATSD = D080 J
performed.
CAV = not present
59
APPENDIX 1: CURRENCIES SUPPORTED
ISO Currency
ISO Currency
Currency Code
Code (Alpha)
(Numeric)
Australian Dollar AUD 036
Bahraini Dinar BHD 048
Brazilian Real BRL 986
Canadian Dollar CAD 124
Danish Krone DKK 208
Egyptian Pound EGP 818
Euro EUR 978
GB Pound Sterling GBP 826
Hong Kong Dollar HKD 344
Indian Rupee INR 356
Japanese Yen JPY 392
South Korean Won KRW 410
Kuwait Dinar KWD 414
Lebanese Pound LBP 422
Malaysian Ringgit MYR 458
New Israeli Shekel ILS 376
New Turkish Lira TRY 949
New Zealand Dollar NZD 554
Nigerian Naira NGN 566
Norwegian Krone NOK 578
Polish Zloty PLN 985
Qatari Rial QAR 634
Russian Rubble RUB 643
Saudi Riyal SAR 682
Singapore Dollar SGD 702
South African Rand ZAR 710
Swedish Krona SEK 752
Swiss Franc CHF 756
Thai Baht THB 764
Ukrainian Hryvnia UAH 980
United Arab Emirates Dirham AED 784
United States Dollar USD 840
Yuan Renminbi (Chinese) CNY 156
60
APPENDIX 2: SUPPLEMENTARY GUIDES
This section of the Authorisation And Settlement Technical Specifications provides details of the
supplementary guides that are available from us. These guides provide additional details to allow the support
of functionality for niche markets. They are not standalone documents and must be read in conjunction with
this guide.
You must seek our agreement prior to implementing the functionality detailed in these guides.
61
Global Payments
51 De Montfort Street
Leicester
LE1 7BB
Tel 0345 702 3344
Textphone 0345 602 4818
www.globalpaymentsinc.co.uk
www.globalpaymentsinc.com
Global Payments is HSBC’s preferred supplier for card processing in the UK.
Global Payments is a trading name of GPUK LLP. GPUK LLP is authorised by the Financial Conduct Authority under
the Payment Services Regulations 2009 (504290) for the provision of payment services and under the Consumer Credit
Act (714439) for the undertaking of terminal rental agreements.
GPUK LLP is a limited liability partnership registered in England number OC337146. Registered Office: 51, De Montfort
Street, Leicester, LE1 7BB. The members are Global Payments U.K. Limited and Global Payments U.K. 2 Limited.
Service of any documents relating to the business will be effective if served at the Registered Office.