Card-Present Fields

The fields in the following table are available in the Transaction Request only for card-present transactions.

Table 1. Card-Present Field Definitions for the Transaction Request Report
Field Name Definition Data Type and Field Length
Device.DeviceID Value created by the client software that uniquely identifies the POS device. This value is provided by the client software that is installed on the POS terminal.

This value is not sent to the processor but is used for reporting purposes.

This field is supported only on American Express Direct and SIX.

 String (32)
PaymentData.Acquirer
MerchantNumber Identifier that was assigned to you by your acquirer. This value must be printed on the receipt.

This field is supported only on American Express Direct and SIX.

 String (15)
PaymentData.CardPresent Indicates whether the card is present at the time of the transaction. Possible values:
  • N: Card is not present.
  • Y: Card is present.
 String (1)
PaymentData.Card
VerificationMethod Method that was used to verify the cardholder's identity. Possible values:
  • 0: No verification
  • 1: Signature
  • 2: PIN

    This field is supported only on American Express Direct, OmniPay Direct, and SIX.

 Integer (1)
PaymentData.EMVRequestFallback Indicates that a fallback method was used to enter credit card information into the POS terminal. When a technical problem prevents a successful exchange of information between a chip card and a chip-capable terminal:

Swipe the card or key the credit card information into the POS terminal.

Use the pos_entryMode field to indicate whether the information was swiped or keyed.

Possible values:

  • true: Fallback method was used.
  • false (default): Fallback method was not used.

    This field is supported only on American Express Direct, Chase Paymentech Solutions, GPN, OmniPay Direct, and SIX.

 String (5)
PaymentData.Issuer
ResponseCode Additional authorization code that must be printed on the receipt when returned by the processor. This value is generated by the processor and is returned only for a successful transaction.

This field is supported only on SIX.

 Varchar2 (15)
PaymentData.PinType Method that was used to verify the cardholder's identity. Possible values:
  • 0: No verification
  • 1: Signature
  • 2: PIN

    This field is supported only on American Express Direct, OmniPay Direct, and SIX.

 Integer (1)
PaymentData.POSCat
Level Type of cardholder-activated terminal. Possible values:
  • 1: Automated dispensing machine
  • 2: Self-service terminal
  • 3: Limited amount terminal
  • 4: In-flight commerce (IFC) terminal
  • 5: Radio frequency device
  • 6: Mobile acceptance terminal
  • 7: Electronic cash register
  • 8: E-commerce device at your location
  • 9: Terminal or cash register that uses a dial-up connection to the transaction processing network

    Chase Paymentech Solutions

    Only values 1, 2, and 3 are supported.

    FDC Nashville Global

    Only values 7, 8, and 9 are supported.

    GPN

    Only values 6, 7, 8, and 9 are supported.

    TSYS Acquiring Solutions

    Only value 6 is supported.

 Nonnegative integer (1)
PaymentData.POSEntry
Mode Method of entering credit card information into the POS terminal. Possible values:
  • contact: Read from direct contact with chip card.
  • contactless: Read from a contactless interface using chip data.
  • keyed: Manually keyed into POS terminal. This value is not supported on OmniPay Direct or SIX.
  • msd: Read from a contactless interface using magnetic stripe data (MSD). This value is not supported on OmniPay Direct.
  • swiped: Read from credit card magnetic stripe.

    The contact, contactless, and msd values are supported only for Europay, Mastercard, and Visa (EMV) transactions.

 String (11)
PaymentData.POS
Environment Operating environment. Possible values:
  • 0: No terminal used, or unknown environment.
  • 1: On merchant premises, attended.
  • 2: On merchant premises, unattended, or cardholder terminal. Examples: oil, kiosks, self-checkout, home computer, mobile telephone, personal digital assistant (PDA). Cardholder terminal is supported only for Mastercard transactions.
  • 3: Off merchant premises, attended. Examples: portable POS devices at trade shows, at service calls, or in taxis.
  • 4: Off merchant premises, unattended, or cardholder terminal. Examples: vending machines, home computer, mobile telephone, PDA. Cardholder terminal is supported only for Mastercard transactions.
  • 5: On premises of cardholder, unattended.
  • 9: Unknown delivery mode.
  • S: Electronic delivery of product. Examples: music, software, or eTickets that are downloaded over the Internet.
  • T: Physical delivery of product. Examples: music or software that is delivered by mail or by courier.

    For Mastercard transactions, the only valid values are 2 and 4.

 String (1)
PaymentData.Routing
NetworkType — —
PaymentData.StoreAnd
ForwardIndicator When connectivity is unavailable, the client software that is installed on the POS terminal can store a transaction in its memory and send it for authorization when connectivity is restored. This value is provided by the client software that is installed on the POS terminal.

This value is not sent to the processor but is used for reporting purposes.

Possible values:

  • Y (SCMP) / true (SO API)
  • N (SCMP) / false (SO API)

    This field is supported only on American Express Direct and SIX.

 String (1) (SCMP)

String (5) (SO API)
PaymentData.TerminalID
Alternate Identifier for an alternate terminal at your retail location. You define the value for this field.

This field is supported only for Mastercard transactions on FDC Nashville Global. Use the pos_terminalID field to identify the main terminal at your retail location. If your retail location has multiple terminals, use this pos_terminalIDAlternate field to identify the terminal used for the transaction.

This value is neither verified nor modified before it is passed to the processor.

 String (8)
Request.PartnerOriginal
TransactionID Value that links the previous transaction to the current follow-on request. This value is assigned by the client software that is installed on the POS terminal, which makes it available to the terminal’s software and to Cybersource. Therefore, you can use this value to reconcile transactions between Cybersource and the terminal’s software.

This value is not sent to the processor but is used for reporting purposes.

This field is supported only on American Express Direct and SIX.

 String (32)
Requst.PartnerSDKVersion Version of the software installed on the POS terminal. This value is provided by the client software that is installed on the POS terminal.

This value is not sent to the processor but is used for reporting purposes.

This field is supported only on American Express Direct and SIX.

 String (32)
Request.TerminalSerial
Number Terminal serial number assigned by the hardware manufacturer. This value is provided by the client software that is installed on the POS terminal.

This value is not sent to the processor but is used for reporting purposes.

This field is supported only on American Express Direct and SIX.

 String (32)