API Overview

Card Present Connect | Retail Integration Guide
- Recent Revisions to This Document
- VISA Platform Connect: Specifications and Conditions for Resellers/Partners

Introduction to Card Present Connect | Retail
- Enabling the Card Present Connect Platform
- Card-Present Transaction Types
- Card-Present Transaction Risk Control Requirements

Retail Payment Services Using EMV and Card Data
- Retail EMV and Card Data
- Authorization with Contact EMV and Online PIN
- Authorization with Contact EMV and Offline PIN
- Authorization with Contactless EMV and Online PIN
- Authorization with Magnetic Stripe Swipe
- Authorizations with Hand-Keyed Data
- Authorization for Cash Advance with Credit Card
- Authorization Reversal
- Captures
- Capture for Contact EMV Authorization
- Stand-Alone Credit
- Voids for Capture or Credit
- Timeout Void for a Capture, Sale, Refund, or Credit

Introduction to PIN Debit Processing
- PIN Debit Integration
- PIN Debit Transactions
- PIN Debit Network Routing
- PIN Debit Processing Versus Credit Card Processing
- PIN Debit Reconciliation
- Track Data
- Terminal IDs
- Electronic Benefit Transfer

PIN Debit Optional Features
- Cash Back
- Merchant Descriptors
- Merchant-Inititated Reversals
- Partial Authorizations
- Payment Network Tokens
- Surcharge Fees

PIN Debit Services
- PIN Debit Purchase with Contactless EMV
- PIN Debit Purchase with Contact EMV
- PIN Debit Purchase with Contactless EMV and Cash Back
- PIN Debit Purchase with Swiped Track Data and Merchant Descriptors
- PIN Debit Partial Authorization with Swiped Track Data
- PIN Debit Purchase with Contactless EMV and a Surcharge Fee
- PIN Debit Balance Inquiry with Contactless EMV
- PIN Debit Balance Inquiry with Swiped Track Data
- PIN Debit Credit with Swiped Track Data
- PIN Debit Credit with Contactless EMV
- Reverse a PIN Debit Purchase or Credit
- PIN Debit EBT Purchase with a SNAP Voucher
- PIN Debit EBT Purchase with SNAP Account Swiped Track Data
- PIN Debit EBT Purchase with SNAP Account Swiped Track Data and Balance Inquiry
- PIN Debit EBT Purchase with a Cash Benefits Account Swiped Track Data and Cash Back
- Credit a PIN Debit EBT Purchase with SNAP Account
- Reverse a PIN Debit EBT Purchase

Mobile Point-of-Sale Payment Services
- Supported Mobile Point-of-Sale Solutions
- Authorization with an mPOS Using an Embedded Reader and Software PIN Entry
- Authorization with an mPOS Using an Embedded Reader and Software with No PIN Entry
- Authorization with an mPOS Using an External, Contact-Only Reader with No PIN Entry
- Authorization with an mPOS Using an External Reader and Hardware PIN Entry
- Authorization with an mPOS Using an External Reader and Software PIN Entry
- Sale with an mPOS Using an Embedded Reader and Software PIN Entry
- Sale with an mPOS Using an Embedded Reader and Software with No PIN Entry
- Sale with an mPOS Using an External, Contact-Only Reader with No PIN Entry
- Sale with an mPOS Using an External Reader and Hardware PIN Entry
- Sale with an mPOS Using an External Reader and Software PIN Entry

Dynamic Currency Conversion Payment Services
- Authorization with Dynamic Currency Conversion
- Capture with Dynamic Currency Conversion
- Sale with Dynamic Currency Conversion
- Stand-Alone Credit with Dynamic Currency Conversion

Retail Message-Level Validation Test Cases

Required Fields for a PIN Debit Purchase with Contact EMV

clientReferenceInformation.code
clientReferenceInformation.partner.thirdPartyCertificationNumber: Cybersource provides the value for this field.
clientReferenceInformation.transactionId
orderInformation.amountDetails.currency
orderInformation.amountDetails.totalAmount
paymentInformation.card.sourceAccountType: Set this field to
UA
.
paymentInformation.card.useAs: Leave this field blank.
paymentInformation.paymentType.name: Set this field to
CARD
.
paymentInformation.paymentType.subTypeName: Set this field to
DEBIT
.
pointOfSaleInformation.emv.cardSequenceNumber: Required only when the card has a sequence number configured on the EMV chip.
pointOfSaleInformation.emv.tags
pointOfSaleInformation.encryptedKeySerialNumber
pointOfSaleInformation.encryptedPin
pointOfSaleInformation.entryMode: Set this field to
contactless
.
pointOfSaleInformation.pinBlockEncodingFormat: Set this field to
1
.
pointOfSaleInformation.terminalCapability
pointOfSaleInformation.trackData
processingInformation.commerceIndicator: Set this field to
retail
.