API Overview

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

Mass Transit Transaction Workflows
- American Express Pay As You Go Workflow
- Mastercard Pay As You Go Workflow
- Visa Mobility and Transport Transaction Workflow
- Additional Workflows
  - Near Real-Time Workflow
  - Fare Calculation and Submission Workflow
  - Debt Recovery Workflows

Mass Transit Payment Services Using EMV and Card Data
- Transaction Types
- Required Fields for Authorizations with EMV Data
- American Express Authorization with EMV Data
  - Example: American Express Account Status Check Authorization with EMV Data
  - Example: American Express Delayed Online Authorization with EMV Data
- Mastercard Authorization with EMV Data
  - Example: Mastercard Authorization with EMV Data
- Visa Account Verification Request (AVR) with EMV Data
  - Example: Visa AVR Authorization with EMV Data
- Required Fields for Sales with EMV Data
- Visa Deferred Sale with EMV Data
  - Example: Visa Deferred Sale with EMV Data
- Required Fields for Authorization for Debt Recovery
- Tap-Initiated Authorization for Debt Recovery with EMV Data
  - Example: Tap-Initiated Authorization for Debt Recovery with EMV Data
- Merchant-Initiated Authorizations for Debt Recovery with Stored Card Data
  - Example: Merchant-Initiated Authorization for Debt Recovery with Stored Card Data
- Required Fields for Sales for Debt Recovery
- Tap-Initiated Sales for Debt Recovery with EMV Data
  - Example: Mastercard Tap-Initiated Sale for Debt Recovery with EMV Data Using the REST API
  - Example: Tap-Initiated Sale for Debt Recovery with EMV Data Using the REST API
- Merchant-Initiated Sales for Debt Recovery with Stored Card Data
  - Example: Merchant-Initiated Sale for Debt Recovery with Stored Card Data
- Required Fields for Stand-Alone Credits with Card Data
- Stand-Alone Credits with Card Data
  - Example: Stand-Alone Credit with Card Data

Mass Transit Payment Services Using TMS Tokens
- Mass Transit Mastercard Authorization with a Token
  - Required Fields for a Mastercard Authorization with a Token Using the REST API
  - Example: Performing a Mastercard Authorization with a Token Using the REST API
- Mass Transit Visa Account Verification Request (AVR) with a Token
  - Required Fields for a Visa AVR Authorization with a Transient Token Using the REST API
  - Example: Performing a Visa AVR Authorization with a Transient Token Using the REST API
- Mass Transit Visa Deferred Sale with a Token
  - Required Fields for a Visa Deferred Sale with a Token Using the REST API
  - Example: Performing a Visa Deferred Sale with a Token Using the REST API
- Mass Transit Authorizations for a Tap-Initiated Debt Recovery with a Token
  - Required Fields for a Tap-Initiated Authorization for Debt Recovery with a Token Using the REST API
  - Example: Performing a Tap-Initiated Authorization for Debt Recovery with a Token Using the REST API
- Mass Transit Merchant-Initiated Authorizations for Debt Recovery with a Token
  - Required Fields for a Merchant-Initiated Authorization for Debt Recovery with a Token Using the REST API
  - Example: Performing a Merchant-Initiated Authorization for Debt Recovery with a Token Using the REST API
- Mass Transit Tap-Initiated Sale for Debt Recovery with a Token
  - Required Fields for a Tap-Initiated Sale for Debt Recovery with a Token Using the REST API
  - Example: Performing a Tap-Initiated Sale for Debt Recovery with a Token Using the REST API
- Mass Transit Merchant-Initiated Sale for Debt Recovery with a Token
  - Required Fields for a Merchant-Initiated Sale for Debt Recovery with a Token Using the REST API
  - Example: Performing a Merchant-Initiated Sale for Debt Recovery with a Token Using the REST API
- Mass Transit Stand-Alone Credit with a Token
  - Required Fields for a Stand-Alone Credit with a Token Using the REST API
  - Example: Performing a Stand-Alone Credit with a Token Using the REST API

Mass Transit Follow-On Payment Services
- Required Fields for Mass Transit Captures
- Capture an Authorization
  - Example: Capture an Authorization
- Required Fields for Mass Transit Reversals
- Authorization Reversals
  - Example: Reversing a Mass Transit Authorization
- Timeout Reversal
  - Example: Timeout Reversal
- Required Field for Timeout Voids
- Timeout Void
  - Example: Timeout Void

Mass Transit Token Management Services
- Creating a Token
  - Required Fields for Creating a Token Using the REST API
  - Example: Create a Token Using the REST API
- Retrieving Transient Token Details
  - Example: Retrieve Transient Token Details Using the REST API
- Retrieving an Instrument Identifier Details
  - Example: Retrieving Instrument Identifier Details Using the REST API
- Retrieving Card Hash Details
  - Example: Retrieving Card Hash Details Using the REST API
- Retrieving Payment Instrument Details
  - Example: Retrieving Payment Instrument Details Using the REST API
- Deleting an Instrument Identifier
  - Example: Deleting an Instrument Identifier Using the REST API
- Deleting a Card Hash
  - Example: Deleting a Card Hash Using the REST API

Transit Test Cases

Mass Transit Validation and Certification

Work with your payment technology provider (PTP) to allocate time to complete the message-level validation (MLV) and EMV Level 3 certification with your mass transit fare processing system. You must pass MLV before beginning EMV Level 3 certification. You must complete validation and certification before your system can go live.

Message-Level Validation

Message-level validation (MLV) is a script-based field-level validation against Visa Acceptance Solutions specifications.

Your PTP uses amount-based test triggers to send transactions into a test environment and the Visa Certification Management System for decryption. The test results are XML or RESTful output, Business Center test transactions, and log prints.

Visa Acceptance Solutions validates the results with these activities:

Cross edit checks

Data element validation

Interchange compliance

Data mapping validation

Mass Transit Validation and Certification

EMV L3 Certification

This topic is an overview of the Level 3 accreditation with Visa Acceptance Solutions and Visa Platform Connect.

For details on how to design an EMV Level 3 certified payment application, see EMV Book 3:

EMV_v4.3_Book_3_Application_Specification_20120607062110791.pdf

Certification is a formal process to validate the device and application compliance with card scheme acceptance regulations. The certification team uses a brand test tool and simulator. The process involves:

Using a card simulator such as UL, ICC, or Fime.

Failed case analysis and resolution.

For Mastercard certification, your PTP submits results to Mastercard and pays the costs for approved partners that Mastercard uses.

For Visa certification, Visa Acceptance Solutions submits results to Visa.

Waivers from the card schemes for exceptions.

Card schemes responses or Letter of Approval (LOA) to signify acceptance and Level 3 certification.

The processes and support for Global Card Present Connect projects and direct merchant and acquirer projects are different, but the timelines are essentially the same.

Mass Transit Validation and Certification

Back to top