Field Definitions

Field NameLength
Type
Description
HD.Network_Routing_Code2
numeric
Facilitates network routing for this transaction.
Valid values:
  • 00 - Elavon’s Network (Default)
  • 03 - POS Logistics Message
HD.Network_Status_Byte1
alpha
Facilitates network handling of the call for this transaction.
Valid codes:
  • * - Single Transaction Processing
  • # - Multi-Transaction Processing
HD.Application_ID8
alpha
Indicates the type of POS device that is originating the transaction. These values are case sensitive and must be capitalized. Each digit is described with corresponding valid values in the Application-ID table below. Example: HZ0000GC
HD.Terminal_ID22
numeric
Uniquely identifies the Merchant and their financial institution to Elavon. The Terminal ID consists of two parts and is assigned by Elavon for each POS device.
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.
HD.Device_Tag
RD.Device_Tag
6
alpha
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).
Valid Characters (a-z and 0-9) (restricted characters do not allow = or ^).
01.POS_Entry_Capability
92.POS_Entry_Capability
2
numeric
Identifies the account entry capabilities on the POS device originating the transaction. See POS_Entry_Capability table for valid codes.
01.Account_Entry_Mode
60.Account_Entry_Mode
92.Account_Entry_Mode
2
numeric
Identifies the method used to enter the Account Data for the transaction. See Account_Entry_Mode table for valid codes.
01.Partial_Auth_Indicator1
numeric
Indicates if the POS is capable of performing partial authorizations.
Valid values:
  • 0 - POS is not capable of Partial Authorizations
  • 1 - POS is capable of Partial Authorizations
  • 2 - POS is capable of Partial Authorizations and is a Visa Aggregator
01.Account_Data
8D.Account_Data
92.Accunt_Data
alphaSubmits the cardholder account data to Elavon for processing. See the Account_Data table for valid formats.
01.Transaction_Amount
05.Transaction_Amount
52.Transaction_Amount
84.Transaction_Amount
92.Transaction_Amount
12
numeric
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 other card associations. 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.
01.Last_Record_Number
77.Last_Record_Number
4
numeric
This value should contain the record number returned in the last response message to Elavon. 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.
01.Void_Record_Number4
numeric
This value should contain the record number of the transaction to void in the open batch. Numeric value between 0001 and 9999.
01.PIN_Entry_Capability
92.PIN_Entry_Capability
1
numeric
This value is used to indicate the capability of the terminal to capture a PIN.
Valid values:
  • 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.
01.Terminal_Type
92.Terminal_Type
2
numeric
This value is used to indicate the type of POS device used at the point of authorization.
Valid values:
  • 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
01.CAT_Indicator
92.CAT_Indicator
2
numeric
Indicates the type of Cardholder Activated Terminal Indicator for this transaction.
Valid values:
  • 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
01.Token_Indicator
60.Token_Indicator
92.Token_Indicator
1
numeric
Identifies if the data in the Account Data field contains an Elavon-defined token replacement value instead of the original account data.
Valid values:
  • 0 - No Elavon Token used (default value)
  • 1 - The data in the Account Data field is an Elavon defined Token value.
01.Association_Token_Indicator1
numeric
Identifies if the data in the Account Data field contains an Association-defined token replacement value instead of the original account data.
Valid values:
  • 0 - No Association Token used (default value)
  • 1 - The data in the Account Data field is an Association-defined Token Value.
01.Voucher_Indicator
92.Voucher_Indicator
1
numeric
Identifies if the transaction is a Brazilian Voucher transaction.
Valid values:
  • 0 - Not a Voucher transaction (default value).
  • 1 - This transaction is a Voucher transaction.
01.Stored_Credential_Indicator
92.Stored_Credential_Indicator
1
alpha
Identifies 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”.
Valid values:
  • C - This value is used to identify when a consumer’s account credentials are being stored by the merchant for the first time. Also identifies 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).
01.mPOS_Acceptance_Device
92.mPOS_Acceptance_Device
2
numeric
Indicates the type of mobile device used for an mPOS transaction.
Valid values:
  • 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).
01.PAR_Value
02.PAR_Value
92.PAR_Value
35
alpha
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.
02.Response_Code
04.Response_Code
73.Response_Code
81.Response_Code
2
alpha
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.
Valid values:
  • 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)
02.Issuer_Response_Code
19.Issuer_Response_Code
3
alpha
This value is the original Issuer response as returned during the authorization attempt.
02.Authorization_Source
92.Authorization_Source
1
alpha
Indicates 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.
Valid values:
  • 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.
02.Capture_Code1
numeric
Indicates to the POS which transactions should be captured in the local Shadow file.
Valid values:
  • 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.
02.Approval_Code
19.Approval_Code
54.Approval_Code
55.Approval_Code
59.Approval_Code
65.Approval_Code
92.Approval_Code
6
alpha
This field contains the approval code for the transaction. Note: If the Response Code on the authorization is not equal to “AA”, “AP” or “AC” the contents of this field are ignored.
02.Authorization_Date
52.Authorization_Date
54.Authorization_Date
73.Authorization_Date
92.Authorization_Date
6
numeric
The date which the transaction was authorized. For offline transactions, this value should be set to the date when the transaction occurs. Format is MMDDYY.
02.Authorization_Time
52.Authorization_Time
54.Authorization_Time
73.Authorization_Time
92.Authorization_Time
6
numeric
The time which the transaction was authorized. For offline transactions, this value should be set to the time when the transaction occurs. Format: HHMMSS.
02.Batch_Number
88.Batch_Number
89.Batch_Number
8A.Batch_Number
90.Batch_Number
3
numeric
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).
02.Record_Number
78.Record_Number
91.Record_Number
92.Record_Number
9F.Record_Number
4
numeric
Identifies 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.
02.Authorization_Response16
alpha
This field contains the 16 character response display message. Used by the POS device to display the authorization results. See Authorization_Response table for codes and definitions.
02.Trace_Number
19.Trace_Number
59.Trace_Number
6
numeric
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.
02.Transaction_Reference_Nbr
19.Transaction_Reference_Nbr
59.Transaction_Reference_Nbr
96.Transaction_Reference_Nbr
10
numeric
Returned in the authorization response message and is used on void and reversal transactions, when available.
02.OAR_Data
04.OAR_Data
60
alpha
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.
02.Spend_Qualifier
92.Spend_Qualifier
1
alpha
Returns the Spend qualifier indicator used to indicate if spend thresholds have been met for Ultra High net worth cardholders.
Valid values:
  • Space - Not Applicable (default value)
  • B - Base spend qualification threshold met
  • N - Spend qualification threshold not met
  • Q - Spend qualification threshold met
02.Association_Name38
alpha
Returned in the authorization response messages and is used to indicate the association name for the transaction, for example: Visa, Visa Debit, Visa Electron, MasterCard, MasterCard Debit, EBT, etc.
03.Merchant_Reference_Nbr11
numeric
Contains the merchant assigned reference number for this transaction. If this value is not present, then Elavon will generate this number for backend use.
03.Dynamic_Auth_Type_Indicator1
alpha
Allows the Payment Facilitator to dynamically send the authorization type for the sub-merchant that is submitting the transaction.
Valid values:
  • F - Final Amount (amount is not expected to change for settlement)
  • P - Pre-Authorization / Estimated Amount (amount may change between auth and settlement).
03.Dynamic_City13
alpha
Allows 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.
03.Dynamic_Country_Code3
alpha
Allows 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.
03.Dynamic_DBA_Name25
alpha
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.
03.Dynamic_Email_Address70
alpha
Allows 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.
03.Dynamic_MCC4
numeric
Allows 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.
03.Dynamic_Phone_Number20
numeric
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.
03.Dynamic_Postal_Code9
alpha
Allows 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.
03.Dynamic_State2
alpha
Allows 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.
03.Dynamic_Street_Address30
alpha
Allows 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.
03.Dynamic_Sub-Merchant_ID15
numeric
Allows 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.
03.Dynamic_Tax_ID14
alpha
Allows 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.
04.Transaction_Code3
alpha
Used to uniquely identify the type of transaction that is being submitted to Elavon. See the list of codes and descriptions
04.Original_Auth_Amount
92.Original_Auth_Amount
12
numeric
This is the original amount that was submitted for authorization of the transaction. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
04.Cumulative_Auth_Amount
05.State_Tax_Amount10
numeric
The state tax amount applied to this transaction. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
05.Municipal_Tax_Amount10
numeric
The municipal tax amount applied to this transaction. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
06.Lane_Number8
numeric
Allows a multi-lane retailer using interleaved processing to send up a unique value that will identify the lane where the transaction originated from.
07.Format_Code3
alpha
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.
Valid values:
  • 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.
