Field Definitions

Access_Code

This value is used to identify the randomly generated access code that is tied to the primary customer for the account created as part of the loyalty program.

Len Type Description
6

Alpha

A random access code tied to the primary customer for the created account

Account_Balance_1

For Credit and Debit cards, if present this value indicates the remaining balance for a pre-paid account. For EBT transactions, if present this value indicates the remaining Food Stamp balance.

For Gift Card transactions, if present this value indicates the remaining Gift Card balance on the account. The usages for the Account Balance fields are outlined below:

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Account_Balance_2

For Credit and Debit cards, if present this value indicates the remaining Gift Card Balance on the account. For EBT transactions, if present this value indicates the remaining Cash Benefit balance.

For Gift Card transactions, if present this value indicates the remaining Loyalty points on the account.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Account_Balance_3

For Credit and Debit cards, if present this value indicates the remaining Loyalty points on the account.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Account_Data

The value is used to submit the cardholder account data to Elavon for processing.

Len Type Description

160

76

35

Alpha

The account Data can be entered in one of the following formats:

1)   Track 1 (max length =76) or Track 2 (max length =37) data as read from a Magnetic Stripe Reader (MSR) or proximity with the start and end sentinels removed from the track.  Track data is only used on original authorization requests.

2)    Manually entered card data (Account Number=MMYY)

3)    Manually entered card data (Account Number)  Expiration Date is optional for Debit and EBT

4)   The unformatted MICR data exactly as read from the MICR line of the check, including spaces, except that the MICR symbols will be replaced as follows: (“raw TOAD” format):

  • The Transit symbol ( ) must be replaced by the letter (T) in either upper or lower case.
  • The On - us symbol ( ) must be replaced by the letter (O) in either upper or lower case.
  • The Amount symbol ( ) must be replaced by the letter (A) in either upper or lower case.
  • The Dash symbol ( ) must be replaced by the letter (D) in either upper or lower case.

5)    The manually entered Check Data in the following Format: (Spaces and Dashes removed)

  • For POP, ARC, or BOC transactions (exception processing)

    • “T” + (Transit\Routing) + “T” + Checking Account Number + “O” + Check Number

o Example: T987654321T1234567890123456O12345

  • For WEB, TEL, PPD, CCD transactions

    • “T” + (Transit\Routing) + “T” + Checking Account Number + “O”

o Example: T987654321T1234567890123456O

6)   The parsed Checking Account Number as returned in the authorization response message. This format is used for Terminal-Based settlements only.  (Account Number)

7)    Token data (Token Data=MMYY)

8)    Token data (Token Data)  Expiration Date is optional for Debit and EBT

9)    Encrypted account information

  • Encrypted Track 1 or Track 2 Data with Start and End sentinels removed

  • Encrypted Pan and Expiration Date in “Account Number=MMYY” format

Account_Entry_Mode

This value is used to identify the method used to enter the Account Data for the transaction.

Len Type Code Description
2

Numeric

01

Key Entered – Card Not Present (01)

02

Key Entered – Card Present (71)

12

Key Entered – Credential on File

03

Swiped (90)

04

Proximity (91)

05

EMV (ICC) with CVV or iCVV (05)

06

EMV (ICC) proximity read (07)

07

EMV (ICC) with no CVV or iCVV (95)

08

EMV (ICC) – Mag stripe Read when the chip failed to read

09

EMV (ICC) – Digital Secure Remote Payment (09)

10

Scanned MICR (84)

11

Keyed MICR

Account_Number

This value is the CFNA Bridgestone / Firestone Applicant’s account number returned from the instant credit application request.

Len Type Description
9

Alpha

The applicant’s CFNA account number.

Account_Source

This value is used to facilitate transaction routing on Elavon.

Len Type Code Description
1

Numeric

0

Manually entered transaction originated at a device capable of reading track 1 or 2

1

Inquiry originated at a track 1 magnetic stripe reading device (capable of reading track 1 or 2 data)

2

Inquiry originated at a track 2 magnetic stripe reading device

3

Inquiry originated at a Proximity payment reading device

4

Inquiry originated at a MICR device

Account_Status

This value is used to identify the cardholder’s account status in the loyalty inquiry response transaction.

Len Type Code Description
1

Alpha

1

Setup (Lead)

2

Active

3

Suspended

4

Expired

5

Closed

Account_Type

This value is used to facilitate transaction routing on Elavon.

Len Type Code Description
1

Numeric

0

Default or primary account on file ( In Canada this is only used for Flash Transactions )

1

Checking

2

Savings

3

Food Stamp

4

Cash Benefits

Activation_Amount

This value is used to identify the total amount of all Gift Card Activation transactions in the batch.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Activation_Count

This value is used to identify the total number of all Gift Card Activation transactions in the batch.

Len Type Description
8

Numeric

The total number of Gift Card Activations.

Additional_Amount

This value is used to identify that additional amount for a Brazilian Installment transaction.

Len Type Description
7

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Additional_Key_Available

This value is returned in the EMV Key exchange response message to identify if another EMV Key is available to be retrieved from the host.

Len Type Code Description
1

Numeric

0

No – There an no more remaining keys for download

1

Yes – There are more keys are available for download

Amex_Capture_Code

This is the American Express Capture Code field and is returned during a credit card authorization response. It determines the capture option allowed for the American Express Card in the Split Dial environment, where the POS is accessing Amex directly for Authorization processing of Amex Cards.

Len Type Code Description
1

Numeric

0

Do not process

1

Allow authorizations but do not capture in Settlement file

2

Allow authorizations and capture in settlement file for processing

Annual_Income_Amount

This field is used to indicate the applicant’s annual gross income from all sources for the Bridgestone/Firestone instant credit application request.

Len Type Description

10

Numeric

The Annual Income Amount is submitted in whole dollars.  ($10,000 is sent as 10000 )

Application_ID

This field is used to indicate the type of POS device that is originating the transaction. These values are case sensitive and must be capitalized.  Sample: HZ0000GC

Len Type Digit Description
8

Alpha

Digit 1

Processing Type

H = Host-Based

T = Terminal-Based

Digit 2

Device Type

Z = 3rd  Party Vendor Solution

Digit 3-6

Vendor ID Number, as assigned by Elavon

Digit 7

Market Segment

G = General

R = Retail, Restaurant

M = Mail Order / Telephone Order

I = (MOTO) Internet (e-Commerce)

L = Lodging

A = Auto Rental

Digit 8

Communication Module

Space = Dial

A = NOVA API

L = NOVA Link SSL

C = SSL Gateway

W = Wireless

X = (CDMA) Custom TCP/IP

Application_Type

This field is used to indicate the application type used to submit the Bridgestone/Firestone instant credit application request.

Len Type Code Description
2

Alpha

00

Housing expenses not collected

01

Housing expenses collected

Approval_Code

This field contains the approval code for the transaction.

Len Type Description
6

Alpha

This field contains the Approval Code for an approved transaction.

Note: If the Response Code on the authorization is not equal to "AA", “AP” or “AC” the contents of this field are ignored.

Association_Name

This value is returned in the authorization response messages and is used to indicate the association name for the transaction.  i.e. Visa, Visa Debit, Visa Electron, MasterCard, MasterCard Debit, EBT, etc.

Len Type Description

38

Alpha

Indicates the association name for the transaction

Association_Token_Indicator

This field is used to identify if the data in the Account Data field contains an Association defined token replacement value instead of the original account data.

Len Type Code Description
1

Numeric

0

No Association Token used (default value)

1

The data in the Account Data field is an Association defined Token Value

Authorization_Date

This value is the date which the transaction was authorized. For offline transactions, this value should be set to the date when the transaction occurs.

Len Type Description
6

Numeric

The transaction date in MMDDYY format.

Authorization_Response

This field contains the 16 character response display message. This field is used by the POS device to display the authorization results.

Len Type Description

16

Alpha

Message Code Definition
APPROVAL AA Approved
APPROVAL AA Approved
APPROVAL AP Approved Partial
APPROVAL AC Approved (without Cashback)
SERV NOT ALLOWED ND Invalid request
REQ EXCEEDS BAL ND Request exceeds balance
NOT ON FILE ND Cardholder not found
EXPIRED CARD ND Expired Card
INCORRECT PIN ND Invalid PIN
PICK UP CARD NC Pick up card
INVALID CARD ND Invalid Card
DECLINED ND Do Not Honor
CALL AUTH CENTER NR Refer to Issuer
DECLINED-HELP 9999NDSystem Error
CALL REF.; 999999NRRefer to Issuer
AMOUNT ERRORND Tran Amount Error
INVALID TERM IDND Invalid Terminal ID
INVLD TERM ID 1ND Invalid Merchant Number
INVLD TERM ID 2ND Invalid SE Number
REC NOT FOUNDNFRecord not on Elavon Network
INVLD VOID DATAND Invalid Data
TOKEN ERRORNDInvalid Token
ERR PLS CALLNDCall for Assistance
APPL TYPE ERRORNDCall for Assistance
DECLINE CVV2N7Do Not Honor due to CVV2 mismatch \ failure MUST SETTLE MMDD ND Must settle, open batch is over 7 days old.
Note:

Batch will be Auto Settled after 10 days

 

Gift Cards:

Message Code Definition
APPROVAL AA Approved
DECLINED-HELP 9999 01 Host Busy
INVALID CARD 02 Invalid Card
INVALID TERM ID 03 Invalid Terminal ID
AMOUNT ERROR 04 Tran Amount Error
ALREADY ACTIVE 05 Card already active
REQ. EXCEEDS BAL. 06 Request exceeds balance
MAX REACHED 07 Cannot load the amount specified NON RELOADABLE 08 The card cannot be reloaded.
CARD ALREADY ACTIVE 12 The EGC card is already activated DECLINED-HELP 9999 99 General System Error
SERV NOT ALLOWED ND Invalid request
INVLD TERM ID 1 ND Invalid Merchant Number SEQ ERR PLS CALL ND Call for Assistance
APPL TYPE ERROR ND Call for Assistance

 

Private Label:

Message Code Definition
AP xxxxxx $9999 AA CFNA Private Label Approval
DECLINEDNDSale is Not Approved
CALL 18007629000NRCall CFNA Credit Department for more information

Authorization_Source

This value is used to indicate the source for the authorization response. The values in this response message are subject to additions.

For On-Line transactions, the codes are supplied by the Issuer and are returned by Elavon in the response message for all on line approvals.

For Off-Line transactions, this is a one character field in the table below contains the Authorization Source code.

Len Type Code Description
1

Alpha

9

No Authorization Source Code. This is used for non-authorized transactions, such as Credit Card Returns

E

Off-Line Approval. This is used when the approval code is manually entered, such as on a Referral or Force Transaction

6

Off-Line approval, POS generated the approval.

Authorization_Time

This value is the time which the transaction was authorized. For offline transactions, this value should be set to the time when the transaction occurs.

Len Type Description
6

Numeric

The transaction time in HHMMSS format.

Authorized_Amount

This value is used to identify the total authorized amount for the authorization request. If the Partial authorization flag is enabled, this amount may be less than the requested amount.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Auto_Rental_Number

This value is the auto rental number as entered by the property. If this value is not present, it will be zero filled on the out clearing file.

Len Type Description

25

Alpha

Auto Rental Number

AVS_Response

This value contains the address verification response code returned in response message as a result of an AVS Request. It is also a required value for a terminal-based settlement, if returned in the authorization response.

Len Type Code Description
1

Alpha

A

Address (Street) matches, Zip does not.

B

Street address match, Postal code in wrong format. (international issuer)

C

Street address and postal code in wrong formats

D

Street address and postal code match (international issuer)

E

AVS error

F

Address does compare and five-digit ZIP code does compare (UK only).

G

Card issued by a non-US issuer that does not participate in the AVS System

I

Address information not verified by international issuer.

M

Street Address and Postal code match (international issuer)

N

No Match on Address (Street) or Zip

P

Postal codes match, Street address not verified due to incompatible formats.

R

Retry, System unavailable or Timed out

S

Service not supported by issuer

U

Address information is unavailable (domestic issuer)

W

9 digit Zip matches, Address (Street) does not

X

Exact AVS Match

Y

Address (Street) and 5 digit Zip match

Z

5 digit Zip matches, Address (Street) does not

Batch_Number

This value is assigned by the Elavon host and will be returned in the authorization and batch response messages. For Terminal-Based authorization response messages, the batch number will be zero (0) .

