Format: LLLVAR…999
Description: This will be used to send requests and responses related to services not dealt with by other fields. This data element utilises the Tag, Length, Value (TLV) structure to delineate different sub-elements in the following manner:
<LLL><TAG><LENGTH><VALUE><TAG><LENGTH><VALUE> ………
-
LLL: This describes the aggregate length of the data in data element 48.
Format: 2 bytes BCD (first nibble will be zero filled).
-
TAG: This sub-field contains a numeric value describing the data that is to follow in the length and value fields. The tag values and the actual data they represent are outlined in the table below.
Format: 2 bytes BCD (first nibble will be zero filled).
-
LENGTH: This sub-field contains a numeric value that may vary from 0 to 99 describing the length of the data that is to follow in the value sub-field.
Format: 1 byte BCD. (Tag 18 uses 2 bytes BCD).
-
VALUE: This sub-field contains the data associated with a particular tag. The length of this data should be the same as that indicated in the length sub-field.
Format: see table below for individual tag formats.
Tag |
Description |
Format |
Bytes |
---|---|---|---|
001 |
Item Number |
n 3 |
2 |
002 |
ELAVON STAN |
n 6 |
3 |
003 |
ELAVON Date and Time |
n 12 |
6 |
004 |
ELAVON RRN |
n 12 |
6 |
005 |
ELAVON Void Item Number |
n 3 |
2 |
017 |
Forex Generic Info |
n 20 |
10 |
018 |
Forex Data |
n ..1312 |
..656 |
Message Type Indicator |
Tag 001 |
Tag 002 |
Tag 003 |
Tag 004 |
Tag 005 |
Tag 017 |
Tag 018 |
---|---|---|---|---|---|---|---|
1100 Pre-Authorisation Request |
M |
- |
- |
- |
- |
- |
- |
1110 Pre-Authorisation Response |
M |
C |
C |
M |
- |
- |
- |
1200 Sale/Completion Request |
M |
- |
- |
- |
- |
- |
- |
1210 Sale/Completion Response |
M |
C |
C |
M |
- |
- |
- |
1220 Refund/Force/DCC Quote Rejection Request |
M |
- |
- |
- |
- |
- |
- |
1221 Refund/Force/DCC Quote Rejection Request |
M |
- |
- |
- |
- |
- |
- |
1230 Refund/Force/DCC Quote Rejection Response |
M |
C |
C |
M |
- |
- |
- |
1420 Reversal Request |
M |
C |
M |
C |
C |
- |
- |
1430 Reversal Response |
M |
- |
- |
- |
- |
- |
- |
1304 Exchange Rate Request |
- |
- |
- |
- |
- |
- |
- |
1305 DCC Inquiry Request |
- |
- |
- |
- |
- |
- |
- |
1314 Exchange Rate Response |
- |
- |
- |
- |
- |
M |
M |
1315 DCC Inquiry Response |
- |
- |
- |
- |
- |
M |
M |
Key: M = Mandatory Tag | C = Conditional Tag | - = Not Required |
Tag 001 (Item Number)
In a Single Message configuration, Tag 001 (Item Number) will increase in value incrementally from 000 to 999 with each approved transaction in a given batch. Once the maximum value of 999 is reached the batch must be closed resulting in the batch number increasing by 1 and the Item Number reverting to 000.
The Item Number should be set to 000 for the first item in a batch.
The Elavon host will return the Item Number value in the appropriate 1110, 1210, 1230 or 1430 response message. The POS device or partner host system should supply this value in Field 48 of the next transaction in order to confirm that it received the previous response.
Dual message solutions should default this field to 001.
Tag 002 (Elavon STAN)
The Elavon STAN will be returned to the POS or partner host system in the event of an approval of a sale transaction. This data must be provided to the Elavon host in the event of a reversal of the aforementioned sale transaction. This sub-field must be populated irrespective of whether single or dual message processing is used.
Tag 003 (Elavon Date and Time)
The Elavon Date and Time will be returned to the POS or partner host system in the event of an approval of a sale transaction. This data must be provided to the Elavon host in the event of a reversal of the aforementioned sale transaction. This sub-field must be populated irrespective of whether single or dual message processing is used. In the event of a Time-Out the date and time of the original transaction being reversed must be used.
Tag 004 (Elavon RRN)
The Elavon RRN value will be returned to the POS or partner host system in the event of an approval of a sale transaction. This data must be provided to the Elavon host in the event of a reversal of the aforementioned sale transaction. This sub-field must be populated irrespective of whether single or dual message processing is used.
Tag 005 (Elavon Void Item Number)
The Elavon Void Item number will only be populated in single message operation. The Elavon Void Item number must be provided to the Elavon host in the event of the reversal of a previously authorised sale (1200), refund or force (1220) transaction.
See section 4: Important Message Fields, Additional Private Data – Field 48 for more information on the use of these Tags.
Tag 017 (Forex Generic Info) / Tag 018 (Forex Data)
Tags relates to foreign exchange rate data. Each will contain subfields constructed as follows:
PDS17 |
|||||
---|---|---|---|---|---|
Subfield Name |
Usage |
Format |
Bytes |
||
PDS Length |
Length |
n2 |
1 |
||
|
Position |
Subfield Name |
Description |
|
|
Data |
1-2 |
Error Indicator |
Valid values:
In the event of an unsuccessful attempt, the terminal should not make any changes to local rates files or offer DCC following a DCC Enquiry Request. |
n17 |
9 |
3-5 |
Base Currency Code |
The ISO numeric currency code of the base currency to which the exchange rates relate |
|||
6-17 |
Timestamp |
The date and time in GMT at which the exchange rates will expire. Format: CCYYMMDDHHMM |
Note: As per Numeric encoding, if the length of tag is an odd number, leading zero is added in the left nibble of the first byte of the right-justified tag data.
PDS18 |
|||||
---|---|---|---|---|---|
Sub field Name |
Usage |
Format |
Bytes |
||
PDS Length |
Length |
n4 |
2 |
||
Number of Exchange Rates |
Number of exchange rates to follow. In a DCC Enquiry Response only one DCC rate will be returned. |
n2 |
1 |
||
The following are repeated for each currency code sent: |
|||||
|
Position |
Subfield Name |
Description |
|
|
Data |
1-3 |
Currency Code |
ISO Numeric Currency Code |
n16 |
8 |
4 |
Conversion Exponent |
Number of digits in the exchange rate exponent |
|||
5-12 |
Conversion Rate |
Exchange rate |
|||
13-15 |
Mark-Up % |
Mark-Up fee for transaction as a percentage. Two decimal places are implied e.g. 350 = 3.5%. To be displayed on device screens and receipts. Please note: if Mark-Up is calculated by Elavon as being above 9.99% or below -9.99% DCC will not be offered. |
|||
16 |
Mark-Up Text Indicator |
Indicates which supporting text must be displayed alongside the Mark-Up % value. Valid values:
|