07.Format_Data152 or 596
alpha
Sends Merchant-defined data for custom reporting. The Format Code field is used to denote different parsing structure for this field, if necessary. 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.
08.Mobile-Wallet_Type4
alpha
Indicates the type of mobile wallet used for the transaction.
Valid values:
  • 0101 - MasterCard PPOL (e-Comm)
  • 0102 - MasterCard PPOL (NFC)
  • VICO - Visa Checkout (e-Comm)
10.Postal_Zip_Code9
alpha
Indicates the cardholder’s Postal or Zip Code. 5 or 9 digits.
10.Street_Address20
alpha
The cardholder’s street address. Example: “1234 Main Street”
10.CVV2_Indicator1
numeric
Indicates 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.
Valid values:
  • 0 - Bypassed
  • 1 - Present
  • 2 - Illegible
  • 9 - Not Present
10.CVV2_Value4
alpha
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. (Left Justified, Trailing Spaces)
11.Sales_Tax10
numeric
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. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
11.Customer_Code17
alpha
Identifies the customer number for purchasing card transactions.
12.Invoice_Number25
alpha
Includes the POS’s local transaction invoice or order number. This is a required value for Mail Order and Ecommerce transactions.
12.Shipping_Date8
numeric
The date that the consumer’s goods were shipped. This value is the “Transaction Date” for direct marketing and ecommerce transactions. Format: MMDDYYYY
12.Multi-Clearing_Sequence_Nbr2
numeric
Includes 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. The sequence number for the initial multi-clearing transaction starts as “01” and is incremented for each subsequent clearing item sent.
12.Multi-Clearing_Sequence_Count2
numeric
The total number of clearing records, if known, else Zero Fill. The final transaction should contain the final number of settlement detail records submitted for this transaction.
12.Multi-Clearing_Partial_Reversal_Flag1
alpha
Indicates 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.
Valid values:
  • N - Do not perform a partial reversal For this Multi-Clearing Transaction.
  • Y - Perform partial reversal for the Multi-Clearing Partial Reversal Amount.
12.Multi-Clearing_Partial_Reversal_Amount12
numeric
Indicates the amount to be submitted for a partial reversal on the final Multi-Clearing transaction, if necessary. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
13.E-Commerce_Indicator1
alpha
Indicates the method used to capture the cardholder’s information for an eCommerce or internet transaction.
Valid values:
  • 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 not include 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)
13.DDD_Secure_ValuehexReturned by the 3-D Secure authentication system for Visa (Verified by VISA), MasterCard (SecureCode), American Express (SafeKey) or Discover (ProtectBuy) programs.
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)
13.UCAF_Indicator1
numeric
Identifies the means in which the transaction was processed between the cardholder and the merchant for a SecureCode authentication transaction.
Valid values:
  • 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
13.Program_Protocol1
alpha
Indicates the type of 3D Secure protocol used.
Valid values:
  • 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)
13.Directory_Server_Tran_ID36
alpha
Generated by the Directory Server during the authentication transaction and passed back to the merchant with the authentication results. Code: 01 - Directory Server Transaction ID
14.Recurring_Payment_Type1
numeric
Identifies the type of recurring transaction that is being submitted for authorization. See the Recurring_Payment_Type table for further information.
14.Installment_Number2
numeric
Indicates 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”.
14.Installment_Count2
numeric
Indicates 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”.
14.Deferment_Count2
numeric
Number of Months to defer the first installment payment.
15.DCC_Indicator1
alpha
Indicates that the POS device is Dynamic Currency Conversion (DCC) capable and the current transaction is eligible for conversion.
Valid values:
  • N - Not a DCC eligible transaction (default)
  • Y - DCC eligible transaction
  • Z - DCC eligible transaction and POS has already performed DCC
  • M - Multi-Currency
15.DCC_Exponent
82.DCC_Exponent
1
numeric
The number of exponent digits in the DCC Rate. Valid values are 0-9
15.DCC_Rate
82.DCC_Rate
8
numeric
The DCC Exponent identifies where the decimal is positioned in this value starting from the right. For example, “12345678” with an exponent of “5” would be represented as a foreign exchange rate of “123.45678
15.Cardholder_AmountcentsAmount 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).
15.Cardholder_Currency3
alpha
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.
15.Merchant_Currency
81.Merchant_Currency
3
alpha
The three (3) digit alpha currency code value. This is used on DCC transactions only.
15.DCC_Markup_Percentage
81.DCC_Markup_Percentage
4
numeric
The markup percentage that has been included in the calculation of the DCC rate for this transaction. It is expressed with two implied decimals. For example, 3.25% is sent as 0325.
15.DCC_Rate_Provider_Name
81.DCC_Rate_Provider_Name
35
alpha
Returns the name of the entity that provided the currency exchange rate.
16.ICC_Cryptogram
97.ICC_Cryptogram
16
hex
Returned by the Chip (ICC) in response to a “Generate AC” command. EMV Tag 9F26 (Space Fill if not present from the chip).
16.ICC_CID
97.ICC_CID
2
hex
Indicates the type of cryptogram and the actions to be performed by the terminal. EMV Tag 9F27 (Space Fill if not present from the chip)
16.ICC_Unpredictable_Number
97.ICC_Unpredictable_Number
8
hex
Provides variability and uniqueness to the generation of a cryptogram. EMV Tag 9F37 (Space Fill if not present from the chip)
16.ICC_ATC
86.ICC_ATC
97.ICC_ATC
4
hex
An incrementing counter value that is managed by the application in the chip card. EMV Tag 9F36 (Space Fill if not present from the chip)
16.ICC_TVR
97.ICC_TVR
10
hex
Indicates the status of the different functions as seen from the terminal. EMV Tag 95 (Space Fill if not present from the chip)
16.ICC_TT
97.ICC_TT
2
numeric
Indicates the type of financial transaction, represented by the first two digits of the ISO 8583 processing code. EMV Tag 9C (Space Fill if not present from the chip)
16.ICC_AIP
97.ICC_AIP
4
hex
Indicates the capabilities of the card to support specific functions within the application. EMV Tag 82 (Space Fill if not present from the chip)
16.ICC_TCP
97.ICC_TCP
6
hex
Indicates the card data input, CVM, and security capabilities of the terminal. EMV Tag 9F33 (Space Fill if not present from the chip)
16.ICC_CVMR
97.ICC_CVMR
6
hex
Indicates the results of the last CVM performed. EMV Tag 9F34 (Space Fill if not present from the chip)
16.ICC_TTD
97.ICC_TTD
6
numeric
Indicates the local date that the transaction was authorized. Format: YYMMDD. EMV Tag 9A (Space Fill if not present from the chip).
16.ICC_Transaction_Currency
97.ICC_Transaction_Currency
3
numeric
Indicates the currency code of the transaction according to the ISO 4217 standard. EMV Tag 5F2A (Space Fill if not present from the chip)
16.ICC_Authorized_Amount
97.ICC_Authorized_Amount
12
numeric
Indicates the authorized amount of the transaction (excluding adjustments). EMV Tag 9F02 (Space Fill if not present from the chip)
16.ICC_Other_Amount
97.ICC_Other_Amount
12
numeric
Indicates a secondary “Cashback” amount associated with the transaction. EMV Tag 9F03 (Space Fill if not present from the chip)
16.ICC_Terminal_Type
97.ICC_Terminal_Type
2
numeric
Indicates the environment of the terminal, its communication capability, and its operational control. EMV Tag 9F35 (Space Fill if not present from the chip)
16.ICC_CSN
86.ICC_CSN
97.ICC_CSN
2
numeric
Differentiates chip cards using the same Primary Account Number (PAN). The Application PAN Sequence Number (CSN) – EMV Tag 5F34 (Space Fill if not present from the chip)
16.ICC_AED
97.ICC_AED
6
numeric
The Application Expiration Date. Format: YYMMDD. EMV Tag 5F24 (Space Fill if not present from the chip)
16.ICC_IAD
97.ICC_IAD
64
hex
The Issuer Application Data – EMV Tag 9F10
16.ICC_ARC
97.ICC_ARC
2
alpha
The Authorization Response Code – EMV Tag 8A (Space Fill if not present from the chip)
16.ICC_Form_Factor_Indicator
97.ICC_Form_Factor_Indicator
8
hex
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. EMV Tag 9F6E (Space Fill if not present from the chip)
16.ICC_Customer_Exclusive_Data64
hex
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. EMV Tag 9F7C
16.ICC_TCC
97.ICC_TCC
3
numeric
Identifies the country code where the terminal is located. EMV Tag 9F1A (Space Fill if not present from the chip)
16.ICC_Third_Party_Data64
hex
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. EMV Tag 9F6E (Space Fill if not present from the chip)
16.ICC_Dedicated_File_Name32
hex
Indicates the selected Application Identifier (AID) used in the transaction request. EMV Tag 84
16.ICC_CNE45
alpha
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. EMV Tag 9F0B
17.Healthcare_Amount12
numeric
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. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1. See the Healthcare_amount table below for use cases.
17.Prescription_Amount12
numeric
Submits the amount of all prescription expenses contained within this purchase. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
17.Vision_Amount12
numeric
Submits 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. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
17.Clinic-Other_Amount12
numeric
Submits the amount of all Clinical or other qualified medical expenses contained within this purchase. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
17.Dental_Amount12
numeric
Submits the amount of all Dental expenses contained within this purchase. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
17.Transit_Amount12
numeric
Submits 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. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
18.Length_of_Stay
9B.Length_of_Stay
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.
18.PS2000_Data
19.PS2000_Data
20.PS2000_Data
80.PS2000_Data
93.PS2000_Data
22
alpha
This data will be as received during the original authorization processing. This is a “retain and return” value for terminal- based settlement messages. See PS2000 section for structure of data field.
18.Program_Indicator
20.Program_Indicator
9A.Program_Indicator
9B.Program_Indicator
1
numeric
This value is used to identify the Lodging and Auto Rental transaction type.
Valid values:
  • 1 - No Show (Lodging and Auto Rental)
  • 2 - Purchase (Lodging - Normal Stay), (Auto - Normal Rental)
  • 3 - Card Deposit (Lodging)
  • 4 - Delayed Charge (Lodging)
  • 5 - Express Service (Lodging)6 - Assured Reservation (Lodging)
