EMV Integration Guide
Elavon requires merchant systems to provide terminal parameters and CAPK reports when requested.
Reporting Best Practices
If the merchant system supports PIN bypass then Elavon recommends to report corresponding information in the EMV statistic report for PIN entry errors and exceptions.
Elavon recommends merchant system to generate terminal configuration report from the point of sale.
Elavon recommends POS entry mode data to be extracted in the reports generated by the merchant.
The following reports are optional and may be required by Elavon upon request:
- EMV Statistic Report
- Chip Transaction Report
- POS Entry Mode Report
- EMV Offline Declined Transaction Report
- EMV Key Load Report
- EMV Parameter Report
The EMV Statistic report provides details on the number of chip transactions executed at the point of sale, number of chip read failures, pin entry errors, offline declines and technical fallbacks since the last batch close. The results should refresh with a successful settlement at the host. These details are important for Elavon in case of disputes, chargebacks, and any investigation purposes. Below are the details to be included in the report:
Number of chip card read failures
Number of PIN entry errors
Number of offline funds declined
Number of technical fallbacks
The Chip transaction report provides details on the number of chip transactions executed at the point of sale. This information is required by Elavon for analysis and investigation purposes.
Point of Sale Entry mode is an important factor to know in order to determine the transaction conditions with chip and non-chip transactions. Elavon requires merchants to provide this information when requested.
From an operational perspective, Elavon requires a report on the EMV offline declined transactions at the point of sale. The terminal application parameters and the data from the last offline declined transaction must be available on request. This may include DE 55 (a block containing multiple EMV tags in TLV format), Terminal and Issuer Action Codes, truncated PAN as printed on the receipt, and Application PAN Sequence Number, if present.
Merchants shall report this in the below format.
|EMV Offline Declined Transaction Report|
|Masked PAN||PAN: XXXXXXXXXXXX4564|
|PAN Sequence #||PAN SEQ: 01|
|Issuer Action Codes||
IAC Denial: 0010000000
IAC Online: F040009800
IAC Default: F040008800
|Terminal Action Codes||
TAC Denial: 0010000000
TAC Online: D84004F800
TAC Default: D84000A800
The EMV Key load report provides information on updates that were made by merchants and third party processors and the keys loaded on the point of sale devices. The merchants must be able to provide this report if requested by Elavon. The format of this report is mentioned below.
|EMV Key Load Report Header|
|Date||Date of last successful key load|
|Time||Time of last successful key load|
|TID||Terminal Identification – unique terminal identifier|
|MID||Merchant Identification – unique merchant identifier|
|Title||EMV Public Key Load Report|
|EMV Key Load Report Repeated Fields Per Key (this will be repeated 6 times for 6 different EMV public keys as per card associations)|
|RID||First 10 characters of the AID, Application Identifier (EMV Tag 9F06). Format is either ASCII or hex, confirm with your TPP interface guide.|
|Key Index||Identifies the Certificate Authority’s Public Key in conjunction with the RID (EMV Tag 9F22). Format is either ASCII or hex, confirm with your TPP interface guide.|
|Key Modulus||Value of the modulus part of the Certificate Authority Public Key. Format is either ASCII or hex, confirm with your TPP interface guide.|
|Key Exponent||Value of the exponent part of the Certificate Authority Public Key. Format is either ASCII or hex, confirm with your TPP interface guide.|
|EMV Key Load Report Footer|
|Footer||END OF REPORT|
EMV Parameter report details the configuration settings on the point of sale devices.
|EMV Parameter Report Header|
|Title||EMV PARAMETER REPORT|
Terminal Identification – unique terminal identifier.
Format ex: Term ID: 001
Merchant Identification – unique merchant identifier.
Format ex: Merchant ID: 999999999999
Time of last successful parameter load.
Format ex: MM/DD/YYYY: HH:MM:SS
|EMV Parameter Report Repeated Fields Per Brand strong>|
Payment Brand Parameters
Format ex: Visa
|EMV Parameter Report Data strong>|
|Application ID 1-6||
Application ID 1: A0000000031010
Application ID 2:
Application ID 3:
Application ID 4:
Application ID 5:
Application ID 6:
|Floor Limit||Chip Offline Floor Limit: 0.00|
|Fallback Ind.||Fallback Indicator: Y/N|
|Terminal Action Codes||
Terminal Action Code Denial: 0010000000
Terminal Action Code Online: D84004F800
Terminal Action Code Default: D84000A800