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
- Discover 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 Account Status Check Authorization with EMV Data
  - Required Fields for a American Express Account Status Check AVR Authorization with EMV Data Using the REST API
  - REST Example: American Express Account Status Check Authorization with EMV Data
- American Express Delayed Online Authorization with EMV Data
  - Required Fields for a American Express Delayed Online Authorization with EMV Data Using the REST API
  - REST Example: American Express Delayed Online Authorization with EMV Data
- Discover Authorization with EMV Data
  - Required Fields for a Discover Authorization with EMV Data Using the REST API
  - REST Example: Discover Authorization with EMV Data
- Mastercard Authorization with EMV Data
  - Required Fields for a Mastercard Authorization with EMV Data Using the REST API
  - REST Example: Mastercard Authorization with EMV Data
- Visa Account Verification Request (AVR) with EMV Data
  - Required Fields for a Visa AVR Authorization with EMV Data Using the REST API
  - REST Example: Visa AVR Authorization with EMV Data
- Required Fields for Sales with EMV Data
- Discover Sale with EMV Data
  - Required Fields for a Discover Sale with EMV Data Using the REST API
  - REST Example: Discover Sale with EMV Data
- Visa Deferred Sale with EMV Data
  - Required Fields for a Visa Deferred Sale with EMV Data Using the REST API
  - REST Example: Visa Deferred Sale with EMV Data
- Required Fields for an Authorization for Debt Recovery
- Tap-Initiated Authorization for Debt Recovery with EMV Data
  - Required Fields for a Tap-Initiated Authorization for Debt Recovery with EMV Data Using the REST API
  - REST Example: Tap-Initiated Authorization for Debt Recovery with EMV Data
- Merchant-Initiated Authorizations for Debt Recovery with Stored Card Data
  - Required Fields for a Merchant-Initiated Authorization for Debt Recovery with Stored Card Data Using the REST API
  - REST Example: Merchant-Initiated Authorization for Debt Recovery with Stored Card Data
- Required Fields for a Sale for Debt Recovery
- Tap-Initiated Sale for Mastercard Debt Recovery with EMV Data
  - Required Fields for a Tap-Initiated Sale for Mastercard Debt Recovery with EMV Data Using the REST API
  - REST Example: Tap-Initiated Sale for Mastercard Debt Recovery with EMV Data
- Tap-Initiated Sale for Visa Debt Recovery with EMV Data
  - Required Fields for a Tap-Initiated Sale for Visa Debt Recovery with EMV Data Using the REST API
  - REST Example: Tap-Initiated Sale for Visa Debt Recovery with EMV Data
- Merchant-Initiated Sale for Debt Recovery with Stored Card Data
  - Required Fields for a Merchant-Initiated Sale for Debt Recovery with Stored Card Data Using the REST API
  - REST Example: Merchant-Initiated Sale for Debt Recovery with Stored 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
  - REST Example: Performing a Mastercard Authorization with a Token
- 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
  - REST Example: Performing a Visa AVR Authorization with a Transient Token
- Mass Transit Visa Deferred Sale with a Token
  - Required Fields for a Visa Deferred Sale with a Token Using the REST API
  - REST Example: Performing a Visa Deferred Sale with a Token
- 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
  - REST Example: Performing a Tap-Initiated Authorization for Debt Recovery with a Token
- 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
  - REST Example: Performing a Merchant-Initiated Authorization for Debt Recovery with a Token
- 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
  - REST Example: Performing a Tap-Initiated Sale for Debt Recovery with a Token
- 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
  - REST Example: Performing a Merchant-Initiated Sale for Debt Recovery with a Token
- Mass Transit Stand-Alone Credit with a Token
  - Required Fields for a Stand-Alone Credit with a Token Using the REST API
  - REST Example: Performing a Stand-Alone Credit with a Token

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

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

Transit Test Cases

On This Page

Aggregated

This type of transaction uses a contactless terminal at points of access to the transit service. The final fare charged is not always known at the time of travel. It is calculated at the end of a travel period (typically 24 hours) based on journeys made during that period.

Diagram that illustrates an aggregated transit transaction. — Aggregated Transaction Flow

Discover Aggregated Transactions

When the cardholder taps their card for travel, initiate an aggregated transaction by requesting an authorization for 1.00 USD that includes the

processingInformation.authorizationOptions.aggregatedAuthIndicator

field set to

true

. If the issuer approves the authorization, subsequent taps do not require an authorization. The capture amount must not exceed 15.00 USD in the US, and the capture date must not exceed the aggregation duration of up to 14 days from the first tap transaction.

If the aggregate total nears the maximum aggregation amount, and the next tap will cause the aggregation amount to exceed 15.00 USD, capture the existing aggregate total. Then, authorize the current tap for 1.00 USD to begin a new aggregation cycle, and include the

processingInformation.authorizationOptions.aggregatedAuthIndicator

field set to

true

.

For more details about Discover aggregated transactions, see the Discover Global Network Contactless D-PAS: Open Loop Transit Implementation Guide
.

Back to top