Len Type Description
3

Numeric

A three digit value assigned by the Elavon host

CA_Public_Key_Exp_Date

This value is the date at which the public key will become expired.

Len Type Description
6

Numeric

CA Public Key Expiration Date in YYMMDD format

CA_Public_Key_Length

This value is one of the elements of the public key used to confirm the size of the public key in the cryptography process.

Len Type Description
2

Hex

Length of the Public Key

Capture_Code

This field is used to indicate to the POS which transactions should be captured in the local Shadow file.

Len Type Code Description
1

Numeric

0

Do not Capture – Authorization Only

1

Capture Transaction in Shadow File (EDC)

2

Capture Transaction in Shadow File (EDC) This value is used for Debit Returns to indicate that the Debit Purchase is in the current batch.

Capture_Tran_Code

This field is used to indicate the type of transaction that is being submitted for settlement.

Len Type Code Description
1

Numeric

1

American Express Be My Guest Program

2

Purchase / Sale, Mail / Phone Order

3

Debit Card Purchase

4

Debit Card Purchase Return

5

Purchase / Sale

6

Return or Credit

7

Cash Disbursement

8

Debit Card Pre-Authorization Completion

Card_ID

This field is used to indicate the method used to obtain / verify the cardholder’s identity.

Len Type Code Description
1

Alpha

@

Signature Used for ID

A

PIN used for ID

N

Address used as ID or No CMV used

Card_Refund_Amount

This value is used to identify the total amount of all Gift Card “Card Refund” transactions in the batch.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Card_Refund_Count

This value is used to identify the total number of all Gift Card “Card Refund” transactions in the batch.

Len Type Description
8

Numeric

The total number of Gift Card “Card Refund” transactions.

Cardholder_Amount

This is the amount of the transaction that the cardholder will be billed in the card issued currency. For Terminal-Based settlement messages, this value will contain the total amount of the transaction in the Cardholder’s currency, including any Tips (for restaurant transactions).

Amount Rounding

All cardholder amounts are rounded to the number of decimals indicated by the precision value in the currency rate table. Amounts are rounded up when a five (5) or greater is present after the precision value and are rounded down when a four (4) or less is present. 

For example, an Australian dollar amount of $12.345111 would round to $12.35 since the precision indicator for Australian Dollar is two (2). A Japanese Yen amount of ¥1234.56789 would round to ¥1235 since the precision indicator for the Japanese Yen is set to a value of zero (0).

Len Type Description

12

Numeric

Two decimals are implied. (One euro would be sent as 100 and one cent would be sent as 1). Since the Japanese Yen is rounded to a whole number, one Yen would be transmitted as 100.

Sample Rate Conversions

$10.00 USD *

112.27188 (JPY Rate) = ¥ 1122.7188

which rounds to ¥ 1123

$10.00 USD *

0.55074 (GBP Rate) = £ 5.5074

which rounds to ¥ 5.51

$10.00 USD *

0.80363 (EUR Rate) = € 8.0363

which rounds to € 8.04

$10.00 USD *

1.2616 (CAD Rate) = $ 12.616

which rounds to $ 12.62

$10.00 USD *

1.35045 (AUD Rate) = $ 13.5045

which rounds to $ 13.50

The amount values are only rounded to the next significant digit after the precision indicator. In another example containing an Australian dollar amount of $12.3445 would round to $12.34 since the value after the Precision Indicator for the above rate is four (4).

Cardholder_Currency

This value is the Cardholder’s currency code as represented by the three (3) digit alpha Currency value. This is used on DCC transactions only.  See the Currency Code Table for a complete list of currencies.

Len Type Description
3

Alpha

The three (3) digit alpha currency code value

Cardholder_ID

This field is used on Bridgestone/Firestone Instant Credit message to identity of the applicant.

Len Type Description
9

Numeric

The applicant’s social security number (SSN).

Cashback_Amount

This field is used to indicate the cashback amount applied to the transaction. This amount should be included in the Transaction Amount field.

Len Type Description
8

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

CAT_Indicator

This value is used to indicate the type of Cardholder Activated Terminal Indicator for this transaction.

Len Type Code Description
2

Numeric

00

Not a CAT Transaction (default value)

01

Limited Amount Terminal

02

Automated Dispensing Machine

03

Self-Service Terminal (AFD)

04

In-Flight Commerce

05

Internet

06

Transponder

07

Remote Indicator

Check_In_Date

This value is used to identify the lodging check in date for this room/folio number.

Len Type Description
8

Numeric

The check in date in MMDDYYYY format.

Check_Out_Date

Used to identify the check-out date for this room/folio number.  This is the “Transaction Date” for lodging transactions.

Len Type Description
8

Numeric

The check-out date in MMDDYYYY format.

Check_Sum

This is a check value that is calculated on the concatenation of all parts of the public key.

Len Type Description

40

Hex

Certification Authority Public Key Check Sum

Clinic-Other_Amount

This value is used to submit the amount of all Clinical or other qualified medical expenses contained within this purchase.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Completion_Date

This value contains the date that the consumer’s travel will be completed.

Len Type Description
6

Numeric

The date that the consumer’s travel will be completed in YYMMDD format.

Credit_Amount

This value is used to identify the total amount of all Gift Card Credit transactions in the batch.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Credit_Count

This value is used to identify the total number of all Gift Card Credit transactions in the batch.

Len Type Description
8

Numeric

The total number of Gift Card Credit transactions.

Credit_Limit

This is the total credit limit returned from a CFNA Bridgestone / Firestone credit application request.

Len Type Description
5

Numeric

The decimal is not implied and values are rounded up to whole numbers.  ($1 is sent as 1)

Credit_Return_Amount

This value is used to submit the total amount of all Credit Card Return transactions.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Credit_Return_Count

This value is used to submit the total count of all Credit Card Return transactions.

Len Type Description
8

Numeric

Total count for all Credit Card Return transactions.

Credit_Sale_Amount

This value is used to submit the total amount of all Credit Card Sale and Force transactions.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Credit_Sale_Count

This value is used to submit the total count of all Credit Card Sale and Force transactions.

Len Type Description
8

Numeric

Total count for all Credit Card Sale and Force transactions.

Credit_Authorization_Amount

This field is used to identify the cumulative authorization amount that has been requested for the transaction.

Len Type Description
12

Numeric

The decimal is implied. ($1 is sent as 100 and 1¢ is sent as 1)

Currency_Code

This value is ISO Currency Code used in the Foreign Exchange Rate message.

Len Type Description
3

Alpha

The three (3) digit alpha currency code value. See the Currency Code Table for a complete currency list.

Customer_Code

This value is used to identify the customer number for purchasing card transactions.

Len Type Description

17

Alpha

The Customer Code value for a Purchasing Card transaction.

Customer_Phone_Number

This value is used to identify the customer’s Phone number on the transaction request.

Len Type Description

10

Numeric

The consumer’s phone number including the area code. (no Dashes or Spaces)

CVV2_Indicator

This value is used to indicate the presence of the CVV2 data on the Visa card. For non-Visa Cards, the value of “Present” should be used when CVC2 or CID data is present, or “Bypassed” when not present.

Len Type Code Description
1

Numeric

0

Bypassed

1

Present

2

Illegible

9

Not Present

CVV2_Response

This value contains the Card verification response code returned in Authorization Response. It is also a required value for a terminal-based settlement message, if returned in the authorization response.

Len Type Code Description
1

Alpha

M

Match

N

No match

P

Not Processed

S

Issuer indicates that CVV2 data should be present on the card, but the merchant has indicated that the CVV2 data is not present on the card ( Visa Only )

U

Issuer not certified or registered to process card verification

CVV2_Value

This three to four digit value appears at the end of the printed PAN on the reserve side of the card and is used to verify a card’s presence in the mail order, telephone order (MO/TO) and card-not-present environments.

Len Type Description
4

Alpha

3-4 digit value on back of card (Left Justified, Trailing Spaces)

Data_Type

This field identifies the type of EMV Key that is being sent. The default value is “CA Public Key”.

Len Type Code Description
2

Numeric

01

CA Public Key

Date_of_Birth

This field is used on Bridgestone/Firestone Instant Credit message to identity the birth date of the applicant.

Len Type Description
8

Numeric

The applicant’s birth date in MMDDYYYY format.

DCC_Exponent

This value indicates the number of exponent digits in the DCC Rate.

Len Type Description
1

Numeric

0-9  The number of exponent digits in the DCC Rate

DCC_Indicator

This value is used to indicate that the POS device is Dynamic Currency Conversion (DCC) capable and the current transaction is eligible for conversion.

Len Type Code Description
1

Alpha

N

Not a DCC eligible transaction (default)

Y

DCC eligible transaction

Z

DCC eligible transaction and POS has already performed DCC

M

Multi-Currency

DCC_Markup_Percentage

This is the markup percentage that has been included in the calculation of the DCC rate for this transaction.

Len Type Description
4

Numeric

The DCC Rate Markup is expressed with two implied decimals.  (3.25% is sent as 0325)

DCC_Rate

This is the Foreign Exchange Rate used to convert the amount from the Merchant’s currency to Cardholder’s currency.

Len Type Description
8

Numeric

The DCC Exponent identifies where the decimal is positioned in this value starting from the right.

i.e. “ 12345678” with an exponent of “ 5” would be represented as a foreign exchange rate of “ 123.45678

DCC_Rate_Provider_Name

This value is used to return the name of the entity that provided currency exchange rate.

Len Type Description

35

Alpha

Indicates the name of the currency rate provider

DDD_Secure_Value

This value is returned by the 3-D Secure authentication system for Visa (Verified by VISA), MasterCard (SecureCode), American Express (SafeKey) or Discover (ProtectBuy) programs.

Len Type Description

40

or 48

or 80

Hex

The Cardholder Authentication Verification Value (CAVV) is a cryptographic value that is generated by the Issuer's Verified By VISA (ACS) server when a registered cardholder successfully passes the verification process. (40 Characters)

The Universal Cardholder Authentication Field (UCAF) is a cryptographic value or "security token" for MasterCard cardholders who successfully pass the verification process. (up to 48 Characters)

This field can be used for American Express to submit a SafeKey Cryptogram (40 characters) for 3DSecure processing or up to two SafeKey Cryptograms (40 or 80 characters) used for an American Express Digital Wallet Transaction.

This field can be used to submit the CAVV value for a Discover Protect Buy 3DSecure transaction or for an “In-App” purchase from a mobile device. (40 Characters)

Debit-EBT_Network_ID

This value is used to indicate the Debit Network that the transaction was routed through for authorization. It may also be used on the Debit Purchase and PINless Purchase transaction to indicate the preferred Debit Network routing ID for authorization.

Len Type Code Description
2

Alpha

AF

AFFN

AO

Alaska Option

CU

Credit Union 24

EB

EBT Network

EX

Accel

IL

Interlink

MR

Maestro

NT

NETS

NY

NYCE

PS

Pulse

ST

Star

SZ

Shazam

Debit_Interchange_Indicator

This response value is used to indicate that a special interchange rate was used in the processing of this transaction.

Len Type Code Description
1

Alpha

0

Does not participate

1

Pulse

A

All Star

D

Durbin Qualified

F

Durbin Qualified (Additional Fraud Review)

P

NYCE Premier

Debit_Response_Code

This value is returned by the debit gateway for a Canadian debit authorization attempt. If a value of “TO” is returned in this field indicating a transaction time out, then a debit reversal message will need to be generated from the POS device.

All response codes have a field length of 2 and a type of Alphanumeric.

Len Type Description
2

Alpha

 

External PIN Pad

Internal

Code

Elavon

Description

Terminal

Pin Pad

PIN Pad

00

AA

Approved

Approval authno

Approved

Approval authno

05

ND

Do not honor

Do not honour

Declined

Do not honour

06

ND

Edit error

Error

Declined

Error

12

ND

Invalid processing code

Invalid transaction

Declined

Invalid transaction

13

ND

Invalid amount

Invalid amount

Declined

Invalid amount

14

ND

Edit Error in PAN

Declined

Invalid card number

Invalid card number

19

ND

RFI error – re-enter transaction

Re-enter transaction

Re-enter transaction

Re-enter transaction

40

ND

Requested function not supported

Invalid transaction

Declined

Invalid transaction

51

ND

Non-sufficient funds

Declined

Not sufficient funds

Not sufficient funds

52

ND

No chequing account

Declined

No chequing account

No chequing account

53

ND