19.Original_Account_Entry_Mode2
numeric
Identifies the method used to enter the Account Data for the original transaction.
Valid values:
  • 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
19.Card_ID
92.Card_ID
1
alpha
Indicates the method used to obtain / verify the cardholder’s identity.
Valid values:
  • @ - Signature Used for ID
  • A - PIN used for ID
  • N - Address used as ID or No CMV used
20.Length_of_Rental
9A.Length_of_Rental
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.
21.Departure_Date6
numeric
The date that the consumer’s stay ends. Format: YYMMDD
21.Completion_Date6
numeric
The date that the consumer’s travel will be completed. Format: YYMMDD
22.ICC_ISR
97.ICC_ISR
84
hex
Identifies the results of the terminal script processing. EMV Tag 9F5B
40.Customer_Phone_Number
60.Customer_Phone_Number
10
numeric
The consumer’s phone number including the area code. (no Dashes or Spaces)
40.Drivers_License_Number19
alpha
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. 
50.Account_Type
83.Account_Type
84.Account_Type
1
numeric
Facilitates transaction routing on Elavon.
Valid values:
  • 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
50.Surcharge_Amount
93.Surcharge_Amount
94.Surcharge_Amount
95.Surcharge_Amount
8
numeric
Indicates the amount of the surcharge applied to the transaction. This amount should be included in the Transaction Amount field. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
50.Cashback_Amount
93.Cashback_Amount
94.Cashback_Amount
95.Cashback_Amount
8
numeric
Indicates the cashback amount applied to the transaction. This amount should be included in the Transaction Amount field. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
50.Debit-EBT_Network_ID
83.Debit-EBT_Network_ID
84.Debit-EBT_Network_ID
94.Debit-EBT_Network_ID
95.Debit-EBT_Network_ID
2
alpha
Indicates 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.
Valid values:
  • 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
51.Key_Pointer
56.Key_Pointer
83.Key_Pointer
1
alpha
Indicates which encryption methodology was used for US Debit transactions (POS to Elavon) and which key to use for the next transaction (Elavon to POS).
Valid values:
  • T - Triple-DES DUKPT
  • P - PINless Debit Purchase
51.PIN_Block
56.PIN_Block
16
hex
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.
51.KSN
56.KSN
20
hex
Key Serial Number. 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:
  • 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 8 and Bytes 9-10 - Transaction Counter - 21 bits
52.Reference_Number
54.Reference_Number
83.Reference_Number
84.Reference_Number
85.Reference_Number
8
numeric
A reference number assigned by Elavon and returned in the authorization response message.
54.Retrieval_Reference_Number
84.Retrieval_Reference_Number
12
alpha
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.
55.Voucher_Clear_Nbr
94.Voucher_Clear_Nbr
15
numeric
The Voucher Clear Number from the Merchant’s EBT Food Stamp sales slip.
56.System_Trace_Audit_Nbr
84.System_Trace_Audit_Nbr
6
numeric
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.
For Canadian Debit Reversal transactions this value contains the original System Trace Audit Number from the transaction that is being reversed.
56.Processing_Code
84.Processing_Code
6
numeric
This value is submitted on all Canadian Debit transactions to indicate the transaction type. Refer to the Processing_Code table below for which processing codes are used by message type (Transaction Code).
56.MAC_KEY_Pointer1
alpha
Indicates which encryption methodology was used for the Canadian Debit MAC Value. Valid code:
T - Triple-DES DUKPT
56.MAC_Value
84.MAC_Value
8
hex
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 be space-filled if not utilized. See the Mac_Value table for additional information.
56.MAC_KSN20
hex
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:
  • Bytes 1-2 (suppress leading Fs) - Fixed Header - 16 bits
  • Bytes 3-5 - Key Set Identifier - 24 bits
  • Bytes 6-7 + 1-3 of Byte 8 - Device ID - 19 bits
  • Bits 4-8 of Byte 8 and Bytes 9-10 - Transaction Counter - 21 bits
60.Loyalty_Account_Data160 or 76
alpha
This value is used to submit the gift card or loyalty card data.
Track 2 data or manually-entered Card Data (Account Number=MMYY) or Encrypted account information.
60.Enrollment2
numeric
This value is used to identify the enrollment status for the current loyalty transaction.
  • 00 - Already Enrolled
  • 01 - Link Payment Card
  • 02 - Link Loyalty Card
  • 03 - Link Phone Number Only
60.Issue_Points1
alpha
Identifies whether points need to be accrued for the current loyalty transaction.
Valid values:
  • N - No
  • Y - Yes
60.Promo_Code
62.Promo_Code
66.Promo_Code
10
alpha
The promo code of the reward that is being offered or redeemed.
60.Encryption_Type
E1.Encryption_Type
1
alpha
Indicates the type of encryption that is used to secure the sensitive data.
Valid values:
  • V1 - VeriFone Elm
  • E2 - Elavon 3DES Encryption (non-FPE)
  • B1 - Elavon 3DES Encryption (Brazil)
60.Encryption_Key_Material
E1.Encryption_Key_Material
512
alpha
Submits additional key material used in the encryption of sensitive data for the transaction.
61.Account_Status1
alpha
Identifies the cardholder’s account status in the loyalty inquiry response transaction.
Valid values:
  • 1 - Setup (Lead)
  • 2 - Active
  • 3 - Suspended
  • 4 - Expired
  • 5 - Closed
61.Loyalty_Prompt1
alpha
Identifies if the application should prompt the cardholder to link their account data for the loyalty program.
Valid values:
  • N - No
  • Y - Yes
61.Tender_Amount12
numeric
Identifies the transaction amount less the discount for the current offer, if available. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
61.Access_Code6
alpha
Identifies the randomly generated access code that is tied to the primary customer for the account created as part of the loyalty program.
61.Loyalty_Program22
alpha
Merchant’s loyalty program description printed on the consumer’s receipt.
61.Token_Value
8E.Token_Value
19
numeric
Returned in the authorization response message when the terminal ID is set up for the tokenization service. It is the token replacement value for the Account Data field used in the original request message.
62.Promo_Code_Name22
alpha
Provides the name or “headline” for the promotional code that is offered to the consumer.
62.Promo_Code_Description44
alpha
The description for the promotional code that is being offered to the consumer.
62.Promo_Code_Issue_Points1
alpha
Identifies if a promotional issuance is necessary when the consumer elects to accept the specified promotional code.
Valid values:
  • Y - Issue points for this promotional code
  • N - Do not issue points for this promotional code
