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

Example: Stand-Alone Credit with Card Data

Request

{
    "clientReferenceInformation": {
        "comments": "CREDIT Automatic or CREDIT Manual",
        "code": "10000599",
        "transactionId": "20000599",
        "partner": {
            "thirdPartyCertificationNumber": "BPCDRC220403",
            "solutionId": "548UHQ8Z"
        }
    },
    "paymentInformation": {
        "card": {
            "number": "476173XXXXXXXXXX",
            "expirationMonth": "12",
            "expirationYear": "2024",
            "type": "001"
        }
    },
    "orderInformation": {
        "amountDetails": {
            "totalAmount": "20.00",
            "currency": "EUR"
        }
    }
}

Response to a Successful Request

{
    "_links": {
        "void": {
            "method": "POST",
            "href": "/pts/v2/credits/6508884042856584104004/voids"
        },
        "self": {
            "method": "GET",
            "href": "/pts/v2/credits/6508884042856584104004"
        }
    },
    "clientReferenceInformation": {
        "code": "10000599",
        "partner": {
            "solutionId": "548UHQ8Z"
        },
        "transactionId": "20000599"
    },
    "creditAmountDetails": {
        "currency": "EUR",
        "creditAmount": "20.00"
    },
    "id": "6508884042856584104004",
    "orderInformation": {
        "amountDetails": {
            "currency": "EUR"
        }
    },
    "paymentAccountInformation": {
        "card": {
            "type": "001"
        }
    },
    "paymentInformation": {
        "tokenizedCard": {
            "type": "001"
        },
        "card": {
            "type": "001"
        }
    },
    "processorInformation": {
        "approvalCode": "831000",
        "networktransactionId": "016153570198200",
        "retrievalReferenceNumber": "211512164958",
        "responseCode": "00"
    },
    "reconciliationId": "6508884042856584104004",
    "status": "PENDING",
    "submitTimeUtc": "2022-04-25T12:06:44Z"
}

Back to top