No savings account

Declined

No savings account

No savings account

54

ND

Expired card

Expired card

Expired card

Expired card

55

ND

Incorrect PIN

Declined

Incorrect PIN

Incorrect PIN

56

ND

No card record

No card record

No card record

No card record

57

ND

Tran not permitted to cardholder

Unauthorize txn

Declined

Unauthorize txn

58

ND

Tran not permitted to terminal

Invalid transaction

Declined

Invalid transaction

61

ND

Exceeds withdrawal amount limit

Declined

Exceeds amount limit

Exceeds amount limit

62

ND

Restricted card

Declined

Restricted card

Restricted card

63

ND

Security violation –MAC value is incorrect

Security violation

Declined

Security violation

65

ND

Exceeds withdrawal frequency limit

Declined

Exceeds freq limit

Exceeds freq limit

68

ND

Response received too late (Time- Out)

Response timeout

Declined

Response timeout

75

ND

Number of PIN tries exceeded

Declined

PIN tries exceeded

PIN tries exceeded

77

ND

Invalid capture date

No ntwrk shr agrment

Declined

No ntwrk shr agrment

81

ND

Invalid PIN block

Declined

Incorrect PIN

Incorrect PIN

82

ND

PIN length error

Declined

Incorrect PIN

Incorrect PIN

85

ND

No keys available for Use

Suspected malfunc

Declined

Suspected malfunc

86

ND

Message encryption key synchronization error

Suspected malfunc

Declined

Suspected malfunc

87

ND

PIN key synchronization error

Pin key sync error

Declined

Pin key sync error

88

ND

Mac key synchronization error

MAC key sync error

Declined

MAC key sync error

89

ND

Transaction requires Contact Interface

Pls Insert Card

Trn Not Complete

Pls Insert Card

91

ND

Issuer Inc or switch is inoperative

Iss or switch inop

Declined

Iss or switch inop

92

ND

Financial institution or intermediate network facility cannot be found for routing

Cannot contact bank

Declined

Cannot contact bank

94

ND

Duplicate transmission

Dupl transmission

Dupl transmission

Dupl transmission

96

ND

System malfunction

System malfunction

Declined

System malfunction

Q0

ND

Edit error in capture date

No ntwrk shr agrment

Declined

No ntwrk shr agrment

Q9

ND

Response not listed above has been received

Suspected malfunc

Declined

Suspected malfunc

TO

ND

Host time-out

Host time-out

Trn not complete

Host time-out

TQ

ND

Sequence error

Seq err pls call

Trn not complete

Seq err pls call

TX

ND

Service not allowed

Service not allowed

Trn not complete

Service not allowed

TE

ND

Expired card

Expired card

Trn not complete

Expired card

TC

ND

Invalid card

Invalid card

Trn not complete

Invalid card

TA

ND

Amount error

Amount error

Trn not complete

Amount error

TI

ND

Invalid terminal ID

Invalid term ID

Trn not complete

Invalid term ID

TM

ND

Invalid merchant #

Invalid term ID 1

Trn not complete

Invalid term ID 1

TS

ND

Invalid SE #

Invalid term ID 2

Trn not complete

Invalid term ID 2

TR

ND

Record not found on Elavon

Record not found

Trn not complete

Record not found

TV

ND

Invalid data

Invld void data

Trn not complete

Invld void data

TN

ND

Call for assistance

Appl type error

Trn not complete

Appl type error

TP

ND

Please retry

Please retry

Trn not complete

Please retry

TB

ND

Transaction error

Invalid data5276

Trn not complete

Invalid data5276

TZ

ND

Unknown error

System error

Trn not complete

System error

Debit-EBT_Purchase_Amount

This value is used to submit the total amount of all Debit Card and EBT Purchase transactions. This includes Voucher Clear Purchase transactions.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Debit-EBT_Purchase_Count

This value is used to submit the total count of all Debit Card and EBT Purchase transactions. This includes Voucher Clear Purchase transactions.

Len Type Description
8

Numeric

Total count for all Debit and EBT Purchase transactions, including Voucher Clear Purchases.

Debit-EBT_Return_Amount

This value is used to submit the total amount of all Debit Card and EBT Return transactions. This includes Voucher Clear Return transactions.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Debit-EBT_Return_Count

This value is used to submit the total count of all Debit Card and EBT Return transactions. This includes Voucher Clear Return transactions.

Len Type Description
8

Numeric

Total count for all Debit and EBT Return transactions, including Voucher Clear Returns.

Debit-EBT_Settlement_Date

This value is the debit switch settlement date in MMDD format.

Len Type Description
4

Numeric

Debit Settlement Date in MMDD format.

Deferment_Count

This value is used to indicate the number of months to defer the first installment payment.

Len Type Description
2

Numeric

Number of Months to defer the first installment payment

Dental_Amount

This value is used to submit the amount of all Dental expenses contained within this purchase.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Departure_Date

This value contains the date that the consumer’s travel will begin.

Len Type Description
6

Numeric

The date that the consumer’s travel will begin in YYMMDD format

Device_Serial_Number

This field is used to identify the manufacturer’s device serial number assigned to the encrypting device.

Len Type Description

20

Alpha

Device Serial Number of the encrypting device

Device_Tag

The device tag number is an optional field that is used by the POS for routing the response back to the originating source (in the case of multi-trans / multi-lane systems).

Len Type Description
6

Alpha

A value used to uniquely identify the transaction request to the response message. Valid Characters (a-z and 0-9) (restricted characters no not allow = or ^)

Device_Type

This value is used to identify the device type used for this transaction. This value is derived from the Third Party Data Tag 9F6E field and is returned in the authorization response message.

Len Type Code Description
2

Alpha

spaces

Not Applicable (default value)

01

Mobile Network Operator (MNO) controlled removable secure element (SIM or UICC) personalized for use with a mobile phone or smartphone

07

Mobile phone or smartphone with a fixed (non-removable) secure element controlled by the MNO, for example, code division multiple access (CDMA)

08

Removable secure element not controlled by the MNO, for example, memory card personalized for used with a mobile phone or smartphone

09

Mobile phone or smartphone with a fixed (non-removable) secure element not controlled by the MNO

10

MNO controlled removable secure element (SIM or UICC) personalized for used with a tablet or e-book

11

Tablet or e-book with a fixed (non-removable) secure element controlled by the MNO

12

Removable secure element not controlled by the MNO, for example, memory card personalized for use with a tablet or e-book

13

Tablet or e-book with fixed (non-removable) secure element not controlled by the MNO

14 - 99

Reserved for Future Use

Digital_Signature_ID

This value identifies the digital signature algorithm to be used with the public key.

Len Type Code Description
2

Alpha

01

Digital Signature (default)

Directory_Server_Tran_ID

The Directory Server Transaction ID is generated by the Directory Server during the authentication transaction and passed back to the merchant with the authentication results.

Len Type Code Description
36

Alpha

01

Directory Server Transaction ID

Download_Start_Date

This field is returned in the authorization response message to identify the Date that the terminal download is being requested.  This is only returned in the Brazilian region.

Len Type Description
6

Numeric

Date in MMDDYY format

Download_Start_Time

This field is returned in the authorization response message to identify the time that the terminal download is being requested.  This is only returned in the Brazilian region.

Len Type Description
6

Numeric

Time in HHMMSS format

Download_Type

This field is returned in the authorization response message to identify the type of terminal download that is being requested.  This is only returned in the Brazilian region.

Len Type Code Description
1

Alpha

R

Regular Download - Indicates that a new application is ready for the terminal but download is not immediately required.

F

Forced Download - Indicates that a new application is ready for the terminal and download is immediately required.

S

Schedule Download - Indicates that a new application is ready for the terminal but download is not immediately required.

Draw_Date

The value is the date that the IVU Lottery drawing will take place.

Len Type Description
6

Numeric

The Loto Draw Date in MMDDYY format.

Draw_Number

The value is the draw number for the IVU Lottery.

Len Type Description
3

Numeric

The Loto Draw Number.

Drivers_License_Number

This value is used to identify the consumer’s driver’s license number for check transactions.

Len Type Description

19

Alpha

This value contains the check presenter’s driver’s license number followed by an equal sign (=) and the two digit state code.  Refer to the State code table

Dynamic_Auth_Type_Indicator

This value allows the Payment Facilitator to dynamically send the authorization type for the sub-merchant that is submitting the transaction.

Len Type Code Description
1

Alpha

F

Final Amount (amount is not expected to change for settlement)

P

Pre-Authorization / Estimated Amount (amount may change between auth and settlement)

Dynamic_City

This value allows for the merchant’s city location to be dynamically changed on each transaction submitted to the host for authorization. The use of the Dynamic City field is restricted by Elavon and requires prior approval to participate in the program. Values that are sent in this field by merchants that are not approved for use of this field will be ignored by the host prior to authorization and the value currently “on file” with Elavon will be used.

Len Type Description

13

Alpha

Merchant’s dynamic city location

Dynamic_Country_Code

This value allows for the merchant’s country code (ISO 366-1) to be changed on each transaction submitted to the host for authorization. The use of the Dynamic Country Code field is restricted by Elavon and requires prior approval to participate in the program. Values that are sent in this field by merchants that are not approved for use of this field will be ignored by the host prior to authorization and the value currently “on file” with Elavon will be used.

Len Type Description
3

Alpha

Merchant’s dynamic country code

Dynamic_DBA_Name

This value allows the merchant to dynamically change the “Doing Business As” name on each transaction submitted to the host for authorization and settlement. The use of the dynamic DBA (dDBA) field is restricted by Elavon and requires prior approval to participate in the program. Values that are sent in this field by merchants that are not approved for use of this field will be ignored by the host prior to authorization and the value currently “on file” with Elavon will be used.

Len Type Description

25

Alpha

Merchant’s dynamic DBA name

Dynamic_Email_Address

This value allows for the merchant’s email address to be dynamically changed on each transaction submitted to the host for authorization and settlement. The use of the Dynamic Email Address field is restricted by Elavon and requires prior approval to participate in the program. Values that are sent in this field by merchants that are not approved for use of this field will be ignored by the host prior to authorization and the value currently “on file” with Elavon will be used.

Len Type Description

70

Alpha

Merchant’s dynamic email address

Dynamic_MCC

This value allows for the merchant’s merchant Category Code (MCC) to be dynamically changed on each transaction submitted to the host for authorization. The use of the Dynamic MCC field is restricted by Elavon and requires prior approval to participate in the program. Values that are sent in this field by merchants that are not approved for use of this field will be ignored by the host prior to authorization and the value currently “on file” with Elavon will be used.

Len Type Description
4

Numeric

Merchant’s dynamic Merchant Category Code (MCC)

Dynamic_Phone_Number

This value allows for the merchant’s phone number to be dynamically changed on each transaction submitted to the host for authorization and settlement. The use of the Dynamic Phone Number field is restricted by Elavon and requires prior approval to participate in the program. Values that are sent in this field by merchants that are not approved for use of this field will be ignored by the host prior to authorization and the value currently “on file” with Elavon will be used.

Len Type Description

20

Numeric

Merchant’s dynamic phone number

Dynamic_Postal_Code

This value allows for the merchant’s postal code to be dynamically changed on each transaction submitted to the host for authorization and settlement.  The use of the Dynamic Postal Code field is restricted by Elavon and requires prior approval to participate in the program. Values that are sent in this field by merchants that are not approved for use of this field will be ignored by the host prior to authorization and the value currently “on file” with Elavon will be used.

Len Type Description
9

Alpha

Merchant’s dynamic postal code

Dynamic_State

This value allows for the merchant’s State to be dynamically changed on each transaction submitted to the host for authorization and settlement. The use of the Dynamic State field is restricted by Elavon and requires prior approval to participate in the program. Values that are sent in this field by merchants that are not approved for use of this field will be ignored by the host prior to authorization and the value currently “on file” with Elavon will be used.

Len Type Description
2

Alpha

Merchant’s dynamic state

Dynamic_Street_Address

This value allows for the merchant’s street address to be dynamically changed on each transaction submitted to the host for authorization and settlement.

The use of the Dynamic Street Address field is restricted by Elavon and requires prior approval to participate in the program. Values that are sent in this field by merchants that are not approved for use of this field will be ignored by the host prior to authorization and the value currently “on file” with Elavon will be used.

Len Type Description

30

Alpha

Merchant’s dynamic street address

Dynamic_Tax_ID