63.Pre-Auth_Reference_Number
68.Pre-Auth_Reference_Number
12
numeric
A Gift Card value used to identify the original pre-authorization request. This value is required to submit the post-authorization completion transaction message.
65.Gift-Loyalty_Transaction_Code
68.Gift-Loyalty_Transaction_Code
12
alpha
A unique value assigned by the POS to identify the gift card transaction. Required for both Gift Card and Loyalty reversal transactions.
65.Points12
numeric
The amount of points to remove from the account.
66.Units6
numeric
The number of units for the transaction represented in whole numbers.
67.SKU_Number30
alpha
The SKU number for the selected item.
67.Price12
numeric
The cost of an item in a Loyalty card transaction. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
67.Quantity6
numeric
The count of items in whole numbers in the SKU line item detail. Assume 1 if left blank.
68.Points_Added12
numeric
The amount of points added to an account.
68.Points_Canceled12
numeric
The amount of points canceled from the account.
68.Member_Name50
alpha
The Member name associated with the gift or loyalty card transaction, if available.
68.Receipt_Message40
alpha
A custom message printed on Gift / Loyalty card transactions.
70.Tender_Type1
numeric
Identifies the payment method used to activate or reload a gift card.
Valid values:
  • 0 - Cash
  • 1 - Credit Card
  • 2 - Debit Card
  • 3 - Check
  • 9 - Not Used or Unknown
70.Security_Code6
numeric
The Gift Card/Loyalty Security Code (PIN) value. 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.
72.Cardholder_ID9
numeric
The applicant’s social security number (SSN).
72.House_Number9
numeric
Used on Bridgestone/Firestone Instant Credit message to identify the applicant’s street address.  Numeric values only.
72.Zip_Code5
numeric
Used on Bridgestone/Firestone Instant Credit message to identify the ZIP code of the applicant.
72.Date_of_Birth8
numeric
Used on Bridgestone/Firestone Instant Credit message to identify the birth date of the applicant. Format: MMDDYYYY
72.Annual_Income_Amount10
numeric
Indicates the applicant’s annual gross income from all sources for the Bridgestone/Firestone instant credit application request. Submitted in whole dollars.
Example: $10,000 is sent as 10000
72.Application_Type2
alpha
Indicates the application type used to submit the Bridgestone/Firestone instant credit application request.
Valid values:
  • 00 - Housing expenses not collected
  • 01 - Housing expenses collected
72.Resident_Status1
numeric
Indicates the applicant’s current resident Status.
Valid values:
  • 0 - Own
  • 1 - Rent/Other
72.Rent-Mortgage_Amount5
numeric
Indicates the applicant’s current monthly rent or mortgage amount expressed in a whole dollar amount. If the Resident Status is “Own” then send as “0” (zero). ($1,000 is sent as 1000)
73.Return_Message16
alpha
The response message that is returned on a CFNA Bridgestone/Firestone credit application request.
Valid codes and response messages:
  • AA - ACCOUNT APPROVED (Account number and credit limit are returned)
  • AA - EXISTING ACCOUNT (Applicant has an existing BSFS account,the existing account number is returned in the account number field)
  • ND - CANNOT APPROVE (CFNA cannot approve application)
  • NR - WILL INVESTIGATE (CFNA will review and approve/deny, then call location)
  • NR - ERR.CFNA WILL CL (CFNA system error when processing the application)
  • NR - CL 800-527-6770 (Call CFNA for further information)
73.Account_Number9
alpha
The applicant’s CFNA Bridgestone / Firestone account number returned from the instant credit application request.
73.Credit_Limit5
numeric
The total credit limit returned from a CFNA Bridgestone / Firestone credit application request. The decimal is not implied and values are rounded up to whole numbers. ($1 is sent as 1)
73.First_Name14
alpha
The applicant’s first name on the Bridgestone/Firestone instant credit application request.
73.Last_Name20
alpha
The applicant’s last name on the Bridgestone/Firestone instant credit application request.
78.Additional_Key_Available1
numeric
Returned in the EMV Key exchange response message to identify if another EMV Key is available to be retrieved from the host.
Valid values:
  • 0 - No – There an no more remaining keys for download
  • 1 - Yes – There are more keys are available for download
78.Data_Type2
numeric
Identifies the type of EMV Key that is being sent.
Default value is 01 - CA Public Key
78.RID10
alpha
Identifies the specific application system in on the POS Device.
78.PKI2
hex
Public Key Index. Identifies the Public Key in conjunction with the RID. CA Public Key Index
78.Hash_ID2
alpha
Identifies the hash algorithm used to produce the hash results in the digital signature scheme. Default value is 01 - Hash algorithm
78.Digital_Signature_ID2
alpha
Identifies the digital signature algorithm to be used with the public key. Default value is 01 - Digital Signature (default)
78.Public_Key496
hex
The value of the modulus part of the Certification Authority Public Key.
78.Exponent6
alpha
The exponent part of the public key for an EMV Key exchange.
78.Check_Sum40
hex
A check value that is calculated on the concatenation of all parts of the public key.
78.CA_Public_Key_Length2
hex
One of the elements of the public key used to confirm the size of the public key in the cryptography process.
78.CA_Public_Key_Exp_Date6
numeric
CA Public Key Expiration Date. Format: YYMMDD
78.EMV_Key_Date
86.EMV_Key_Date
8
numeric
Identifies the 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.
Format: MMDDYYYY
80.Amex_Capture_Code1
numeric
The American Express Capture Code field 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.
Valid values:
  • 0 - Do not process
  • 1 - Allow authorizations but do not capture in Settlement file
  • 2 - Allow authorizations and capture in settlement file for processing
80.AVS_Response
93.AVS_Response
1
alpha
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. See below for valid values.
80.CVV2_Response
93.CVV2_Response
1
alpha
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.
Valid values:
  • 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
80.MSDI
83.MSDI
93.MSDI
94.MSDI
1
alpha
The Market Specific Data Indicator value. See the MSDI table for valid values.
80.ECI_Security_Level_Indicator
93.ECI_Security_Level_Indicator
3
alpha
Indicates the security level and cardholder authentication for MasterCard transactions. This value should be retained and returned unaltered in Terminal-Based settlement messages.
  • Position 1 = Security protocol
  • Position 2 = Cardholder authentication
  • Position 3 = UCAF Collection Indicator
81.Time_Stamp12
numeric
Indicates the date and time until which the Foreign Exchange Rates are valid. Format: YYYYMMDDHHMM
82.Currency_Code3
alpha
The three (3) digit alpha currency code value. See the Currency Code Table for a complete currency list.
83.Debit-EBT_Settlement_Date
84.Debit-EBT_Settlement_Date
94.Debit-EBT_Settlement_Date
95.Debit-EBT_Settlement_Date
4
numeric
Debit Settlement Date. Format: MMDD
83.Debit_Interchange_Indicator
94.Debit_Interchange_Indicator
1
alpha
Indicates that a special interchange rate was used in the processing of this transaction.
Valid values:
  • 0 - Does not participate
  • 1 - Pulse
  • A - All Star
  • D - Durbin Qualified
  • F - Durbin Qualified (Additional Fraud Review)
  • P - NYCE Premier
84.PIN_Working_Key16 or 32
hex
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.
84.Debit_Response_Code2
alpha
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. See table below for valid values.
85.Response_Source_Indicator
96.Response_Source_Indicator
1
alpha
Indicates if the check was authorized by a participating member bank or a third party check processor.
Valid values:
  • 5 - Member Bank
  • A - Third Party Check Processor
85.Parsed_Transit_Routing_Nbr
96.Parsed_Transit_Routing_Nbr
9
numeric
The parsed checking Transit / Routing number as returned in the authorization response message.
85.Parsed_Account_Nbr16
numeric
The parsed checking account number as returned in the authorization response message.
85.Parsed_Check_Nbr
96.Parsed_Check_Nbr
8
numeric
The parsed checking serial number as returned in the authorization response message.
85.Transaction_ID
96.Transaction_ID
15
numeric
The transaction ID value returned in the Electronic Check authorization response message.
85.Free_Form_Data76
alpha
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. Each line of data in this string is delimited by the “/” character. The “\” character should be replaced with a space. Please refer to the Electronic Check primer for receipt requirements.
85.Service_Fee21
alpha
Identifies 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. Example: “GA = $20 or 5%”
86.ICC_ARPC32
hex
Contains data sent to the chip card for online issuer authentication. EMV Tag 91
86.ICC_Issuer_Script256
hex
Returns the Issuer specified script contained in EMV Tags 71 or 72 back to the POS in the authorization response message.
  • Digits 1-2 - This field is the EMV Issuer Script Identifier returned in the response message ‘71’ = EMV Tag 71. ‘72’ = EMV Tag 72
  • Digits 3-4 - This field identifies the ICC Issuer Script Command field length
  • Digits 5-256 - This field contains the Issuer Script Command to be submitted to the Chip card
