Card-Present Fields

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.

PaymentData.Acquirer
MerchantNumber

Identifier that was assigned to you by your acquirer. This value must be printed on the receipt.

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.

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.

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:

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.

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.

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.

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.

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.

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
.

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.

Y
(SCMP) /
true
(SO API)
N
(SCMP) /
false
(SO API)
This field is supported only on American Express Direct and SIX.

PaymentData.TerminalID
Alternate

Identifier for an alternate terminal at your retail location. You define the value for this field.

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.

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.

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.