This value allows for the sub-merchant’s tax ID to be dynamically changed on each transaction submitted to the host for authorization. The use of the Dynamic Tax ID field is restricted by Elavon and requires prior approval to participate in the program. Values that are sent in this field by merchants that are not approved for use of this field will be ignored by the host prior to authorization and the value currently “on file” with Elavon will be used.

Len Type Description

14

Alpha

Sub-Merchant’s tax ID

Dynamic_Sub-Merchant_ID

This value allows for the sub-merchant ID to be dynamically changed on each transaction submitted to the host for authorization and settlement. The use of the Dynamic Sub-Merchant ID field is restricted by Elavon and requires prior approval to participate in the program. Values that are sent in this field by merchants that are not approved for use of this field will be ignored by the host prior to authorization and the value currently “on file” with Elavon will be used.

Len Type Description

15

Numeric

Dynamic Sub-Merchant ID

E-Commerce_Indicator

This indicates the method used to capture the cardholder’s information for an eCommerce or Internet transaction.

Len Type Code Description
1

Alpha

1

Secure Electronic Commerce Transaction that includes the 3-D Secure Authentication value. (5)

2

Non-Authenticated Security Transaction from a 3-D Secure capable merchant, and merchant attempted to authorize using 3-D Secure.

Transaction Does NotInclude 3-D Secure authentication value. (6)

3

Non-Authenticated Security Transaction w/o Merchant Certificate i.e., Channel Encrypted (7)

4

Non-Authenticated Security Transaction at a SET Capable merchant (9)

5

Non-Secure Transaction (no encryption used) (8)

D

Digital Wallet (American Express)

ECI_Security_Level_Indicator

This value is used to indicate the security level and cardholder authentication for MasterCard transactions. This value should be retained and returned unaltered in Terminal-Based settlement messages.

Len Type Description
3

Alpha

Contains the ECI values representing the security level and cardholder authentication of the transaction.

MasterCard

Position 1 = Security protocol

Position 2 = Cardholder authentication

Position 3 = UCAF Collection Indicator

ECS_Purchase_Amount

This value is used to submit the total amount of all Electronic Check Purchase transactions.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

ECS_Purchase_Count

This value is used to submit the total count of all Electronic Check Purchase transactions.

Len Type Description
8

Numeric

Total count for all Electronic Check Purchases.

EMV_Key_Date

This value is used to identify date of the last change to the EMV Key table at the host. If this date is greater than the date of the last key update in the POS application, then the POS needs to perform an EMV Key Exchange message to obtain the latest EMV Keys for the terminal.

Len Type Description
8

Numeric

The data of the last Host EMV Key Update in MMDDYYYY format.

Encryption_Key_Material

This field is used to submit additional key material used in the encryption of sensitive data for the transaction.

Len Type Description

512

Alpha

Encryption Key Material

Encryption_Type

This value is used to indicate the type of encryption that is used to secure the sensitive data.

Len Type Code Description
1

Alpha

V1

VeriFone Elm

E2

Elavon 3DES Encryption (non-FPE)

B1

Elavon 3DES Encryption (Brazil)

Enrollment

This value is used to identify the enrollment status for the current loyalty transaction.

Len Type Code Description
2

Numeric

00

Already Enrolled

01

Link Payment Card

02

Link Loyalty Card

03

Link Phone Number Only

Exponent

This value is the exponent part of the public key for an EMV Key exchange.

Len Type Description
6

Alpha

Public Key Exponent value

Extra_Charges

This field contains the charges that were incurred after the rental or check out has taken place. The values listed in the table below can appear in any order, not to exceed the maximum length and no duplicate entries on transaction.

Len Type Code Lodging Description Auto Rental Description
6

Numeric

1

Restaurant Charge

Gasoline

2

Gift Shop Charge

Extra Mileage

3

Mini-Bar Charge

Late Return

4

Telephone Charge

One Way Service Fee

5

Laundry Charge

Parking or Moving Violation

6

Other/Miscellaneous Charge

 

First_Name

This is used to indicate the applicant’s first name for the Bridgestone/Firestone instant credit application request.

Len Type Description

14

Alpha

Applicant’s First Name

Format_Code

This is a unique code that is used by the Merchant to denote the specific parsing rules for the merchant defined data that is contained in the Format Data field.

Len Type Code Description
3

Alpha

000

ECS Data – Format A

001

ECS Data – Format B

002

ECS Enhanced Transaction Data

003

POS Logistics – Equipment Data

004

POS Logistics – Statistics Data

Format_Data

This field is used to send in Merchant defined data for custom reporting. The Format Code field is used to denote different parsing structure for this field, if necessary.

Len Type Description

152

or 596

Alpha

Merchant defined data for custom reporting, or

The POS logistics messages can be up to 596 characters in length, however all other messages must conform to a maximum of 152 characters in length.

Free_Form_Data

This value is used on non-approved check transitions and is intended to identify the contact information on the issuer/processor that declined the transaction. This information must be printed on the receipt. Please refer to the Electronic Check primer for receipt requirements.

Len Type Description

76

Alpha

This data contains the contact information for the issuer/processor that provided the decline authorization response.

Each line of data in this string is delimited by the “/” character. The “\” character should be replaced with a space.

Gift-Loyalty_Transaction_Code

This character is used by the POS to uniquely identify the transaction to the gift card host. This value is required for both Gift Card and Loyalty reversal transactions.

Len Type Description

12

Alpha

A unique value assigned by the POS to identify the gift card transaction.

Hash_ID

This value identifies the hash algorithm used to produce the hash results in the digital signature scheme.

Len Type Code Description
2

Alpha

01

Hash algorithm (default)

Hash_Total

This value contains a batch-hashing total that is generated by the POS device. The total is created by adding together the transaction amount for all detail transactions. The Credit and Return transaction amounts are treated as positive and are added to the total not subtracted from it.

For Host-based Restaurant processing, the hash total is calculated by adding together all tips in the batch.

Len Type Description

16

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Healthcare_Amount

This value is used to submit the total amount of All qualified medical expenses (Over the counter, Dental, Prescription and Clinical/Other amount) contained within this Auto-Substantiation purchase. The “Transit Amount” or “Vision Amount” is not included in this calculation.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Refer to the chart below for use cases:

Auto Substantiation Fields Usage 1 Usage 2 Usage 3 Usage 4 Usage 5

Over The Counter Amount

+ $40.00 + $40.00 -- -- --

Prescription Amount (4U)

-- + $10.00 + $10.00 -- --

Clinic/Other Amount (4W)

-- + $10.00 + $10.00 -- --

Dental Amount (4X)

-- + $10.00 + $10.00 -- --

* Vision Amount (4V)

-- $10.00 $10.00 $10.00 --

* Transit Amount (4T)

-- -- -- -- $10.00

Healthcare Amount (4S)

= $40.00 = $70.00 = $30.00 $0.00 --

* Amounts (4V & 4T) are not included in the total Healthcare Amount field (4S)

  • Use 1 = $40 OTC Amount Only

  • Use 2 = $40 OTC Amount + $10 Prescription + $10 Clinic + $10 Dental = $70 Healthcare Amt, plus $10 Vision

  • Use 3 = $10 Prescription + $10 Clinic + $10 Dental = $30 Healthcare Amount, plus $10 Vision

  • Use 4 = $10 Vision Amount Only (not included in Healthcare Amount, must be sent as $0)

  • Use 5 = $10 Transit Amount Only (not included in Healthcare Amount)

House_Number

This is used to identify the street address of the applicant. Only the numeric values of the street address are used.

Len Type Description
9

Numeric

The applicant’s street address.  Numeric values only

ICC_AED

This value is used to identify the date after which the application expires.

Len Type Description
6

Numeric

The Application Expiration Date (YYMMDD) – EMV Tag 5F24 (Space Fill if not present from the chip)

ICC_AIP

This value is used to indicate the capabilities of the card to support specific functions within the application.

Len Type Description
4

Hex

The Application Interchange Profile – EMV Tag 82 (Space Fill if not present from the chip)

ICC_ARC

This value is generated by the authorization authority for an approved transaction.

Len Type Description
2

Alpha

The Authorization Response Code – EMV Tag 8A (Space Fill if not present from the chip)

ICC_ARPC

This value contains data sent to the chip card for online issuer authentication.

Len Type Description

32

Hex

The Issuer Authentication Data – EMV Tag 91

ICC_ATC

This is an incrementing counter value that is managed by the application in the chip card.

Len Type Description
4

Hex

The Application Transaction Counter (ATC) – EMV Tag 9F36 (Space Fill if not present from the chip)

ICC_Authorized_Amount

This value is used to indicate the authorized amount of the transaction (excluding adjustments).

Len Type Description

12

Numeric

The Authorized Amount– EMV Tag 9F02 (Space Fill if not present from the chip)

ICC_CID

This value indicates the type of cryptogram and the actions to be performed by the terminal.

Len Type Description
2

Hex

The Cryptogram Information Data – EMV Tag 9F27 (Space Fill if not present from the chip)

ICC_CNE

This value indicates the extended cardholder’s Name for the transaction pulled from EMV Tag 9F0B. This value is only used for VAN transactions in the Brazilian region.

Len Type Description

45

Alpha

The Cardholder Name Extended – EMV Tag 9F0B

ICC_Cryptogram

This cryptogram value is returned by the Chip (ICC) in response to a “Generate AC” command.

Len Type Description

16

Hex

The Application Cryptogram – EMV Tag 9F26 (Space Fill if not present from the chip)

ICC_CSN

This value is used to differentiate chip cards using the same Primary Account Number (PAN).

Len Type Description
2

Numeric

The Application PAN Sequence Number (CSN) – EMV Tag 5F34 (Space Fill if not present from the chip)

ICC_Customer_Exclusive_Data

This field is available for the Issuer’s discretionary use. The issuer is responsible for ensuring its use of the field complies with all applicable laws and its own privacy policy.

Len Type Description

64

Hex

The Customer Exclusive Data – EMV Tag 9F7C

ICC_CVMR

This value is used to indicate the results of the last CVM preformed.

Len Type Description
6

Hex

The Cardholder Verification Method Results (CVM) – EMV Tag 9F34 (Space Fill if not present from the chip)

ICC_Dedicated_File_Name

This value indicates the selected Application Identifier (AID) used in the transaction request.

Len Type Description

32

Hex

Dedicated File Name (Application Identifier) – EMV Tag 84

ICC_Form_Factor_Indicator

This field contains indicators about the attributes of the card holder’s device and the technology used for communication between the cardholder’s device and the acquiring POS Device.

Len Type Description
8

Hex

Form Factor Indicator – EMV Tag 9F6E (Space Fill if not present from the chip)

ICC_IAD

This value is used to send proprietary application data to the issuer in an online transaction.

Len Type Description

64

Hex

The Issuer Application Data – EMV Tag 9F10

ICC_ISR

This value is used to identify the results of the terminal script processing.

Len Type Description

84

Hex

The Issuer Script Results – EMV Tag 9F5B

ICC_Issuer_Script

This value is used to return the Issuer specified script contained in EMV Tags 71 or 72 back to the POS in the authorization response message.

Len Type Digits Description

256

Hex

1 - 2

This field is the EMV Issuer Script Identifier returned in the response message ‘71’ = EMV Tag 71

‘72’ = EMV Tag 72

3 - 4

This field identifies the ICC Issuer Script Command field length

5 - 256

This field contains the Issuer Script Command to be submitted to the Chip card

ICC_Other_Amount

This value is used to indicate a secondary “Cashback” amount associated with the transaction.

Len Type Description

12

Numeric

The Other Amount– EMV Tag 9F03 (Space Fill if not present from the chip)

ICC_TCC

This value is used to identify the country code where the terminal is located.

Len Type Description
3

Numeric

The Terminal Country Code – EMV Tag 9F1A (Space Fill if not present from the chip)

ICC_TCP

This value indicates the card data input, CVM, and security capabilities of the terminal.

Len Type Description
6

Hex

The Terminal Capabilities – EMV Tag 9F33 (Space Fill if not present from the chip)

ICC_Terminal_Type

This value is used to indicate the environment of the terminal, its communication capability, and its operational control.

Len Type Description
2

Numeric

The Terminal Type – EMV Tag 9F35 (Space Fill if not present from the chip)

ICC_Third_Party_Data

This field contains indicators about the attributes of the card holder’s device and the technology used for communication between the cardholder’s device and the acquiring POS Device.

Len Type Description

64

Hex