86.Device_Type
97.Device_Type
2
alpha
Identifies 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. See table for valid values.
87.Authorized_Amount12
numeric
Identifies the total authorized amount for the authorization request. If the Partial authorization flag is enabled, this amount may be less than the requested amount. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
87.Account_Balance_112
numeric
For Credit and Debit cards: this value indicates the remaining balance for a pre-paid account. For EBT transactions: this value indicates the remaining Food Stamp balance.
For Gift Card transactions: this value indicates the remaining Gift Card balance on the account. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1. See the Account_Balance table for field information.
87.Account_Balance_212
numeric
For Credit and Debit cards: this value indicates the remaining Gift Card Balance on the account. For EBT transactions: this value indicates the remaining Cash Benefit balance.
For Gift Card transactions: this value indicates the remaining Loyalty points on the account. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1. See the Account_Balance table for field information.
87.Account_Balance_312
numeric
For Credit and Debit cards: this value indicates the remaining Loyalty points on the account. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1. See the Account_Balance table for field information.
88.Redemption_Amount12
numeric
Identifies the total amount of all Gift Card Redemption transactions in the batch. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
88.Redemption_Count8
numeric
The total number of Gift Card Redemption transactions in the batch.
88.Activation_Amount12
numeric
Identifies the total amount of all Gift Card Activation transactions in the batch. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
88.Activation_Count8
numeric
Identifies the total number of all Gift Card Activation transactions in the batch.
88.Card_Refund_Amount12
numeric
Identifies the total amount of all Gift Card “Card Refund” transactions in the batch. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
88.Card_Refund_Count8
numeric
Identifies the total number of all Gift Card “Card Refund” transactions in the batch.
88.Reload_Amount12
numeric
Identifies the total amount of all Gift Card Reload transactions in the batch. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
88.Reload_Count8
numeric
Identifies the total number of all Gift Card Reload transactions in the batch.
88.Credit_Amount12
numeric
Identifies the total amount of all Gift Card Credit transactions in the batch. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
88.Credit_Count8
numeric
Identifies the total number of all Gift Card Credit transactions in the batch.
88.Points_Transfer_Amount(to)
8A.Points_Transfer_Amount(to)
12
numeric
Identifies the total amount of all Loyalty Transfer (to) transactions in the batch. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
88.Points_Transfer_Count(to)
8A.Points_Transfer_Count(to)
8
numeric
Identifies the total number of all Loyalty Transfer (to) transactions in the batch.
88.Points_Transfer_Amount(from)
8A.Points_Transfer_Amount(from)
12
numeric
Identifies the total number of all Loyalty Transfer (from) transactions in the batch. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
88.Points_Transfer_Count(from)
8A.Points_Transfer_Count(from)
8
numeric
Identifies the total number of all Loyalty Transfer (from) transactions in the batch.
89.Response_Message16
alpha
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. See the table for codes and descriptions.
89.Net_Amount_Sign1
alpha
Identifies the net dollar amount of all transactions in the batch.
Valid values:
  • + Positive Balance
  • - Negative Balance
89.Net_Amount
90.Net_Amount
12
numeric
Identifies 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)
The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
Negative amounts are expressed with a minus sign: -$1 is sent as -100.
89.Net_Count8
numeric
Identifies the total number of transactions in the batch.
Net Count = (Credit Sales + Forces + Returns) + (Debit Purchases + Debit Returns) + (EBT Purchases + EBT Returns) + (ECS Purchases)
89.Credit_Sale_Amount12
numeric
Submits the total amount of all Credit Card Sale and Force transactions. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
89.Credit_Sale_Count8
numeric
Submits the total count of all Credit Card Sale and Force transactions.
89.Credit_Return_Amount12
numeric
Submits the total amount of all Credit Card Return transactions. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
89.Credit_Return_Count8
numeric
Submits the total count of all Credit Card Return transactions.
89.Debit-EBT_Purchase_Amount12
numeric
Submits the total amount of all Debit Card and EBT Purchase transactions. This includes Voucher Clear Purchase transactions. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
89.Debit-EBT_Purchase_Count8
numeric
Submits the total count of all Debit Card and EBT Purchase transactions. This includes Voucher Clear Purchase transactions.
89.Debit-EBT_Return_Amount12
numeric
Submits the total amount of all Debit Card and EBT Return transactions. This includes Voucher Clear Return transactions. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
89.Debit-EBT_Return_Count8
numeric
Submits the total count of all Debit Card and EBT Return transactions. This includes Voucher Clear Return transactions.
89.ECS_Purchase_Amount12
numeric
Submits the total amount of all Electronic Check Purchase transactions. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
89.ECS_Purchase_Count8
numeric
Submits the total count of all Electronic Check Purchase transactions.
89.Void_Amount12
numeric
Submits the total amount of all voided transactions in the batch. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
89.Void_Count8
numeric
Submits the total count of all voided transactions in the batch.
8A.Loyalty_Add_Points_Amount12
numeric
Identifies the total amount of all Loyalty Add Point transactions in the batch. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
8A.Loyalty_Add_Points_Count8
numeric
Identifies the total number of all Loyalty Add Point transactions in the batch.
8A.Loyalty_Redemption_Amount12
numeric
Identifies the total amount of all Loyalty Redemption transactions in the batch. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
8A.Loyalty_Redemption_Count8
numeric
Identifies the total number of all Loyalty Redemption transactions in the batch.
8A.Loyalty_Return_Amount12
numeric
Identifies the total amount of all Loyalty Return transactions in the batch. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
8A.Loyalty_Return_Count8
numeric
Identifies the total number of all Loyalty Return transactions in the batch.
8B.Total_Installments2
numeric
Total number of Installment payments for the transaction.
8B.Installment_Amount12
numeric
The amount of the installment payment including interest, if applicable. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
8B.Total_Installment_Amount12
numeric
The total amount of the Installment transaction payments including interest, if applicable. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
8B.Total_Effective_Cost7
numeric
This value is the total annual rate (CET) for the Installment transaction. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
8B.Monthly_Interest5
numeric
Contains the monthly interest amount for the installment payment. Two Implied decimals.
8B.Interest_Rate7
numeric
Identifies the Interest rate used for the installment transaction. Two Implied decimals.
8B.Tax_Amount7
numeric
The tax amount of the Installment transaction. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
8B.Insurance_Amount7
numeric
Identifies the insurance amount for the transaction, if applicable. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
8B.Additional_Amount7
numeric
Identifies that additional amount for a Brazilian Installment transaction. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
8B.Register_Amount7
numeric
Used in Brazilian Installment transactions. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
8B.Installment_Date6
numeric
The date of the first installment payment. Format: DDMMYY
8C.IVU_Loto_Prefix2
alpha
The unique IVU Loto processor identifier assigned for Elavon.
8C.Draw_Date6
numeric
The Loto Draw Date. Format: MMDDYY
8C.Draw_Number3
numeric
The Loto Draw Number.
8C.IVU_Loto_Number10
alpha
IVU Loto Number.
8F.Token_Account_Status1
alpha
Identifies the value as a regulated or non-regulated token.
Valid values:
  • Space - Not Applicable (default value)
  • R - Regulated
  • N - Non-Regulated
8F.Token_Assurance_Level2
alpha
Returns a value that indicates the confidence level of the token to PAN mapping (Space Fill, if not present).
8F.Token_Requestor_ID11
alpha
Returns the token requestor ID.
8F.PAN_Last_Four_Digits4
numeric
Returns the last four (4) digits of the actual card account number when a token was presented for authorization.
B1.ROC_Text_Data39
alpha
Used to submit additional data on the transaction; unique merchant-assigned data for this transaction.
90.Record_Count
98.Record_Count
8
numeric
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.
90.Net_Tip_Amount12
numeric
Indicates 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. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
91.Tip_Amount6
numeric
The TIP amount applied to the transaction. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
92.Account_Source1
numeric
Facilitates transaction routing to Elavon.
Valid codes are:
  • 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
