CardPosDetails

Transaction details specific to the point of sale (POS).

JSON representation
{
  "terminalIdentifier": string,
  "cardholderPresence": enum (CardholderPresence),
  "cardPresence": enum (CardPresence),
  "panEntryMode": enum (PanEntryMode),
  "terminalAttendance": enum (TerminalAttendance),
  "posCapabilities": {
    object (PosCapabilities)
  },
  "cardFormFactor": enum (CardFormFactor)
}
Fields
terminalIdentifier

string

REQUIRED: Terminal identifier (i.e., "TID").

cardholderPresence

enum (CardholderPresence)

REQUIRED: Description of cardholder presence.

cardPresence

enum (CardPresence)

REQUIRED: Description of card presence.

panEntryMode

enum (PanEntryMode)

REQUIRED: Description of PAN entry mode.

terminalAttendance

enum (TerminalAttendance)

REQUIRED: Description of terminal attendance.

posCapabilities

object (PosCapabilities)

REQUIRED: Details about the capabilities of this POS.

cardFormFactor

enum (CardFormFactor)

REQUIRED: The card form factor or device type used in the payment. Also known as the "payment initiation channel."

CardholderPresence

The various states of cardholder presence.

Enums
CARDHOLDER_PRESENCE_UNSPECIFIED DO NOT USE
CARDHOLDER_PRESENT The cardholder was present for the transaction.
CARDHOLDER_NOT_PRESENT_NO_DETAILS The cardholder was not present for the transaction, without further details about why.
CARDHOLDER_NOT_PRESENT_MAIL_FAX_OR_PHONE The cardholder was not present for the transaction. This was a mail, fax, or phone purchase.
CARDHOLDER_NOT_PRESENT_ECOMMERCE The cardholder was not present for the transaction. This was an online purchase.
CARDHOLDER_NOT_PRESENT_RECURRING_PAYMENT The cardholder was not present for the transaction. This was a recurring payment.
CARDHOLDER_NOT_PRESENT_PRE_AUTHORIZED The cardholder was not present for the transaction. This was a preauthorized payment.

CardPresence

The various states of card presence.

Enums
CARD_PRESENCE_UNSPECIFIED DO NOT USE
CARD_PRESENT This is a "card present" transaction.
CARD_NOT_PRESENT This is a "card not present" transaction.

PanEntryMode

The various PAN entry modes.

Enums
PAN_ENTRY_MODE_UNSPECIFIED DO NOT USE
PAN_ENTRY_MODE_NOT_KNOWN The PAN entry mode was not reported.
MANUAL_ENTRY PAN entered by hand.
MANUAL_KEY_PAD_ENTRY PAN entered by hand using a keypad.
MAGNETIC_STRIPE PAN entered by magnetic stripe.
BAR_CODE PAN entered by bar code.
OCR PAN read using Optical Character Recognition.
CHIP PAN entered by chip.
CHIP_FALLBACK_TO_MANUAL A Chip-capable terminal failed to process the chip data. Instead, the PAN was manually entered.
CHIP_FALLBACK_TO_MAGNETIC_STRIPE A Chip-capable terminal failed to process the chip data. Instead, the PAN was entered using magnetic stripe.
CONTACTLESS_MAGNETIC_STRIPE PAN entered by contactless payment containing magnetic stripe data.
CONTACTLESS_EMV PAN entered by contactless payment, with full EMV data.
CARD_ON_FILE The card was previously on file with the merchant.

TerminalAttendance

The various states of terminate attendance.

Enums
TERMINAL_ATTENDANCE_UNSPECIFIED DO NOT USE
TERMINAL_ATTENDED The terminal was attended for the transaction.
TERMINAL_UNATTENDED The terminal was unattended for the transaction.
NO_TERMINAL_USED No terminal was used.

PosCapabilities

Details about the capabilities of this POS.

JSON representation
{
  "pinInputCapability": enum (PinInputCapability),
  "partialApprovalCapability": enum (PartialApprovalCapability),

  // Union field pan_input_capability can be only one of the following:
  "noDetails": {
    object (Empty)
  },
  "noTerminalUsed": {
    object (Empty)
  },
  "supportedPanEntryModes": {
    object (PanEntryModeList)
  }
  // End of list of possible types for union field pan_input_capability.
}
Fields
pinInputCapability

enum (PinInputCapability)

REQUIRED: The POS' support for PIN entry.

partialApprovalCapability

enum (PartialApprovalCapability)

REQUIRED: The POS' support for partial approvals, i.e., when the customer does not have the full funds available, approving for the funds that they do have available so the customer can pay the balance with another form of payment.

Union field pan_input_capability. The various ways of describing PAN input capability. pan_input_capability can be only one of the following:
noDetails

object (Empty)

We have no details about the PAN input capabilities.

noTerminalUsed

object (Empty)

No terminal was used (i.e., no supported PAN entry modes).

supportedPanEntryModes

object (PanEntryModeList)

A list of supported PAN entry modes.

PanEntryModeList

A list of PAN entry modes.

JSON representation
{
  "panEntryModes": [
    enum (PanEntryMode)
  ]
}
Fields
panEntryModes[]

enum (PanEntryMode)

The PAN entry modes.

PinInputCapability

The various PIN input capabilities.

Enums
PIN_INPUT_CAPABILITY_UNSPECIFIED DO NOT USE
NO_PIN_INPUT_DETAILS We don't know anything about the PIN capability.
HAS_PIN_ENTRY_CAPABILITY The POS has PIN entry capability.
NO_PIN_ENTRY_CAPABILITY The POS has no PIN entry capability.
INOPERATIVE_PIN_PAD The POS has PIN entry capability, but the PIN pad is inoperative.

PartialApprovalCapability

The various partial approval capabilities.

Enums
PARTIAL_APPROVAL_CAPABILITY_UNSPECIFIED DO NOT USE
NO_PARTIAL_APPROVAL_DETAILS We don't know anything about the partial approval capability.
PARTIAL_APPROVAL_CAPABLE The POS has partial approval capability.
PARTIAL_APPROVAL_INCAPABLE The POS has no partial approval capability.

CardFormFactor

The various card form factors.

Enums
CARD_FORM_FACTOR_UNSPECIFIED DO NOT USE
CARD A traditional card.
PHONE A mobile phone.
TABLET_OR_E_READER A tablet computer or e-reader.
WATCH_OR_WRISTBAND A watch or wristband, including fitness devices and dispoable wrist straps, etc.
STICKER A payment sticker.
PC_OR_LAPTOP A PC or laptop computer.
DEVICE_PERIPHERAL A device peripheral such as a mobile phone case.
TAG A key fop or mobile tag.
JEWELERY A ring, bracelet, necklace, or cufflinks.
FASHION_ACCESSORY A handbag, bag charm, or glasses.
GARMENT A dress, shirt, pants or other clothing.
DOMESTIC_APPLIANCE A refrigerator or washing machine.
VEHICLE A vehicle, or a device attached to a vehicle.
MEDIA_OR_GAMING_DEVICE A dedicated gaming device, a TV, or other set-top media box.