Third Party Data – EMV Tag 9F6E (Space Fill if not present from the chip)

ICC_Transaction_Currency

This value is used to indicate the currency code of the transaction according to the ISO 4217 standard.

Len Type Description
3

Numeric

The Transaction Currency Code – EMV Tag 5F2A (Space Fill if not present from the chip)

ICC_TT

This value indicates the type of financial transaction, represented by the first two digits of the ISO 8583 processing code.

Len Type Description
2

Numeric

The Transaction Type – EMV Tag 9C (Space Fill if not present from the chip)

ICC_TTD

This value is used to indicate the local data that the transaction was authorized.

Len Type Description
6

Numeric

The Transaction Date (YYMMDD) – EMV Tag 9A (Space Fill if not present from the chip)

ICC_TVR

This value indicates the status of the different functions as seen from the terminal.

Len Type Description

10

Hex

The Terminal Verification Results – EMV Tag 95 (Space Fill if not present from the chip)

ICC_Unpredictable_Number

This value is used to provide variability and uniqueness to the generation of a cryptogram.

Len Type Description
8

Hex

Unpredictable Number – EMV Tag 9F37 (Space Fill if not present from the chip)

Installment_Amount

This value is the amount of the installment payment including interest, if applicable.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Installment_Count

This value is used to indicate the total number of payments for an installment transaction. For example, if the consumer is making payment 1 of 12, then this value should be set to “12”.

Len Type Description
2

Numeric

The Total number of payment for the Installment transaction.

Installment_Date

This value is used to indicate the date of the first installment payment.

Len Type Description
6

Numeric

The date in DDMMYY format.

Installment_Number

This value is used to indicate the current payment number for an installment transaction. For example, if the consumer is making payment 1 of 12, then this value should be set to “1”.

Len Type Description
2

Numeric

The current payment number for the Installment transaction.

Insurance_Amount

This value is used to identify the insurance amount for the transaction, if applicable.

Len Type Description
7

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Interest_Rate

This value is used to identify the Interest rate used for the installment transaction.

Len Type Description
7

Numeric

Two implied decimals.

Invoice_Number

This value is used to include the POS’s local transaction invoice or order number. This is a required value for Mail Order and Ecommerce transactions.

Len Type Description

25

Alpha

The Invoice or Order Number for the transaction.

Issue_Points

This value is used to identify whether points need to be accrued for the currently loyalty transaction.

Len Type Code Description
1

Alpha

N

No

Y

Yes

Issuer_Response_Code

This value is the original Issuer response as returned during the authorization attempt.

Len Type Description
3

Alpha

The Issuer Response code

IVU_Loto_Prefix

The value is the unique IVU Loto processor identifier assigned for Elavon.

Len Type Description
2

Alpha

Unique IVU Loto processor identifier.

IVU_Loto_Number

The value is the IVU Loto number that has been assigned for this transaction.

Len Type Description

10

Alpha

IVU Loto Number.

Key_Pointer

This value is used to indicate which encryption methodology was used for US Debit transactions (POS to Elavon) and which key to use for the next transaction (Elavon to POS).

Len Type Code Description
1

Alpha

T

Triple-DES DUKPT

P

PINless Debit Purchase

KSN (Key Serial Number)

This is the value returned by the PIN Pad device, which was used to encrypt the cardholder’s Personal Identification Number (PIN) using the Derived Unique Key Per Transaction (DUKPT) method. It is a 10 byte composite field that is transmitted as 20 alphanumeric characters. The 10 bytes before they are expanded to the ASCII character representation are comprised as follows:

Len Type Description

20

Hex

Bytes 1-2  (suppress leading F’s)

Fixed Header

16 bits

Bytes 3-5

Key Set Identifier

24 bits

Bytes 6-7+ Bits 1-3 of Byte 8

Device ID

19 bits

Bits 4-8 of Byte 8and Bytes 9-10

Transaction Counter

21 bits

Lane_Number

This field is used to allow a multi-lane retailer using interleaved processing to send up a unique value that will identify the lane where the transaction originated from.

Len Type Description
8

Numeric

Merchant’s lane number identifier

Last_Name

This field is used to indicate the applicant’s last name for the Bridgestone/Firestone instant credit application request.

Len Type Description

20

Alpha

Applicant’s Last Name

Last_Record_Number

This value should contain the record number returned in the last response message to Elavon.

Len Type Description
4

Numeric

Last Record Number processed by Elavon 0001 – 9999.

In the Terminal-Based environment, the last record number should be 0000.

After a manual settlement has successfully completed this value should be reset to 0000.

Length_of_Rental

This value is used to identify the anticipated length of the auto rental or the number of days remaining in the stay for the folio (days remaining) for incremental transactions.

Len Type Description
2

Numeric

The anticipated number of days for the auto rental or the number of days remaining in the stay for the folio (days remaining) for incremental transactions

Length_of_Stay

This value is used to identify the anticipated length of the stay for a lodging customer.

Len Type Description
2

Numeric

The anticipated number of days for the room / folio or the number of days remaining in the stay for the folio (days remaining) for incremental transactions

Loyalty_Account_Data

This value is used to submit the gift card or loyalty card data.

Len Type Description

160

76

Alpha

Track 2 data or

Manually entered Card Data (Account Number=MMYY) or Encrypted account information

Loyalty_Add_Points_Amount

This value is used to identify the total amount of all Loyalty Add Point transactions in the batch.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Loyalty_Add_Points_Count

This value is used to identify the total number of all Loyalty Add Point transactions in the batch.

Len Type Description
8

Numeric

The total number of Loyalty Add Point transactions.

Loyalty_Program

This value is used to return the merchant’s loyalty program description to be printed on the consumer’s receipt.

Len Type Description

22

Alpha

Merchant’s loyalty program description.

Loyalty_Prompt

Used to identify if the application should prompt the cardholder to link their account data for the loyalty program.

Len Type Code Description
1

Alpha

N

No

Y

Yes

Loyalty_Redemption_Amount

This value is used to identify the total amount of all Loyalty Redemption transactions in the batch.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Loyalty_Redemption_Count

This value is used to identify the total number of all Loyalty Redemption transactions in the batch.

Len Type Description
8

Numeric

The total number of Loyalty Redemption transactions.

Loyalty_Return_Amount

This value is used to identify the total amount of all Loyalty Return transactions in the batch.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Loyalty_Return_Count

This value is used to identify the total number of all Loyalty Return transactions in the batch.

Len Type Description
8

Numeric

The total number of Loyalty Return transactions.

MAC_Key

This is the key that is used during the Message Authentication Code process (MAC’ing) in the terminal to generate the MAC Value for each debit request.

Len Type Description
16
32
Hex This is the key used to generate the MAC value for each transaction. This value will be either a 16 character or a 32 character length value.

MAC_Key_Pointer

This value is used to indicate which encryption methodology was used for the Canadian Debit MAC Value.

Len Type Code Description
1

Alpha

T

Triple-DES DUKPT

MAC_KSN (Key Serial Number)

This value is returned by the encrypting device and is used to generate the Message Authentication Code (MAC) using the Derived Unique Key Per Transaction (DUKPT) method. It is a 10 byte composite field that is transmitted as 20 alphanumeric characters. The 10 bytes before they are expanded to the ASCII character representation are comprised as follows:

Len Type Description

20

Hex

Bytes 1-2  (suppress leading F’s)

Fixed Header

16 bits

Bytes 3-5

Key Set Identifier

24 bits

Bytes 6-7+ Bits 1-3 of Byte 8

Device ID

19 bits

Bits 4-8 of Byte 8and Bytes 9-10

Transaction Counter

21 bits

MAC_Value

The Message Authentication Code (MAC) is used to verify that a Canadian Debit message transferred over a telecommunications network has not been altered.

The MAC Value is optional on a Canadian Debit Reversal and must space filled if not utilized.

Len Type Description

8

Hex

The MAC Value is optional on a Canadian Debit Reversal and must be space filled if not utilized.

Authentication elements, if available, are MAC’ed in order of appearance in the message. The data will be encrypted as multiple eight byte blocks, with padding of the final block (using binary zeros) if necessary.

Fields Len Description

Processing Code

6

The processing code from the transaction.

Transaction Amount

12

The transaction amount that is used to calculate the MAC value should be a right justified, zero filled twelve (12) character numeric value.

System Trace Audit Number

6

The System Trace Audit Number from the transaction, if available.

Card Account Number (PAN)

1-19

Card Account Number (Numeric Value Only)

Retrieval Reference Number

12

The Retrieval Reference Number, if available.

Debit Response Code

2

The Debit Response Code, if available.

The following editing rules will apply:

  1. A single space is inserted following each implicitly delimited field.

  2. Lower case characters are translated to upper case.

  3. Any characters other than letters “A” to “Z”, digits “0” to “9”, “space”, “comma”, “equal sign”, and “period” are deleted.

  4. The Card Account Number (PAN) field is a numeric only value.

  5. No spaces or dashes are allowed in the Card Account Number (PAN) field. Any characters other than digits “0” to “9” are deleted.

  6. All leading spaces are deleted.

  7. All trailing spaces are deleted.

The MAC value uses variable fields depending upon the message type being submitted. The following table describes the values that are used in the MAC calculation by message type.

Fields Purchase Return Void Reversal Response
Processing Code Yes Yes Yes Yes No
Transaction Amount Yes Yes Yes Yes Yes
System Trace Audit Number Yes Yes Yes Yes Yes
Card Account Number (PAN) Yes Yes Yes No No
Retrieval Reference Number No No Yes No Yes
Debit Response Code No No No No Yes

Member_Name

The Member name associated with the gift or loyalty card transaction, if available.

Len Type Description

50

Alpha

The Gift Card or Loyalty Card member name.

Merchant_Currency

This value is the Merchant’s currency code as represented by the three (3) digit alpha Currency value. This is used on DCC transactions only. See the Currency Code Table for a complete list of currencies.

Len Type Description
3

Alpha

The three (3) digit alpha currency code value

Merchant_ID

The Merchant ID as assigned by Elavon.

Len Type Description

16

Numeric

The Elavon Merchant ID.

Merchant_Reference_Nbr

This value contains the merchant assigned reference number for this transaction. If this value is not present, then Elavon will generate this number for backend use.

Len Type Description

11

Numeric

The merchant assigned reference number.

Mobile-Wallet_Type

This value is used to indicate type of mobile wallet used for the transaction .

Len Type Code Description
4

Alpha

0101

MasterCard PPOL (e-Comm)

0102

MasterCard PPOL (NFC)

VICO

Visa Checkout (e-Comm)

Monthly_Interest

This value contains the monthly interest amount for the installment payment.

Len Type Description
5

Numeric

Two Implied decimals.

mPOS_Acceptance_Device

This value is used to indicate the type of mobile device used for an mPOS transaction.

Len Type Code Description
2

Numeric

space

Not an mPOS device (default value)

0

Dedicated mPOS terminal with PCI-compliant dongle (with or without keypad)

1

Off-the-shelf mobile device (phone, tablet, etc)

MSDI

The Market Specific Data Indicator value.

Len Type Code Description
1

Alpha

0

Returned if the data was not presented in authorization

1

Returned if the data passed the Hotel Edits (H)

2

Returned if the data failed Edits (N)

3

Healthcare / Auto-Substantiation (M)

4

Transit / Auto-Substantiation (T)

5

Returned if the data passed the Visa Aggregator edits (E)

6

Returned if the data passed the Auto Rental edits (A)

7

Returned if the data passed the Bill Payment edits (B)

8

Returned if the data passed the MasterCard Payment Gateway edits (G)

9

Business to Business Invoice Payments (J)

A

Debit Purchase without PIN Block (S)

Multi-Clearing_Partial_Reversal_Amount

This value is used to indicate the amount to be submitted for a partial reversal on the final Multi-Clearing transaction, if necessary.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Multi-Clearing_Partial_Reversal_Flag

This value is used to indicate if a partial reversal is necessary for a Multi-Clearing transaction. This should only be used on the final transaction in the sequence and only if there is a remaining balance left from the original authorization amount.

Len Type Code Description
1

Alpha

N

Do not perform a partial reversal For this Multi-Clearing Transaction.

Y

Perform partial reversal for the Multi-Clearing Partial Reversal Amount

Multi-Clearing_Sequence_Count

This value is used to include the total number of records that the single authorization transaction will be broken up into for settlement transactions. If the actual number is not known, zero fill. The final transaction should contain the final number of settlement detail records submitted for this transaction.