92.Capture_Tran_Code1
numeric
Indicates the type of transaction that is being submitted for settlement.
Valid codes are:
  • 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
92.Service_Code3
numeric
The service code of the card. (Space Fill, if not present)
92.Number_of_Incrementals2
numeric
Identifies the number of incremental authorizations that have been submitted with this transaction.
Valid values are 00 - 90. 00 is default value.
93.Total_Auth_Amount
9A.Total_Auth_Amount
9B.Total_Auth_Amount
12
numeric
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. The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
98.Transmission_Date4
numeric
The date of the settlement attempt. Format: MMDD
98.Net_Deposit12
numeric
Identifies the net deposit amount of all transactions in the batch. 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)
Calculates as: Net Amount = ((Credit Sales + Forces) – Credit Returns) + (Debit and EBT Purchases – Debit and EBT Returns) + (ECS Purchases)
98.Hash_Total16
numeric
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.
The decimal is implied: $1 is sent as 100 and 1¢ is sent as 1.
99.Merchant_ID16
numeric
The Merchant ID assigned by Elavon.
9A.Rental_Check_Out_Date8
numeric
The date the customer first drove away with the rental vehicle. Format: MMDDYYYY
9A.Rental_Return_Date8
numeric
The date the customer returned the rental vehicle. Format: MMDDYYYY. This value is the “Transaction Date”.
9A.Auto_Rental_Number25
alpha
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.
9A.Extra_Charges
9B.Extra_Charges
6
numeric
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. See table for valid Lodging and Auto Rental codes.
9A.Renter_Name20
alpha
The name of the customer who rented the vehicle. (Used for MasterCard transactions)
9A.Rental_Return_City18
alpha
The name of the city where the vehicle was returned. (Used for MasterCard transactions)
9A.Rental_Return_State-Country3
alpha
The name of the State or Country where the vehicle was returned. (Used for MasterCard transactions)
9A.Rental_Return_Location_ID10
alpha
The location ID of where the vehicle was returned. (Used for MasterCard transactions)
9B.Check_In_Date8
numeric
The check in date. Format: MMDDYYYY
9B.Check_Out_Date8
numeric
The check out date. This is the “Transaction Date” for lodging transactions. Format: MMDDYYYY
9B.Room_Number10
numeric
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.
9C.Risk_Data5
alpha
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. See the Risk_Data table for provider information.
9C.Risk_Data_Provider2
alpha
Identifies the provider of the risk information returned in the response. The risk data will be sent in the Risk Data Field.
Valid values:
  • VI - Visa
  • MC - MasterCard
9F.Status1
alpha
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.
Valid codes:
  • A - Transaction Accepted
  • E - Error Detected
9F.Results16
alpha
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.
B2.Download_Start_Date6
numeric
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. Format: MMDDYY
B2.Download_Start_Time6
numeric
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. Format: HHMMSS
B2.Download_Type1
alpha
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.
Valid codes:
  • 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.
B3.VAN_Partner_Data39
alpha
Unique VAN Partner Data for receipt printing.
D1.Device_Serial_Number20
alpha
Device Serial Number of the encrypting device.

Account_Balance_1

Field NameCredit CardDebit CardEBTCheckGift Card
Account Balance 1Pre-PaidPre-PaidFood Stampn/aGift Card
Account Balance 2Gift CardGift CardCash Benefitn/aLoyalty
Account Balance 3LoyaltyLoyaltyn/an/an/a

Account_Data

  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 transit symbol from MICR line must be replaced by the letter (T) in either upper or lower case.
  • The On-us symbol on-us symbol from MICR line must be replaced by the letter (O) in either upper or lower case.
  • The Amount symbol amount symbol from MICR line must be replaced by the letter (A) in either upper or lower case.
  • The Dash symbol dash symbol from MICR line must be replaced by the letter (D) in either upper or lower case.
  1. 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
    Example: T987654321T1234567890123456O12345

  • For WEB, TEL, PPD, CCD transactions: “T” + (Transit\Routing) + “T” + Checking Account Number + “O
    Example: T987654321T1234567890123456O

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

  2. Token data (Token Data=MMYY)

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

  4. 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

CodeDescription
01Key Entered – Card Not Present (01)
02Key Entered – Card Present (71)
12Key Entered – Credential on File
03Swiped (90)
04Proximity (91)
05EMV (ICC) with CVV or iCVV (05)
06EMV (ICC) proximity read (07)
07EMV (ICC) with no CVV or iCVV (95)
08EMV (ICC) – Mag stripe Read when the chip failed to read
09EMV (ICC) – Digital Secure Remote Payment (09)
10Scanned MICR (84)
11Keyed MICR

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).

Sample Rate Conversions

USD*Foreign RateRounded Value
$10.00 USD112.27188 (JPY Rate) = ¥ 1122.7188¥ 1123
$10.00 USD0.55074 (GBP Rate) = £ 5.5074£ 5.51
$10.00 USD0.80363 (EUR Rate) = € 8.0363€ 8.04
$10.00 USD1.2616 (CAD Rate) = $ 12.616$ 12.62
$10.00 USD1.35045 (AUD Rate) = $ 13.5045$ 13.50

note

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).

Application_ID

DigitDescription
1Processing Type
H = Host Based
T = Terminal Based
2Device Type
Z = 3rd Party Vendor Solution
3-6Vendor ID Number, as assigned by Elavon
7Market Segment
G = General
R = Retail, Restaurant
M = Mail Order / Telephone Order
I = (MOTO) Internet (e-Commerce)
L = Lodging
A = Auto Rental
8Communication Module
Space = Dial
A = NOVA API
L = NOVA Link SSL
C = SSL Gateway
W = Wireless
X = (CDMA) Custom TCP/IP

Authorization_Response

MessageCodeDefinition
APPROVALAAApproved
APPROVALAPApproved Partial
APPROVALACApproved (without Cashback)
SERV NOT ALLOWEDNDInvalid request
REQ EXCEEDS BALNDRequest exceeds balance
NOT ON FILENDCardholder not found
EXPIRED CARDNDExpired Card
INCORRECT PINNDInvalid PIN
PICK UP CARDNCPick up card
INVALID CARDNDInvalid Card
DECLINEDNDDo Not Honor
CALL AUTH CENTERNRRefer to Issuer
DECLINED-HELP 9999NDSystem Error
CALL REF.; 999999NRRefer to Issuer
AMOUNT ERRORNDTran Amount Error
INVALID TERM IDNDInvalid Terminal ID
INVLD TERM ID 1NDInvalid Merchant Number
INVLD TERM ID 2NDInvalid SE Number
REC NOT FOUNDNFRecord not on Elavon Network
INVLD VOID DATANDInvalid 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

MessageCodeDefinition
APPROVALAAApproved
DECLINED-HELP 999901Host Busy
INVALID CARD02Invalid Card
INVALID TERM ID03Invalid Terminal ID
AMOUNT ERROR04Tran Amount Error
ALREADY ACTIVE05Card already active
REQ. EXCEEDS BAL.06Request exceeds balance
MAX REACHED07Cannot load the amount specified NON RELOADABLE 08 The card cannot be reloaded
CARD ALREADY ACTIVE12The EGC card is already activated DECLINED-HELP 9999 99 General System Error
SERV NOT ALLOWEDNDInvalid request
INVLD TERM ID 1NDInvalid Merchant Number SEQ ERR PLS CALL ND Call for Assistance
APPL TYPE ERRORNDCall for Assistance

Private Label

MessageCodeDefinition
AP xxxxxx $9999AACFNA Private Label Approval
DECLINEDNDSale is Not Approved
CALL 18007629000NRCall CFNA Credit Department for more information

AVS_Response

CodeDescription
AAddress (Street) matches, Zip does not
BStreet address match, Postal code in wrong format (international issuer)
CStreet address and postal code in wrong format
DStreet address and postal code match (international issuer)
EAVS error
FAddress does compare and five-digit ZIP code does compare (UK only)
GCard issued by a non-US issuer that does not participate in the AVS System
IAddress information not verified by international issuer
MStreet Address and Postal code match (international issuer)
NNo Match on Address (Street) or Zip
PPostal codes match, Street address not verified due to incompatible formats
RRetry, System unavailable or Timed out
SService not supported by issuer
UAddress information is unavailable (domestic issuer)
W9 digit Zip matches, Address (Street) does not
XExact AVS Match
YAddress (Street) and 5 digit Zip match
Z5 digit Zip matches, Address (Street) does not

