POS Data Code
The Point of Sale (POS) Data Code and POS Entry Mode (PEM) are required input values to issuers or some Third Party Processors (TPPs) based on Card Association requirements. The data informs the issuers about the POS environment and capabilities.
Due to enhanced terminal configurations and payment security schemes such as EMV and digital payments (e.g. consumer digital tokens / wallets), Elavon requires this data to be sent in all inbound Authorization Only (01), Sale (02) and Refund (09) transactions for credit and debit transactions for all industries. If you are using Elavon’s Simplify product, this field is being set properly for you.
For Magstripe Read transactions processing as store and forwarded transactions via the stand-in response supplied by Simplify to the POS/PMS: the POS/PMS should capture the POS Data Code “as is” from the stand-in response from Simplify and forward them the same directly to Fusebox, or can be processed through Simplify when connectivity has been restored.
This page details the valid components for field 0047 and values for field 0054.
API Field 0047
POS Data Code field (0047) is alphanumeric with a maximum size of 29. It contains the POS Data Code values described in the following tables which Fusebox translates for the TPPs and Card Associations. Each Association has different codes representing the same or similar values and these values are in different orders. Below is Elavon's generic set of values for each subfield. The TPP and Card Association translation is performed in the Fusebox TPP Interface layer.
There are currently 14 defined components to the POS Data Code, with the 15th being “Reserved for Future Use” (RFU). Each character represents a positional value. Each character element is delimited with the delimiter “;”, except for the last entry.
In some cases, the card brands do not have a full listing of all capabilities; they want you to use the highest capability you support and assume if you support that, then you support lower capabilities as well.
|POS Data Code and Description||Field Value||Usage|
|47.1 - POS Device Capability Indicator||Card-entry capability static throughout the certification. Primary consideration: use the highest capability and closest match. The following list is in highest capability order; stop at the first valid case as you go down the list.|
|EMV Card Present Capabilities|
|ICC Contactless||M||If the terminal is capable of ICC contactless as its highest capability. This inherits lesser capabilities.|
|ICC Contact and Contactless capability||H||If the terminal is capable of ICC contact and non ICC contactless mag.|
|ICC Contact, Magnetic stripe, and Keyed capability||C||If the terminal is capable of ICC contact, Mag, keyed.|
|ICC Contact and Magnetic stripe capability||D||If the terminal is capable of ICC contact, Mag.|
|ICC Contact and key entry capability||E||If the terminal is capable of ICC contact, keyed.|
|ICC Contact||5||If the terminal is capable of ICC contact.|
|Non EMV Card Present Capabilities|
|Magnetic via contactless||A||If the terminal is capable of Contactless Mag.|
|Magnetic stripe reader and key entry capability||B||If the terminal is capable of Mag and Keyed.|
|Magnetic stripe reader capability||2||If the terminal is capable of Mag only.|
|Magnetic stripe signature capture||X||If the terminal is capable of Mag and signature capture.|
|Keyed Entry only capability||6||If the terminal/POS is Key entry only, (i.e. PC with a keyboard).|
|MOTO/ECOM Terminal/POS Capabilities|
|Secure Electronic Transaction (SET) with certificate||I||POS-terminal that is capable of 3D secure eCommerce transactions.|
|Channel-encrypted Electronic Commerce Transaction (SSL)||K||Used for POS-terminal that is capable of standard e-Commerce, non-3D secure transactions.|
|Manual entered account, no terminal||1||Used for POS-terminal that is capable of for Mail Order Telephone.|
|47.2 - Cardholder Authentication Capability||This value normally does not change for the duration of the payment application certification. With a terminal, it reflects hardware capability.|
|No electronic authentication capability||0||Terminal is NOT PIN capable.|
|PIN authentication capability||1||Terminal is PIN capable.|
|Other||6||This value is not commonly used and mainly exists for special or legacy support.|
|47.3 - Terminal Card Capture Capability||Capability is usually static for the life of the certification. Can the card be Retained?|
|No capture capability<||0||If the terminal is unattended and is not able to mechanically retain a card.|
|Card capture capability||1||If the attendant or terminal are able to retain a card.|
|47.4 - Terminal Operating / Location Environment||Location of the Terminal.|
|No terminal used||0||Voice auth or VRU uses.|
|Terminal is On Merchant premises||1||Standard choice for Retail, Restaurant, Lodging, or Travel.|
|Terminal is On Card Holder premises||5||Unattended terminal, on card holder premises (at Home).|
|Terminal is On Merchant premise; mPOS (Mobile POS)||P||Used to identify a Mobile POS terminal.|
|Terminal is Off Merchant premises||3||For terminals used Off of the Merchant premise. (Vending).|
|Terminal is Off Card Holder premises||6||Unattended terminal, off card holder premises (not at Home).|
|Terminal is Off Merchant premises; mPOS (Mobile POS)||M||Used to identify a Mobile POS terminal used Off Merchants premises. (Portable device, trade shows, service calls, taxis, etc.).|
|Card Holder Device: PC, PDA, Smartphone|
|Cardholder owned device, off Merchant Premise||Q||eCommerce - In-app off Merchant Premise (Anywhere other than Merchants premise).|
|Cardholder owned device, on Merchant Premise||R||eCommerce - In-app on the Merchant Premise.|
|47.5 - Cardholder Present Indicator||Indicate if the card holder was present for the immediate transaction event.|
|Cardholder present||0||If the cardholder was present during the transaction.|
|Cardholder Not Present|
|Cardholder not present (reason not specified)||1||If the Card holder was not present during the transaction and the reason was unspecified.|
|Cardholder not present, mail order||2||Used with MOTO: mail order use cases.|
|Cardholder not present, telephone order||3||Used with TO: phone transaction use cases.|
|Cardholder not present, Industry Practice||4||Used in Lodging and Auto Rental Industries where the card holder is not present by Industry Practice.
Examples: Lodging Incremental Authorization, Delayed Charge, and No Show transactions.
|Cardholder not present, electronic transaction||5||Used for e-Commerce.|
|Cardholder not present, Standing Authorization - Unscheduled||A||Used in MOTO and Ecommerce for standing authorizations that are not performed on a scheduled basis.
Examples: Unscheduled MOTO and Ecommerce Transactions.
|Cardholder not present, Standing Authorization – Recurring or Installment||9||Used in MOTO and Ecommerce for standing authorizations that are performed on a scheduled basis.
Examples: MOTO and Ecommerce Installment/Recurring Transactions.
|47.6 - Card Present Indicator||Indicates whether the card was present for the transaction event.|
|Card not present||0||Card was not physically available.|
|Card is present||1||Card was physically available.|
|Contactless (NFC Chip / NFC mag)||X||Used for NFC Mag or chip presented card data, includes consumer device sourced NFC data like Token or ApplePay.|
|Digital Wallet In-app||Z||Future-use for card data presented via Digital wallet in eCommerce transactions (may include remote chip events over eCommerce).|
|47.7 - Card Data Input Mode Indicator||Identifies how card data was sent.|
|EMV Card present items|
|ICC Contactless||M||Contactless M/Chip or Visa Smart Card read.|
|ICC Contact||5||Integrated circuit card read.|
|Technical fall back to Contact ICC||N||Fall back from NFC ICC capable card to Contact Chip read.|
|Technical fallback to Mag swipe||9||Fall back from ICC capable card to Mag-swipe.|
|Technical fall back to Keyed||V||Fall back from ICC capable card reader to key entry.|
|Empty candidate list fallback||P||Fall back from ICC to Mag Swipe when EMV Candidate list has no match.|
|Non EMV Card present|
|Contactless Magnetic stripe||A||Contactless magnetic stripe read.|
|Magnetic Stripe read||2||Use when classic physical contact Mag swipe read (MSR event).|
|Magnetic stripe with signature capture||X||Used when the terminal supports digital signature capture and the transaction is Mag swipe with digital signature capture.|
|Key Entry||6||Manual/Key Entry at the terminal.|
|MOTO / e-Commerce Card not present capabilities|
|Manual, no terminal||1||No terminal / Manual entry of the card data. Common for phone VRU, or Mail order.|
|eCommerce: R – Pan Via Remote Chip||R||Future use with remote chip transactions.|
|Non-secure Electronic Commerce Transaction||G||Used for card on file charge events: Electronic commerce, non-secure, non-channel encrypted, and without cardholder certificate.|
|Channel-encrypted Electronic Commerce Transaction (SSL)||K||eCommerce transaction over channel-encrypted (SSL) link (non-3D secure)|
|Secure Electronic Transaction (SET) with certificate||I||eCommerce transaction over channel-encrypted (SSL) link (3D secure with cardholder certificate).|
|Secure Electronic Transaction (SET) with no certificate||J||eCommerce transaction over channel-encrypted (SSL) link (3D secure with Merchant only certificate).|
|47.8 - Card Data Authentication Mode Indicator||Authentication method used for the transaction event. Recommend using a configuration parameter to set default value for unknown and non-PIN transactions.|
|Card Data Not authenticated||0||Used when there is no Authentication of Card data. Example, unattended and without PIN.|
|PIN||1||Used when this is a PIN based transaction.|
|Attendant verification of Card signature||5||Traditionally used in card-present environment where the signature is verified by the attendant.|
|Attendant verification of other ID||6||Used when the attendant verifies ID using some other form of card identification.|
|Electronic ticket environment||S||RFU - Reserved for future use in electronic ticket vending.|
|47.9 - Cardholder Authentication Mode Indicator||Method used to verify the cardholder for this transaction. Recommend using a configuration parameter to set default value for unknown and non-PIN transactions.|
|Card Holder Not authenticated (Failed or PIN bypass)||0||Used when the Terminal supports and initiates a PIN bypass to complete the transaction.|
|Card holder PIN authenticated offline||1||Used when verification PIN is done offline between the Terminal PIN entry and card ICC.|
|Card holder PIN authenticated online||3||Used when verification PIN is done online between the Terminal PIN entry and the processing network. Common for swiped debit PIN.|
|Card holder authenticated by merchant (signature)||4||Used when attendant verifies the cardholder signature. Default for attended terminals when PIN not used.|
|Other||5||This value is not commonly used and mainly exists for legacy support. Default for unattended terminals when PIN not used or new authentication techniques, such as biometrics are used.|
|47.10 - Card Data Output Capability Indicator||Used to identify the terminal's capability to update a card.|
|None||1||Typical for NON-EMV devices, or devices that cannot update a card, like NFC-only readers.|
|Integrated Circuit Card update capability||3||Used for Any EMV device capable of updating the Chip script data.|
|47.11 - Terminal Data Output Capability Indicator||Used to identify the terminal's output capability.|
|No terminal printing or display ability||1||Common for Mail or phone order systems.|
|Terminal Printing ability||2||Common for swipe/tap only terminals.|
|Terminal Display ability||3||Common for interactive terminals that can display amounts and prompts for things like PIN. Also eCommerce websites.|
|Terminal Printing and Display ability||4||Common for interactive terminals that can display amounts and prompts for things like PIN. Also print receipts.|
|47.12 - PIN Capture Capability Indicator||Used to identify the Terminals PIN Capture Capability.|
|No PIN capture capability||0||Use when the Terminal has no PIN pad.|
|Device PIN capture capability unknown||1||This value is not commonly used and mainly exists for special/legacy support.|
|4 to 12 characters: [4, 5, 6, 7, 8, 9, A, B, C]||4-C||Use one of these values (4 through C) when the Terminal is capable of accepting PIN entries. The value used will represent the maximum length of PIN the terminal is capable of. (e.g. 4 is four bytes, C is 12 bytes).|
|47.13 - POS Device Attendance Indicator||Used to identify if the Terminal is attended or unattended.|
|Attended Terminal||0||Most common option, terminal is attended by an employee.|
|Unattended Terminal||1||Terminal is being certified for unattended use. (e.g. Vending machine or kiosk).|
|No terminal||2||This option is common for MOTO and e-Commerce interfaces; used in Back office card on file use, standing auth use.|
|47.14 - POS Device Terminal Type||Used to identify the type of terminal.|
|Merchant Register/Terminal||4||Most common option for normal terminal certifications.|
|Transponder (CAT)||6||Transponder - Card activated terminal, Kiosk as an example.|
|Unknown/Unspecified||0||Legacy use, there are no expectation to see this option used in a modern certification.|
|Cardholder-owned device (PC, PDA, SmartPhone)||5||RFU-Reserved for future use in in-app/eCommerce.|
|mPOS device (Merchant Mobile POS Device )||9||RFU-Reserved for future use in Merchant Mobile POS.|
Secondary transactions also require POS Data Code, such as Incremental Authorizations, Voids (Type 11) and Reversals (Types 76, 61). When the incremental authorization request is generated, the POS data code from the original authorization request should be used with modifications to sub-fields: 47.5 – 47.9 (these fields track entry mode factors but not capabilities). Card Not Present transactions need to modify the dynamic card / cardholder present / not present fields when a token is presented in place of the credit card.
If the POS Entry Mode (Field 54) changes from swipe or insert of credit card for EMV, then POS Data Code sub-fields 47.5 to 47.9 will also need to reflect that the card and cardholder are not present.
API Field 0054 - POS Entry Mode
|04||OCR Code Read|
|05||Integated circuit card read;CVV data reliable (smart card)|
|07||Contactless; M/Chip or Visa Smart Card read|
|79||Chip capable; manual PAN read (used for EMV fall back to manually entered)|
|80||Chip Card capable; unaltered track data read (used for EMV fall back to swipe)|
|82||Contactless Mobile Commerce device|
|85||Internet (not an ISO value)|
CVV/CVC certified, unaltered Track Data (1 or 2) included in Authorization Request. Required to participate in PS/2000 or CPS/200
|91||Contactless magnetic stripe read|
|95||Integrated circuit card read; CVV data unreliable|
Each merchant terminal defines its MID and TID. Each transaction requires a consistent EMV capability. Each card brand may have unique requirments that will be accounted for whe the POS Data Code is accurately presented when processing the transaction.