Len Type Description
2

Numeric

The total number of clearing records, if known, else Zero Fill.

Multi-Clearing_Sequence_Nbr

This value is used to include the multi-clearing settlement sequence number for this transaction. Only use this value if you are settling multiple records from a single original authorization attempt.

Len Type Description
2

Numeric

The sequence number for the initial multi-clearing transaction starts as “01” and is incremented for each subsequent clearing item sent.

Municipal_Tax_Amount

This value is the municipal tax amount applied to this transaction.

Len Type Description

10

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Net_Amount

This value is used to identify the net dollar amount of all transactions in the batch.  Calculates as:

Net Amount = ((Credit Sales + Forces) – Credit Returns) + (Debit and EBT Purchases – Debit and EBT Returns) + (ECS Purchases)

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Negative amount are expressed with a minus sign (-$1 is sent as -100)

Net_Amount_Sign

This value is used to identify the net dollar amount of all transactions in the batch.

Len Type Code Description
1

Alpha

+

Positive Balance

Negative Balance

Net_Count

This value is used to identify the total number of transactions in the batch.

Net Count = (Credit Sales + Forces + Returns) + (Debit Purchases + Debit Returns) + (EBT Purchases + EBT Returns) + (ECS Purchases)

Len Type Description
8

Numeric

Total transaction count.

Net_Deposit

This value is used to identify the net deposit amount of all transactions in the batch.  Calculates as:

Net Amount = ((Credit Sales + Forces) – Credit Returns) + (Debit and EBT Purchases – Debit and EBT Returns) + (ECS Purchases)

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Negative amount are expressed with a minus sign (-$1 is sent as -100)

Net_TIP_Amount

This value is used to indicate the total amount of TIPs included in the batch. This field is used during settlement for the reconcilement of out of balance conditions between Elavon and the POS Shadow file. In retail this field will always be zero.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Network_Routing_Code

This one character field is used to facilitate network routing for this transaction.

Len Type Code Description
2

Numeric

00

Elavon’s Network (Default)

03

POS Logistics Message

Network_Status_Byte

This one character field is used to facilitate network handling of the call for this transaction.

Len Type Code Description
1

Alpha

*

Single Transaction Processing

#

Multi-Transaction Processing

Number_of_Incrementals

This is used to identify the number of incremental authorizations that have been submitted with this transaction.

Len Type Description
2

Numeric

00 – 90 (00 =default value)

OAR_Data

This “retain and return” field is used by Elavon to return data elements in the original authorization response message for use on subsequent transactions, such as Incrementals, Voids or Reversals.

Len Type Description

60

Alpha

Original Authorization Response (OAR) data

Original_Account_Entry_Mode

This value is used to identify the method used to enter the Account Data for the original transaction.

Len Type Code Description
2

Numeric

01

Key Entered – Card Not Present (01)

02

Key Entered – Card Present (71)

12

Key Entered – Credential on File

03

Swiped (90)

04

Proximity (91)

05

EMV (ICC) with CVV or iCVV (05)

06

EMV (ICC) proximity read (07)

07

EMV (ICC) with no CVV or iCVV (95)

08

EMV (ICC) – Mag stripe Read when the chip failed to read

09

EMV (ICC) – Digital Secure Remote Payment (09)

10

Scanned MICR (84)

11

Keyed MICR

Original_Auth_Amount

This is the original amount that was submitted for authorization of the transaction.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

PAN_Last_Four_Digits

This value is used to return the last four (4) digits of the actual card account number when a token was presented for authorization.

Len Type Description
4

Numeric

Last four (4) digits of the actual PAN

PAR_Value

The payment account reference (PAR) is a non-financial reference that is assigned to a cardholder’s account and links all activity related to that underlying payment account.

Len Type Description
35

Alpha

Payment Account Reference (PAR)

Parsed_Account_Nbr

This is the parsed checking account number as returned in the authorization response message.

Len Type Description

16

Numeric

The parsed checking account number.

Parsed_Check_Nbr

This is the parsed checking serial number as returned in the authorization response message.

Len Type Description
8

Numeric

The parsed check serial number.

Parsed_Transit_Routing_Nbr

This is the parsed checking Transit / Routing number as returned in the authorization response message.

Len Type Description
9

Numeric

The parsed checking transit / routing number.

Partial_Auth_Indicator

This value is used to indicate if the POS is capable of performing partial authorizations .

Len Type Code Description
1

Numeric

0

Indicates that the POS is not capable of Partial Authorizations

1

Indicates that the POS is capable of Partial Authorizations

2

Indicates that the POS is capable of Partial Authorizations and is a Visa Aggregator

PIN_Block

The encrypted Personal Identification Number entered by Debit / EBT Cardholder as identification for Transaction. The encrypted PIN Block is returned from the PIN Pad Device.

Len Type Description

16

Hex

Encrypted PIN Block

PIN_Entry_Capability

This value is used to indicate the capability of the terminal to capture a PIN.

Len Type Code Description
1

Numeric

0

Unknown (default value)

1

Can accept and pass an online PIN

2

Cannot accept and pass an online PIN

3

Can accept and pass an online PIN (mPOS - software-based)

8

PIN Pad is not functional

PIN_Working_Key ( Deprecated )

This value is the data-encrypting key for Canadian Debit transactions which is used to encrypt PINs for transmission from the terminal to the host computer.  This field is no longer used.

Len Type Description

16

32

Hex

PIN Working Key. This field is no longer used.

This value will be either a 16 character or a 32 character length value.

PKI (Public Key Index)

This value is used to identify the Public Key in conjunction with the RID.

Len Type Description
2

Hex

CA Public Key Index

Points

This value is used to indicate the number of points to remove from an account.

Len Type Description

12

Numeric

The amount of points to void from the account.

Points_Added

This value is used to indicate the number of points added to an account an account. 

Len Type Description

12

Numeric

The amount of points added to an account.

Points_Canceled

This value is used to indicate the number of points to cancel from an account.

Len Type Description

12

Numeric

The amount of points canceled from the account.

Points_Transfer_Amount(from)

This value is used to identify the total amount of all Loyalty Transfer (from) transactions in the batch.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Points_Transfer_Amount(to)

This value is used to identify the total amount of all Loyalty Transfer (to) transactions in the batch.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Points_Transfer_Count(from)

This value is used to identify the total number of all Loyalty Transfer (from) transactions in the batch

Len Type Description
8

Numeric

The total number of Loyalty Transfer (from) transactions.

Points_Transfer_Count(to)

This value is used to identify the total number of all Loyalty Transfer (to) transactions in the batch.

Len Type Description
8

Numeric

The total number of Loyalty Transfer (to) transactions.

POS_Entry_Capability

This value is used to identify the account entry capabilities on the POS device originating the transaction.

Len Type Code Description
2

Numeric

01

Manual Entry Only

01, 02, 12

02

Magnetically Swipe Capability

01, 02, 12, 03

03

Proximity Read Capability (w/Magstripe)

01, 02, 12, 03, 04, 06

13

Proximity Read Capability Only (wo/Magstripe)

04, 06

04

EMV Chip Capability (ICC) – Contact Only(w/Magstripe)

01, 02, 12, 03, 05, 07, 08

05

EMV Chip Capability (ICC) – Duel Interface(w/Magstripe)

01, 02, 12, 03, 04, 05, 06, 07, 08, 09

15

EMV Chip Capability (ICC) – Dual Interface(wo/Magstripe)

05, 06, 07, 08

10

MICR Read

10, 11

Postal_Zip_Code

This value is used to indicate the cardholder’s Postal or Zip Code.

Len Type Description
9

Alpha

The cardholder’s Postal or Zip Code (5 or 9 digit).

Pre-Auth_Reference_Number

This is a Gift Card value used to identify the original pre-authorization request. This value is required to submit the post- authorization completion transaction message.

Len Type Description

12

Numeric

Pre-authorization reference number.

Prescription_Amount

This value is used to submit the amount of all prescription expenses contained within this purchase.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Price

This value is the unit price for a specified SKU on a Loyalty card transaction.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Processing_Code

This value is submitted on all Canadian Debit transactions to indicate the transaction type. Refer to the table below for which processing codes are used by message type (Transaction Code).

Len Type Description Tran Code: 200 201 298 299
6

Numeric

000000 = Debit Purchase from the Default Account (Flash Only)

Yes

   

Yes

001000 = Debit Purchase from Savings

Yes

   

Yes

002000 = Debit Purchase from Checking

Yes

   

Yes

091000 = Debit Purchase with cashback from Savings

Yes

   

Yes

092000 = Debit Purchase with cashback from Checking

Yes

   

Yes

200000 = Debit Return from the Default Account (Flash Only)

 

Yes

 

Yes

200010 = Debit Return from Savings

 

Yes

 

Yes

200020 = Debit Return from Checking

 

Yes

 

Yes

220000 = Void of a Debit Purchase from the Default Account (Flash Only)

   

Yes

 

220010 = Void of a Debit Purchase from Savings

   

Yes

 

220020 = Void of a Debit Purchase from Checking

   

Yes

 

020000 = Void of a Debit Return from the Default Account (Flash Only)

   

Yes

 

021000 = Void of a Debit Return from Savings

   

Yes

 

022000 = Void of a Debit Return from Checking

   

Yes

 

Program_Indicator

This value is used to identify the Lodging and Auto Rental transaction type.

Len Type Code Lodging Auto Rental
1

Numeric

1

No Show

No Show

2

Purchase (Normal Stay)

Purchase (Normal Rental)

3

Card Deposit

 

4

Delayed Charge

 

5

Express Service

 

6

Assured Reservation

 

Program_Protocol

This value is used to indicate the type of 3D Secure protocol used.

Len Type Code Description
1

Alpha

space

Not a 3D Secure transaction (default value)

1

3D Secure version 1.0 (3DS 1.0)

2

3D Secure version 2.0 (3DS 2.0)

Promo_Code

This value is used to identify the promotional code for the offer/reward that is being offered to the consumer or redeemed by the consumer.

Len Type Description

10

Alpha

The promo code of the reward that is being offered or redeemed

Promo_Code_Description

This value is used to provide the description for the promotional code that is being offered to the consumer.

Len Type Description

44

Alpha

The description for the promotional code that is being offered to the consumer.

Promo_Code_Issue_Points

Identifies if a promotional issuance is necessary when the consumer elects to accept the specified promotional code.

Len Type Code Description
1

Alpha

Y

Issue points for this promotional code

N

Do not issue points for this promotional code

Promo_Code_Name

This value is used to provide the name or “headline” for the promotional code that is offered to the consumer.

Len Type Description

22

Alpha

The name or “headline” for the promotional code that is being offered to the consumer

PS2000_Data

This data will be as received during the original authorization processing. This is a “retain and return” value for terminal- based settlement messages.

Len Type Description

22

Alpha

The structure of the PS2000 data field is as follows:

Card Brand Pos. 1 Pos. 2 - 16 Pos. 17 - 20 Pos. 21 - 22

Visa

ACI

Transaction ID

Validation Code

ALP

MasterCard

“M”

Banknet Reference Nbr

Banknet Date

TIC

Discover

“D”

NRID

Transaction Data Condition Code  (LF – space filled)

Spaces

AMEX

“A”

Transaction ID

Spaces

Spaces

Union Pay

“U”

2-7 = STAN

8-16 = Pos. 1-9 of Date/Time

17 = Pos. 10 of Date/Time 18-20 = Julian Date

Spaces

Public_Key

This field is the value of the modulus part of the Certification Authority Public Key.

Len Type Description

496

Hex

Value of the Public Key

Quantity

This field contains the quantity of items in the SKU line item detail.

Len Type Description
6

Numeric

Numeric value in whole numbers.  Assumed to be 1 if left blank.

Receipt_Message

This field contains a custom message as retuned from the Gift Card host to be printed on the cardholder’s receipt.

Len Type Description

40

Alpha

Custom receipt message for Gift / Loyalty card transactions.

Record_Count

This field contains the batch record count generated by the POS Device. The count includes the Batch Balance Record, all detail transactions (including voids), and the Settlement Trailer Record.

Len Type Description
8

Numeric

The total number of records in the batch submission.

Record_Number

This value is used to identify the sequence number for the transaction.

For Host-Based authorization responses, this value is returned by Elavon. For Terminal-Based processing this value will always be zero (0).

For Settlement messages, this value identifies the record number for the transaction in the batch. 