Credit_Authorization_Amount

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

LengthTypeDescription
12NumericThe decimal is implied. ($1 is sent as 100 and 1¢ is sent as 1)

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.

Debit CodeElavon CodeDescriptionExternal TerminalExternal PIN PadInternal PIN Pad
00AAApprovedApproval authnoApprovedApproval authno
05NDDo not honorDo not honourDeclinedDo not honour
06NDEdit errorErrorDeclinedError
12NDInvalid processing codeInvalid transactionDeclinedInvalid transaction
13NDInvalid amountInvalid amountDeclinedInvalid amount
14NDEdit Error in PANDeclinedInvalid card numberInvalid card number
19NDRFI error – re-enter transactionRe-enter transactionRe-enter transactionRe-enter transaction
40NDRequested function not supportedInvalid transactionDeclinedInvalid transaction
51NDNon-sufficient fundsDeclinedNot sufficient fundsNot sufficient funds
52NDNo chequing accountDeclinedNo chequing accountNo chequing account
53NDNo savings accountDeclinedNo savings accountNo savings account
54NDExpired cardExpired cardExpired cardExpired card
55NDIncorrect PINDeclinedIncorrect PINIncorrect PIN
56NDNo card recordNo card recordNo card recordNo card record
57NDTran not permitted to cardholderUnauthorize txnDeclinedUnauthorize txn
58NDTran not permitted to terminalInvalid transactionDeclinedInvalid transaction
61NDExceeds withdrawal amount limitDeclinedExceeds amount limitExceeds amount limit
62NDRestricted cardDeclinedRestricted cardRestricted card
63NDSecurity violation –MAC value is incorrectSecurity violationDeclinedSecurity violation
65NDExceeds withdrawal frequency limitDeclinedExceeds freq limitExceeds freq limit
68NDResponse received too late (Time- Out)Response timeoutDeclinedResponse timeout
75NDNumber of PIN tries exceededDeclinedPIN tries exceededPIN tries exceeded
77NDInvalid capture dateNo ntwrk shr agrmentDeclinedNo ntwrk shr agrment
81NDInvalid PIN blockDeclinedIncorrect PINIncorrect PIN
82NDPIN length errorDeclinedIncorrect PINIncorrect PIN
85NDNo keys available for UseSuspected malfuncDeclinedSuspected malfunc
86NDMessage encryption key synchronization errorSuspected malfuncDeclinedSuspected malfunc
87NDPIN key synchronization errorPin key sync errorDeclinedPin key sync error
88NDMac key synchronization errorMAC key sync errorDeclinedMAC key sync error
89NDTransaction requires Contact InterfacePls Insert CardTrn Not CompletePls Insert Card
91NDIssuer Inc or switch is inoperativeIss or switch inopDeclinedIss or switch inop
92NDFinancial institution or intermediate network facility cannot be found for routingCannot contact bankDeclinedCannot contact bank
94NDDuplicate transmissionDupl transmissionDupl transmissionDupl transmission
96NDSystem malfunctionSystem malfunctionDeclinedSystem malfunction
Q0NDEdit error in capture dateNo ntwrk shr agrmentDeclinedNo ntwrk shr agrment
Q9NDResponse not listed above has been receivedSuspected malfuncDeclinedSuspected malfunc
TONDHost time-outHost time-outTrn not completeHost time-out
TQNDSequence errorSeq err pls callTrn not completeSeq err pls call
TXNDService not allowedService not allowedTrn not completeService not allowed
TENDExpired cardExpired cardTrn not completeExpired card
TCNDInvalid cardInvalid cardTrn not completeInvalid card
TANDAmount errorAmount errorTrn not completeAmount error
TINDInvalid terminal IDInvalid term IDTrn not completeInvalid term ID
TMNDInvalid merchant #Invalid term ID 1Trn not completeInvalid term ID 1
TSNDInvalid SE #Invalid term ID 2Trn not completeInvalid term ID 2
TRNDRecord not found on ElavonRecord not foundTrn not completeRecord not found
TVNDInvalid dataInvld void dataTrn not completeInvld void data
TNNDCall for assistanceAppl type errorTrn not completeAppl type error
TPNDPlease retryPlease retryTrn not completePlease retry
TBNDTransaction errorInvalid data5276Trn not completeInvalid data5276
TZNDUnknown errorSystem errorTrn not completeSystem error

Device_Type

LenTypeCodeDescription
2AlphaspacesNot Applicable (default value)
01Mobile Network Operator (MNO) controlled removable secure element (SIM or UICC) personalized for use with a mobile phone or smartphone
07Mobile phone or smartphone with a fixed (non-removable) secure element controlled by the MNO, for example, code division multiple access (CDMA)
08Removable secure element not controlled by the MNO, for example, memory card personalized for used with a mobile phone or smartphone
09Mobile phone or smartphone with a fixed (non-removable) secure element not controlled by the MNO
10MNO controlled removable secure element (SIM or UICC) personalized for use with a tablet or e-book
11Tablet or e-book with a fixed (non-removable) secure element controlled by the MNO
12Removable secure element not controlled by the MNO, for example, memory card personalized for use with a tablet or e-book
13Tablet or e-book with fixed (non-removable) secure element not controlled by the MNO
14 - 99Reserved for Future Use

Extra_Charges

CodeLodging DescriptionAuto Rental Description
1Restaurant ChargeGasoline
2Gift Shop ChargeExtra Mileage
3Mini-Bar ChargeLate Return
4Telephone ChargeOne Way Service Fee
5Laundry ChargeParking or Moving Violation
6Other/Miscellaneous Charge

Healthcare_Amount

Auto Substantiation FieldsUsage 1Usage 2Usage 3Usage 4Usage 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)

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.

LenTypeDescription
16
32
hexThis 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_Value

FieldsLenDescription
Processing Code6The processing code from the transaction.
Transaction Amount12The 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 Number6The System Trace Audit Number from the transaction, if available.
Card Account Number (PAN)1-19Card Account Number (Numeric Value Only).
Retrieval Reference Number12The Retrieval Reference Number, if available.
Debit Response Code2The Debit Response Code, if available.

note

The following editing rules will apply:

  • A single space is inserted following each implicitly delimited field.
  • Lower case characters are translated to upper case.
  • Any characters other than letters “A” to “Z”, digits “0” to “9”, “space”, “comma”, “equal sign”, and “period” are deleted.
  • The Card Account Number (PAN) field is a numeric-only value.
  • No spaces or dashes are allowed in the Card Account Number (PAN) field. Any characters other than digits “0” to “9” are deleted.
  • All leading spaces are deleted.
  • 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.

FieldsPurchaseReturnVoidReversalResponse
Processing CodeYesYesYesYesNo
Transaction AmountYesYesYesYesYes
System Trace Audit NumberYesYesYesYesYes
Card Account Number (PAN)YesYesYesNoNo
Retrieval Reference NumberNoNoYesNoYes
Debit Response CodeNoNoNoNoYes

MSDI

LenTypeCodeDescription
1Alpha0Returned if the data was not presented in authorization
1Returned if the data passed the Hotel Edits (H)
2Returned if the data failed Edits (N)
3Healthcare / Auto-Substantiation (M)
4Transit / Auto-Substantiation (T)
5Returned if the data passed the Visa Aggregator edits (E)
6Returned if the data passed the Auto Rental edits (A)
7Returned if the data passed the Bill Payment edits (B)
8Returned if the data passed the MasterCard Payment Gateway edits (G)
9Business to Business Invoice Payments (J)
ADebit Purchase without PIN Block (S)

POS_Entry_Capability

CodeDescription
01Manual Entry Only (01,02,12)
02Magnetically Swipe Capability (01, 02, 12, 03)
03Proximity Read Capability (w/Magstripe) (01, 02, 12, 03, 04, 06)
13Proximity Read Capability Only (wo/Magstripe) (04, 06)
04EMV Chip Capability (ICC) – Contact Only(w/Magstripe) (01, 02, 12, 03, 05, 07, 08)
05EMV Chip Capability (ICC) – Duel Interface(w/Magstripe) (01, 02, 12, 03, 04, 05, 06, 07, 08, 09)
15EMV Chip Capability (ICC) – Dual Interface(wo/Magstripe) (05, 06, 07, 08)
10MICR Read (10, 11)

Processing_Code

