API Overview

Card Present Connect | Mass Transit Developer Guide
- Recent Revisions to This Document

Introduction to Card Present Connect | Mass Transit
- Transit Rider Benefits
- Transit System Benefits
- Supported Card Types
- Mass Transit Terminology
- Mass Transit Prerequisites
- Mass Transit Validation and Certification
- First Ride Risk
- Transit Test Cases

Mass Transit Models and Workflows
- American Express Mass Transit Model
- Discover Pay As You Go Model
- Mastercard Pay As You Go Model
- Visa Mass Transit Model
- Common Mass Transit Transaction Workflows and Features

Mass Transit Payment Services Using EMV and Card Data
- Mass Transit Transaction Types
- Required Fields for Authorizations with EMV Data
- American Express Account Status Check Authorization with EMV Data
- American Express Delayed Online Authorization with EMV Data
- Discover Authorization with EMV Data
- Mastercard Authorization with EMV Data
- Visa Account Verification Request with EMV Data
- Required Fields for a Sale with EMV Data
- Discover Sale with EMV Data
- Visa Deferred Sale with EMV Data
- Required Fields for Authorizations for Debt Recovery
- Tap-Initiated Authorization for Debt Recovery with EMV Data
- 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
- Tap-Initiated Sale for Visa Debt Recovery with EMV Data
- Merchant-Initiated Sale for Discover Debt Recovery with Card Data
- Merchant-Initiated Sale for Mastercard Debt Recovery with Card Data
- Merchant-Initiated Sale for Visa Debt Recovery with Stored Card Data

Mass Transit Payment Services Using TMS Tokens
- Mastercard Authorization with a Token
- Visa Account Verification Request with a Token
- Visa Deferred Sale with a Token
- Tap-Initiated Authorization for Debt Recovery with a Token
- Merchant-Initiated Authorization for Debt Recovery with a Token
- Tap-Initiated Sale for Debt Recovery with a Token
- Merchant-Initiated Sale for Debt Recovery with a Token

Mass Transit Follow-On Payment Services
- Required Fields for Mass Transit Captures
- Capture
- Required Fields for Mass Transit Reversals
- Authorization Reversal
- Time-Out Authorization Reversal
- Stand-Alone Credit with a Token
- Required Field for Timeout Voids
- Time-Out Void

Mass Transit Token Management Services
- Creating a Token
- Retrieving Transient Token Details
- Retrieving an Instrument Identifier Details
- Retrieving Card Hash Details
- Deleting an Instrument Identifier
- Deleting a Card Hash

On This Page

Retrieving Transient Token Details

Use this information to retrieve transient token details. The details include the instrument identifier token and payment instrument token.

The payment instrument token is used to obtain the card hash value. The instrument identifier is used for merchant-initiated debt recovery and stand-alone credit transactions.

Endpoint

Test:

GET https://apitest.visaacceptance.com/tms/v2/taps/{id}

Production:

GET https://api.visaacceptance.com/tms/v2/taps/{id}

The

id

is the transient token identifier assigned by the contactless terminal.

REST Example: Retrieving Transient Token Details

Request

{
}

Response 200

{
    "id": "a76392f4-cde4-97aa-1111-0252ac14c005",
    "paymentInformation": {
        "card": {
            "expirationMonth": "12",
            "expirationYear": "2030"
        }
    },
    "pointOfSaleInformation": {
        "deviceId": "FF123457",
        "emv": {
            "applicationIdentifier": "A0000000031010",
            "applicationLabel": "Company"
        }
    },
    "processingInformation": {
        "industryDataType": "transit"
    },
    "tokenInformation": {
        "instrumentIdentifier": {
            "id": "CD616772D8355EA6E53AF598E0AE794"
        },
        "paymentInstrument": {
            "id": "DB0875B76F95085CE053AF598E0A6354"
        }
    },
    "metadata": {
        "creator": "tml_tap01"
    },
    "_links": {
        "self": {
            "href": "/tms/v2/taps/a76392f4-cde4-97aa-1111-0252ac14c005"
        },
        "paymentInstrument": {
            "href": "/tms/v1/paymentinstruments/DB0875B76F95085CE053AF598E0A6354"
        },
        "instrumentIdentifier": {
            "href": "/tms/v1/instrumentidentifiers/CD616772D835EA6E53AF598E0AE794"
        }
    }
}

Back to top