Len Type Description
4

Numeric

The transaction sequence number.

Recurring_Payment_Type

This field is used to identify the type of recurring transaction that is being submitted for authorization.

Len Type Code Description USA PRI CAN BRA MEX
1

Numeric

1

Recurring Transaction

Yes

Yes

Yes

Yes

Yes

2

Installment Transaction

Yes

Yes

No

No

No

3

Acquirer Installment Transaction (without Interest)

No

No

No

Yes

No

4

Issuer Installment Transaction (with Interest)

No

No

No

Yes

Yes

5

Issuer Installment Transaction (without Interest)

No

No

No

No

Yes

6

Issuer Installment Transaction (without Promotion)

No

No

No

No

Yes

7

Buy Now, Pay Later (Deferred payment in full)

No

No

No

No

Yes

8

Carne Bill Payment (Brazil)

No

No

No

Yes

No

A Recurring Transaction is a transaction in which a cardholder allows a merchant to charge their card for recurring goods or services for a mutually agreed-upon payment amount (variable or set) and for a specified length of time. The merchant must obtain written permission to bill a cardholder on a recurring basis. Subsequent permission must be obtained when the agreement is renewed.

Recurring transactions have a defined billing cycle and are in effect as long as the contract between the merchant and the cardholder is in good standing. Recurring payments include charges for Utilities, membership fees, subscriptions, insurance premiums, tuition, etc.

An Installment Transaction is when a cardholder allows a merchant to charge their card for a single purchase of goods or services on a pre-determined payment schedule. The merchant must obtain permission to bill the cardholder in an arrangement in which a single purchase of goods/service is divided into two or more payments. Subsequent permission must be obtained when the agreement is modified.

Installment transactions have a defined transaction amount, billing cycle, and a total number of payments, which equal the full amount for the original agreed upon purchase. Installment payments include charges for loan payments, car purchase, furniture stores, etc.

A Carne Bill Payment Transaction is a Brazilian transaction in which a cardholder enters into an agreement and signs a contract with the Merchant to make regular monthly payments using a domestic Brazilian Debit Card for a current purchase. The cardholder then agrees to return to the store each month and present a domestic Brazilian Debit Card to make a payment according to the terms of the contract.

Redemption_Amount

This value is used to identify the total amount of all Gift Card Redemption transactions in the batch.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Redemption_Count

This value is used to identify the total number of all Gift Card Redemption transactions in the batch.

Len Type Description
8

Numeric

The total number of Gift Card Redemption transactions.

Reference_Number

This value is a reference number assigned by Elavon and returned in the authorization response message.

Len Type Description
8

Numeric

Reference Number

Register_Amount

This value is used on Brazilian Installment transactions.

Len Type Description
7

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Reload_Amount

This value is used to identify the total amount of all Gift Card Reload transactions in the batch.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Reload_Count

This value is used to identify the total number of all Gift Card Reload transactions in the batch.

Len Type Description
8

Numeric

The total number of Gift Card Reload transactions.

Rent-Mortgage_Amount

This field is used to indicate the applicant’s current monthly rent or mortgage amount expressed in a whole dollar amount. It the Resident Status is “Own” then this field should be sent as “0” (zero)

Len Type Description
5

Numeric

The applicant’s Monthly Rent / Mortgage Amount is submitted in whole dollars. ($1,000 is sent as 1000 )

Rental_Check_Out_Date

The date the customer first drove away with the rental vehicle in MMDDYYYY format.

Len Type Description
8

Numeric

Date in MMDDYYYY format

Renter_Name

The name of the customer rental the vehicle. (Used for MasterCard transactions)

Len Type Description

20

Alpha

Rental customer’s name.

Rental_Return_City

The name of the city where the vehicle was returned. (Used for MasterCard transactions) 

Len Type Description

18

Alpha

Rental return city name.

Rental_Return_Date

The date the customer returned the rental vehicle in MMDDYYYY format.  This value is the “Transaction Date”.

Len Type Description
8

Numeric

Date in MMDDYYYY format

Rental_Return_Location_ID

The location ID of where the vehicle was returned. (Used for MasterCard transactions)

Len Type Description

10

Alpha

Location ID of where the vehicle was returned.

Rental_Return_State-Country

The name of the State or Country where the vehicle was returned. (Used for MasterCard transactions)

Len Type Description
3

Alpha

Rental return State / Country name.

Resident_Status

This field is used to indicate the applicant’s current resident Status.

Len Type Code Description
1

Numeric

0

Own

1

Rent/Other

Response_Code (Authorization)

This value is a 2 character code indicating the authorization response status. An approval is always indicated with an ‘AA’, ‘AP’ or ‘AC’ code, all other codes indicate a non-approval.

Len Type Code Description
2

Alpha

AA

Approved Transaction (Authorizations and Reversals)

AP

Approved Transaction for a Partial Amount

AC

Approved Transaction (without Cashback)

NC

Decline (Pick Up Card)

ND

Decline (Hard or Soft)

NF

Decline (Record Not Found)

NR

Decline (Referral Message)

N7

Decline (For CVV2 Only)

NL

Decline (Loyalty/Gift Error)

00-99

Decline (Additional Gift Card Declined)

Response_Message

This field contains a response code indicating the status of the batch settlement. This response message is used by the POS Device to aid in diagnosing the batch capture status and/or problems and must be displayed and/or printed. The amount fields are positive if unsigned and negative if preceded by a “-“ sign.

Len Type Description

16

Alpha

The first two characters of the response message are used to indicate a successful or failed settlement attempt.

GB = Good Batch

RB = Rejected Batch

GBOK  BBBMMDDHHMM

GBOK = Good batch, settlement received OK
BBB = Batch Number 001 through 999
MMDD = Month and day of Settlement
HHMM = Time of Settlement

RBOUT OF BALANCE

Item and Dollar totals do not match the settlement trailer record totals.

RB INV ACCT 9999

Record number 9999 is invalid.

RB INV CARD 9999

Card type not allowed for settlement for the Merchant ID for record 9999.

RB INV DATA 9999

Data Invalid for record 9999, please retry.

RB INVLD AMT9999

Invalid transaction amount for record 9999.

RB PLEASE RETRY

System failure, please re-attempt.

RB UNREC CAR9999

Card type not recognized for record 9999.

RB UPLOAD TIPS

An out of balance condition was detected that uploading of tip data will correct.

INVALID TERM ID

Terminal ID not on file at Elavon.

INVALID MER ID

Merchant number not found on the Elavon system.

NO PRIOR BATCH

No prior batch exists for inquiry.

NO TRANSACTIONS

There are no transactions in the requested batch

BATCH 999 PURGED

Batch number specified was deleted per end user request.

BATCH NOT PURGED

Request was denied - Invalid Merchant ID.

SERV NOT ALLOWED

Merchant not set up for settlement processing on Elavon.

Response_Source_Indicator

This code indicates if the check was authorized by a participating member bank or a third party check processor.

Len Type Code Description
1

Alpha

5

Member Bank

A

Third Party Check Processor

Results

This field may contain an error response message for a settlement detail packet that is sent to the host. This field is blank when the Settlement detail transaction does not have an error in processing. 

Len Type Description

16

Alpha

This field may contain an error response message for a settlement detail packet that is sent to the host.

Retrieval_Reference_Number

The retrieval reference number returned from the Canadian Debit gateway during an authorization attempt. This value is also used in a Canadian Debit Void transaction.

Len Type Description

12

Alpha

Retrieval Reference Number

Return_Message

This is the response message that is returned on a CFNA Bridgestone/ Firestone credit application request.

Len Type Response Message Code Description

16

Alpha

ACCOUNT APPROVED

AA

Account number and credit limit are returned

EXISTING ACCOUNT

AA

Applicant has an existing BSFS account, the existing account number is returned in the account number field

CANNOT APPROVE

ND

CFNA cannot approve application.

WILL INVESTIGATE

NR

CFNA will review and approve/deny, then call location

ERR.CFNA WILL CL

NR

CFNA system error when processing the application

CL 800-527-6770

NR

Call CFNA for further information.

RID

This value is used to identify the specific application system in on the POS Device.

Len Type Description

10

Alpha

Registered Application Provider Identifier

Risk_Data

This value is returned by the risk provider and is used to assess the potential risk on a transaction. This can be used to assist in the decision to continue with the transaction.

Len Type Description
5

Alpha

This field is used to identify the potential risk on the transaction as supplied by the risk provider.

The format may vary by provider.

Provider Field Name Len Type Description

VI (Visa)

Risk Assessment Data

2

Numeric

A value from 00 to 99. This value indicates the degree of risk associated with the transaction. A higher number indicates higher risk.

VI (Visa)

Risk Condition Code

2

Numeric

This optional field indicates the potential for fraud to occur on the card account over the next 30 days. A higher number indicates higher risk.

MC (MasterCard)

Merchant Fraud Score

3

Alpha

A value from 001 to 998. Where 001 indicates the least likely fraudulent transaction and 998 indicates the most likely fraudulent transaction.

MC (MasterCard)

Merchant Score

2

Alpha

This field indicates the key factors that influenced Reason Code fraud score.

Risk_Data_Provider

Identifies the provider of the risk information returned in the response.  The risk data will be sent in the Risk Data Field.

Len Type Code Description
2

Alpha

VI

Visa

MC

MasterCard

ROC_Text_Data

This field is used to submit additional data on the transaction.

Len Type Description

39

Alpha

Unique merchant assigned data for this transaction .

Room_Number

This value is the Folio or Room number as entered by the property. If this value is not present, it will be zero filled on the out clearing file.

Len Type Description

10

Numeric

Folio or Room Number

Sales_Tax

This is the actual sales tax amount applied to this transaction. Consumer or merchant initiated tax exempt transactions should be submitted by entering a single zero in this field.

Len Type Description

10

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Security_Code

This is the verification value assigned to the cardholders gift card/loyalty account. If a Security Code (PIN) value has been assigned to the account, it is required to be included in the authorization request to the gift card/loyalty provider. 

Len Type Description
6

Numeric

Gift Card/Loyalty Security Code (PIN) value

Service_Code

This value is the service code as read from the track data of the card.

Len Type Description
3

Numeric

The service code of the card. (Space Fill, if not present)

Service_Fee

This value is used to identify the applicable NSF fees for the Merchant’s state on approved check transactions and must be printed on the check presenter’s receipt.  Please refer to the Electronic Check primer for receipt requirements.

Len Type Description

21

Alpha

Example: “GA = $20 or 5%”

Shipping_Date

The value is the date that the consumer’s goods were shipped. This value is the “Transaction Date” for direct marketing and ecommerce transactions.

Len Type Description
8

Numeric

Shipping Date in MMDDYYYY format.

SKU_Number

The value is used on a Loyalty transaction to identify the specific items being purchased.

Len Type Description

30

Alpha

The SKU number for the selected item.

Spend_Qualifier

This value is used to return the Spend qualifier indicator used to indicate if spend thresholds have been met for Ultra High Net Worth cardholders .

Len Type Code Description
1

Alpha

Space

Not Applicable (default value)

B

Base spend qualification threshold met

N

Spend qualification threshold not met

Q

Spend qualification threshold met

Status

This value is used to identify the status of the current settlement transaction. If the transaction passes all criteria it will be accepted.  If not, the reason for the error will be returned in the Transaction Results field.

Len Type Code Description
1

Alpha

A

Transaction Accepted

E

Error Detected

State_Tax_Amount

This value is the state tax amount applied to this transaction.

Len Type Description

10

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Street_Address

This value is used to identify the cardholder’s street address.

Len Type Description

20

Alpha

The cardholder’s street address.  Example: “1234 Main Street”

Stored_Credential_Indicator

Used to identify when a cardholder’s credentials are being stored for the first time. It is also used to identify when a merchant is submitting an “unscheduled” recurring transaction using a consumer’s previously stored “credential on file”.

Len Type Code Description
1

Alpha

C

This value is used to identify when a consumer’s account credentials are being stored by the merchant for the first time.

This value is also used to identify when a merchant is submitting an “unscheduled” recurring transaction using a consumer’s previously stored “credential on file”.

N

Credentials are not being stored or recalled from file (default value)

Surcharge_Amount

This field is used to indicate the amount of the surcharge applied to the transaction. This amount should be included in the Transaction Amount field.

Len Type Description
4

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

System_Trace_Audit_Nbr

This field is used by the POS in the Canadian Debit authorization request message to uniquely identify the transaction to the host.  This value is used in the MAC Calculation.