LenTypeDescriptionTran Code:200201298299
6Numeric000000 = Debit Purchase from the Default Account (Flash Only)Yes  Yes
001000 = Debit Purchase from SavingsYes  Yes
002000 = Debit Purchase from CheckingYes  Yes
091000 = Debit Purchase with cashback from SavingsYes  Yes
092000 = Debit Purchase with cashback from CheckingYes  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 

PS2000_Data

The structure of the PS2000 data field is as follows:

Card BrandPos. 1Pos. 2 - 16Pos. 17 - 20Pos. 21 - 22
VisaACITransaction IDValidation CodeALP
MasterCard“M”Banknet Reference NbrBanknet DateTIC
Discover“D”NRIDTransaction Data Condition Code  (LF – space filled)Spaces
AMEX“A”Transaction IDSpacesSpaces
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

Recurring_Payment_Type

CodeDescriptionUSAPRICANBRAMEX
1Recurring TransactionYesYesYesYesYes
2Installment TransactionYesYesNoNoNo
3Acquirer Installment Transaction (without Interest)NoNoNoYesNo
4Issuer Installment Transaction (with Interest)NoNoNoYesYes
5Issuer Installment Transaction (without Interest)NoNoNoNoYes
6Issuer Installment Transaction (without Promotion)NoNoNoNoYes
7Buy Now, Pay Later (Deferred payment in full)NoNoNoNoYes
8Carne Bill Payment (Brazil)NoNoNoYesNo

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.

Response_Message

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

LenTypeResponse CodeResponse Description
16AlphaGBGood Batch
RBRejected Batch
GBOK  BBBMMDDHHMMGBOK = Good batch, settlement received OK
BBB = Batch Number 001 through 999
MMDD = Month and day of Settlement
HHMM = Time of Settlement in hours and minutes
RBOUT OF BALANCEItem and Dollar totals do not match the settlement trailer record totals.
RB INV ACCT 9999Record number 9999 is invalid.
RB INV CARD 9999Card type not allowed for settlement for the Merchant ID for record 9999.
RB INV DATA 9999Data Invalid for record 9999, please retry.
RB INVLD AMT9999Invalid transaction amount for record 9999.
RB PLEASE RETRYSystem failure, please re-attempt.
RB UNREC CAR9999Card type not recognized for record 9999.
RB UPLOAD TIPSAn out of balance condition was detected that uploading of tip data will correct.
INVALID TERM IDTerminal ID not on file at Elavon.
INVALID MER IDMerchant number not found on the Elavon system.
NO PRIOR BATCHNo prior batch exists for inquiry.
NO TRANSACTIONSThere are no transactions in the requested batch.
BATCH 999 PURGEDBatch number specified was deleted per end user request.
BATCH NOT PURGEDRequest was denied - Invalid Merchant ID.
SERV NOT ALLOWEDMerchant not set up for settlement processing on Elavon.

Risk_Data

The format may vary by provider.

ProviderField NameLenTypeDescription
VI (Visa)Risk Assessment Data2NumericA 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 Code2NumericThis 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 Score3AlphaA value from 001 to 998. Where 001 indicates the least likely fraudulent transaction and 998 indicates the most likely fraudulent transaction.
MC (MasterCard)Merchant Score2AlphaThis field indicates the key factors that influenced Reason Code fraud score.

Transaction_Code

CodeDescriptionRequest ID
000Credit Card SaleCredit Card.Sale
001Credit Card Authorization OnlyCredit Card.Auth Only
002Credit Card Account Verification OnlyCredit Card.Account Verification Only
004Credit Card Pre-Paid Balance InquiryCredit Card.Pre-Paid Balance Inquiry
005Credit Card ReturnCredit Card.Return
006Credit Card ForceCredit Card.Force
008Credit Card Visa Account FundingCredit Card.Visa Account Funding
009Credit Card MasterCard Payment TransactionCredit Card.MasterCard Payment
010Credit Card Lodging Check InCredit Card.Lodging Check In
011Credit Card IncrementalCredit Card.Incremental
012Auto RentalCredit Card.Auto Rental
098Credit Card VoidCredit Card.Void
099Credit Card ReversalCredit Card.Reversal
100Debit Card PurchaseDebit.Purchase
101Debit Card PIN Less PurchaseDebit.PINless Purchase
102Debit Card ReturnDebit.Return
103Debit Card Balance InquiryDebit.Balance Inquiry
120EBT Food Stamp PurchaseEBT.Food Stamp Purchase
121EBT Food Stamp Voucher Clear PurchaseEBT.Food Stamp Voucher Clear Purchase
122EBT Food Stamp ReturnEBT.Food Stamp Return
123EBT Food Stamp Voucher Clear ReturnEBT.Food Stamp Voucher Clear Return
124EBT Food Stamp Balance InquiryEBT.Food Stamp Balance Inquiry
140EBT Cash Benefit PurchaseEBT.Cash Benefit Purchase
141EBT Cash Benefit Balance InquiryEBT.Cash Benefit Balance Inquiry
197Debit / EBT EchoDebit.Echo or EBT.Echo
198Debit / EBT VoidDebit.Void or EBT.Void
199Debit / EBT ReversalDebit.Reversal or EBT.Reversal
200Debit Card Purchase (Canadian)Canadian Debit.Purchase
201Debit Card Return (Canadian)Canadian Debit.Return
298Debit Void (Canadian)Canadian Debit.Void
299Debit Reversal (Canadian)Canadian Debit.Reversal
300ECS Purchase w/ConversionECS.Purchase with Conversion
301ECS Purchase w/VerificationECS.Purchase with Verification
302ECS Purchase w/GuaranteeECS.Purchase with Guarantee
397ECS EchoECS.Echo
398ECS VoidECS.Void
399ECS ReversalECS.Reversal
400Gift Card ActivationGift Card.Activation
401Gift Card Sale / RedemptionGift Card.Redemption
402Gift Card Credit / ReturnGift Card.Credit
403Gift Card Replenishment / ReloadGift Card.Reload
404Gift Card Balance InquiryGift Card.Balance Inquiry
405Gift Card “Card Refund”Gift Card.Refund
407Pre-AuthorizationGift Card.Pre-Auth
408Post AuthorizationGift Card.Post-Auth
420Add Loyalty PointsGift Card.Add Loyalty Points
421Redeem Loyalty PointsGift Card.Redeem Loyalty Points
422Loyalty EnrollmentGift Card.Loyalty Enrollment
423Loyalty Balance InquiryGift Card.Loyalty Balance Inquiry
424Loyalty ReturnGift Card.Loyalty Return
425Loyalty Lead InquiryGift Card.Loyalty Lead Inquiry
426Loyalty Member InquiryGift Card.Loyalty Member Inquiry
493Loyalty Current Batch InquiryGift Card.Loyalty Current Batch Balance
494Loyalty Last Settled Batch InquiryGift Card.Loyalty Previous Batch Balance
495Gift Card Batch Close OutGift Card.Batch Close Out
496Gift Card Current Batch InquiryGift Card.Current Batch Balance
497Gift Card Last Settled Batch InquiryGift Card.Previous Batch Balance
498Gift Card / Loyalty VoidGift Card.Void
499Gift Card / Loyalty ReversalGift Card.Reversal
800DCC Rate RequestMisc.DCC Rate Update
801BSFS Credit ApplicationMisc.Bridgestone Instant Credit
803Key Exchange (EMV)Misc.EMV Key Exchange
804Cash or Cash-equivalent Purchase TransactionMisc.IVU Loto Cash Purchase
805Cash or Cash-equivalent Refund TransactionMisc.IVU Loto Cash Refund
806Cash or Cash-equivalent Void TransactionMisc.IVU Loto Cash Void
807Cash or Cash-equivalent Reversal TransactionMisc.IVU Loto Cash Reversal
808POS Logistics MessageMisc.POS Logistics
810Get Token RequestMisc.Get Token
811Transaction EligibilityMisc.Transaction Eligibility
900Balance Header (HB only)Batch.Balance
910Tip Header (HB Restaurant Header)Batch.TIP Header
911Tip Detail (HB Restaurant Tips)Batch.TIP Detail
919Tip Trailer Record (HB Restaurant Footer)Batch.TIP Trailer
920Detail Header (TB Settlement Header)Batch.Detail Header
921Detail Record (TB Detail)Batch.Detail
929Detail Trailer Record (TB Settlement Footer)Batch.Detail Trailer
997Last Settled InquiryBatch.Previous Balance
998Current Batch Inquiry (Host-Based only)Batch.Current Balance
999Delete/Purge Batch (Host-Based only)Batch.Purge