Field 48: Additional Private Data

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:

  • 00 - Successful

  • 01 - Unsuccessful

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:

  • 1 - Mark-up

  • 2 - Mark-up Above European Central Bank

  • 3 - Mark-up Below European Central Bank