Len Type Description
6

Numeric

Transaction trace number.

For Canadian Debit Reversal transactions this value contains the original System Trace Audit Number from the transaction that is being reversed.

Tax_Amount

This value is the tax amount of the Installment transaction.

Len Type Description
7

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Tender_Amount

This value is used identify the transaction amount less the discount for the current offer, if available.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Tender_Type

The value is used to identify the payment method use to activate or reload a gift card.

Len Type Code Description
1

Numeric

0

Cash

1

Credit Card

2

Debit Card

3

Check

9

Not Used or Unknown

Terminal_ID

The terminal identification number is used to uniquely identify the Merchant and their financial institution to Elavon. The Terminal ID consists of two parts and is assigned by Elavon for each POS device.

Len Type Digits Description

22

Numeric

Digits 1-6

Bank Number – This six digit fixed length value is assigned by Elavon.

Digits 7-22

Terminal Number or ID – This sixteen digit fixed length value is assigned by Elavon.

Terminal_Type

This value is used to indicate the type of POS device used at the point of authorization.

Len Type Code Description
2

Numeric

00

Attended Terminal (default value)

01

Limited Amount Terminal (CAT)

02

Unattended Terminal (ATM)

03

Unattended Terminal (CAT)

04

No Terminal Used

05

Mobile POS

09

Unknown

Time_Stamp

This value is used to indicate the date and time until which the Foreign Exchange Rates are valid. 

Len Type Description

12

Numeric

Date and time stamp in YYYYMMDDHHMM format.

TIP_Amount

This field contains the amount of TIP to apply to the transaction.

Len Type Description
6

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Token_Account_Status

This value is used to identify the value as a regulated or non-regulated token.

Len Type Code Description
1

Alpha

Space

Not Applicable (default value)

R

Regulated

N

Non-Regulated

Token_Assurance_Level

This value is used to return a value that indicates the confidence level of the token to PAN mapping.

Len Type Description
2

Alpha

This field will contain a value that indicates the confidence level of the token to PAN mapping (Space Fill, if not present)

Token_Indicator

This field is used to identify if the data in the Account Data field contains an Elavon defined token replacement value instead of the original account data.

Len Type Code Description
1

Numeric

0

No Elavon Token used (default value)

1

The data in the Account Data field is an Elavon defined Token value

Token_Requestor_ID

This value is used to return the token requestor ID.

Len Type Description

11

Alpha

This field will contain the token requestor ID

Token_Value

This field is returned in the authorization response message when the terminal ID is set up for the tokenization service.

This value is a token replacement for the original account data used in the original request and can be used in the account data field for subsequent follow on transactions. 

Len Type Description

19

Numeric

The token replacement value for the Account Data field used in the original request message.

Total_Auth_Amount

The total amount for authorizations for this transaction, including all incremental authorizations. This value should be in Cardholder Currency for DCC transactions else in Merchant Currency.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Total_Effective_Cost

This value is the total annual rate (CET) for the Installment transaction.

Len Type Description
7

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Total_Installment_Amount

This value is the total amount of the Installment transaction payments including interest, if applicable.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Total_Installments

This value is the total number of Installment payments for the transaction.

Len Type Description
2

Numeric

Total Number of Installments.

Trace_Number

This value is used as a message reference number identify the transaction request and is returned in all authorization response messages.  It is sent to the host on reversal and void messages when applicable.

Len Type Description
6

Numeric

Message reference number.

Transaction_Amount

This is the actual amount of the transaction. The maximum transaction amounts supported are currently $9,999,999.99 for Visa and MasterCard, and $99,999.99 all others card associations. 

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

For Terminal-Based Settlement messages, this value will contain the total amount of the transaction in the Merchant’s currency, including any Tips (for restaurant transactions).

For Canadian Debit Authorization Response messages, this field is zero filled and right justified to 12 characters.

Transaction_Code

This value is used to uniquely identify the type of transaction that is being submitted to Elavon. 

Len Type Code Description Request ID
3

Alpha

000

Credit Card Sale

Credit Card.Sale

001

Credit Card Authorization Only

Credit Card.Auth Only

002

Credit Card Account Verification Only

Credit Card.Account Verification Only

004

Credit Card Pre-Paid Balance Inquiry

Credit Card.Pre-Paid Balance Inquiry

005

Credit Card Return

Credit Card.Return

006

Credit Card Force

Credit Card.Force

008

Credit Card Visa Account Funding

Credit Card.Visa Account Funding

009

Credit Card MasterCard Payment Transaction

Credit Card.MasterCard Payment

010

Credit Card Lodging Check In

Credit Card.Lodging Check In

011

Credit Card Incremental

Credit Card.Incremental

012

Auto Rental

Credit Card.Auto Rental

098

Credit Card Void

Credit Card.Void

099

Credit Card Reversal

Credit Card.Reversal

100

Debit Card Purchase

Debit.Purchase

   

101

Debit Card PIN Less Purchase

Debit.PINless Purchase

102

Debit Card Return

Debit.Return

103

Debit Card Balance Inquiry

Debit.Balance Inquiry

120

EBT Food Stamp Purchase

EBT.Food Stamp Purchase

121

EBT Food Stamp Voucher Clear Purchase

EBT.Food Stamp Voucher Clear Purchase

122

EBT Food Stamp Return

EBT.Food Stamp Return

123

EBT Food Stamp Voucher Clear Return

EBT.Food Stamp Voucher Clear Return

124

EBT Food Stamp Balance Inquiry

EBT.Food Stamp Balance Inquiry

140

EBT Cash Benefit Purchase

EBT.Cash Benefit Purchase

141

EBT Cash Benefit Balance Inquiry

EBT.Cash Benefit Balance Inquiry

197

Debit / EBT Echo

Debit.Echo or EBT.Echo

198

Debit / EBT Void

Debit.Void or EBT.Void

199

Debit / EBT Reversal

Debit.Reversal or EBT.Reversal

200

Debit Card Purchase (Canadian)

Canadian Debit.Purchase

201

Debit Card Return (Canadian)

Canadian Debit.Return

298

Debit Void (Canadian)

Canadian Debit.Void

299

Debit Reversal (Canadian)

Canadian Debit.Reversal

300

ECS Purchase w/Conversion

ECS.Purchase with Conversion

301

ECS Purchase w/Verification

ECS.Purchase with Verification

302

ECS Purchase w/Guarantee

ECS.Purchase with Guarantee

397

ECS Echo

ECS.Echo

398

ECS Void

ECS.Void

399

ECS Reversal

ECS.Reversal

400

Gift Card Activation

Gift Card.Activation

401

Gift Card Sale / Redemption

Gift Card.Redemption

402

Gift Card Credit / Return

Gift Card.Credit

403

Gift Card Replenishment / Reload

Gift Card.Reload

404

Gift Card Balance Inquiry

Gift Card.Balance Inquiry

405

Gift Card “Card Refund”

Gift Card.Refund

407

Pre-Authorization

Gift Card.Pre-Auth

408

Post Authorization

Gift Card.Post-Auth

420

Add Loyalty Points

Gift Card.Add Loyalty Points

421

Redeem Loyalty Points

Gift Card.Redeem Loyalty Points

422

Loyalty Enrollment

Gift Card.Loyalty Enrollment

423

Loyalty Balance Inquiry

Gift Card.Loyalty Balance Inquiry

424

Loyalty Return

Gift Card.Loyalty Return

425

Loyalty Lead Inquiry

Gift Card.Loyalty Lead Inquiry

426

Loyalty Member Inquiry

Gift Card.Loyalty Member Inquiry

493

Loyalty Current Batch Inquiry

Gift Card.Loyalty Current Batch Balance

494

Loyalty Last Settled Batch Inquiry

Gift Card.Loyalty Previous Batch Balance

495

Gift Card Batch Close Out

Gift Card.Batch Close Out

496

Gift Card Current Batch Inquiry

Gift Card.Current Batch Balance

497

Gift Card Last Settled Batch Inquiry

Gift Card.Previous Batch Balance

498

Gift Card / Loyalty Void

Gift Card.Void

499

Gift Card / Loyalty Reversal

Gift Card.Reversal

800

DCC Rate Request

Misc.DCC Rate Update

801

BSFS Credit Application

Misc.Bridgestone Instant Credit

803

Key Exchange (EMV)

Misc.EMV Key Exchange

804

Cash or Cash-equivalent Purchase Transaction

Misc.IVU Loto Cash Purchase

805

Cash or Cash-equivalent Refund Transaction

Misc.IVU Loto Cash Refund

   

806

Cash or Cash-equivalent Void Transaction

Misc.IVU Loto Cash Void

807

Cash or Cash-equivalent Reversal Transaction

Misc.IVU Loto Cash Reversal

808

POS Logistics Message

Misc.POS Logistics

810

Get Token Request

Misc.Get Token

811

Transaction Eligibility

Misc.Transaction Eligibility

900

Balance Header (HB only)

Batch.Balance

910

Tip Header (HB Restaurant Header)

Batch.TIP Header

911

Tip Detail (HB Restaurant Tips)

Batch.TIP Detail

919

Tip Trailer Record (HB Restaurant Footer)

Batch.TIP Trailer

920

Detail Header (TB Settlement Header)

Batch.Detail Header

921

Detail Record (TB Detail)

Batch.Detail

929

Detail Trailer Record (TB Settlement Footer)

Batch.Detail Trailer

997

Last Settled Inquiry

Batch.Previous Balance

998

Current Batch Inquiry (Host-Based only)

Batch.Current Balance

999

Delete/Purge Batch (Host-Based only)

Batch.Purge

Transaction_ID

This is the transaction ID as returned in the authorization response message. 

Len Type Description

15

Numeric

The transaction ID value returned in the Electronic Check authorization response message.

Transaction_Reference_Nbr

The Transaction Reference Number is returned in the authorization response message and is used on void and reversal transactions, when available.

Len Type Description

10

Numeric

Transaction Reference number assigned by Elavon.

Transit_Amount

This value is used to submit the amount of all transportation related expenses contained within this purchase. This amount is not included in the “Healthcare Amount” calculation for Auto-Substantiation transactions. 

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Transmission_Date

This value is used to identify the date for the settlement attempt.

Len Type Description
4

Numeric

The Date in MMDD format.

UCAF_Indicator

This value identifies the means in which the transaction was processed between the cardholder and the merchant for a SecureCode authentication transaction.

Len Type Code Description
1

Numeric

0

UCAF data collection is not supported by the Merchant

1

UCAF data is supported by merchant and UCAF data must be present (attempt AVV)

2

UCAF data is supported by merchant, and UCAF data must be present (fully authenticated AVV)

3

MARP Static Authentication

5

Issuer Risk Based Decisioning

   

6

Merchant Risk Based Decisioning

Units

This value is used to identify the number of units associated with the Loyalty card transaction.

Len Type Description
6

Numeric

The number of units for the transaction represented in whole numbers.

VAN_Partner_Data

This value is used to send specific VAN Partner data to the POS application for printing on the receipt.

Len Type Description

39

Alpha

Unique VAN Partner Data for receipt printing

Vision_Amount

This value is used to submit the amount of all optical/vision expenses contained within this purchase. This amount is not included in the “Healthcare Amount” calculation for Auto-Substantiation transactions.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Void_Amount

This value is used to submit the total amount of all voided transactions in the batch.

Len Type Description

12

Numeric

The decimal is implied.  ($1 is sent as 100 and 1¢ is sent as 1)

Void_Count

This value is used to submit the total count of all voided transactions in the batch.

Len Type Description
8

Numeric

Total count for all voided transactions in the batch.

Void_Record_Number

This value should contain the record number of the transaction to void in the open batch.

Len Type Description
4

Numeric

Numeric value between 0001 and 9999

Voucher_Clear_Nbr

The Voucher Number from an EBT sales slip, used for Voucher Clear Food Stamp transactions.

Len Type Description

15

Numeric

The 15 digit Voucher Clear Number from the Merchant’s EBT Food Stamp sales slip.

Voucher_Indicator

This field is used to identify if the transaction is a Brazilian Voucher transaction.

Len Type Code Description
1

Numeric

0

Not a Voucher transaction (default value)

1

This transaction is a Voucher transaction

ZIP_Code

This field is used on Bridgestone/Firestone Instant Credit message to identity the ZIP code of the applicant.

Len Type Description
5

Numeric

The applicant’s ZIP Code.