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

Capture

Use this information to process a capture.

When a transaction is below the threshold for First Ride Risk protection, use the capture service to capture funds from a declined authorization. For more information, see First Ride Risk.

Endpoint

Production:

POST https://api.visaacceptance.com/pts/v2/payments/{id}
/captures

Test:

POST https://apitest.visaacceptance.com/pts/v2/payments/{id}
/captures

The

{id}

is the transaction ID returned in the authorization response.

Required Fields for a Capture

clientReferenceInformation.comments
clientReferenceInformation.partner.thirdPartyCertificationNumber: The value for this field is provided by Visa Acceptance Solutions.
clientReferenceInformation.transactionId
orderInformation.amountDetails.currency
orderInformation.amountDetails.totalAmount

REST Example: Capture

Request

{
   "clientReferenceInformation": {
        "comments": "TransitDA BAU capture",
        "transactionId": "14987654321",
        "partner": {
            "thirdPartyCertificationNumber": "123456789012"
        }
    },
   "orderInformation": {
    "amountDetails": {
      "totalAmount": "10.00",
      "currency": "EUR"
    }
  }
}

Response to a Successful Request

{
    "_links": {
        "void": {
            "method": "POST",
            "href": "/pts/v2/captures/6484688186356910704004/voids"
        },
        "self": {
            "method": "GET",
            "href": "/pts/v2/captures/6484688186356910704004"
        }
    },
    "clientReferenceInformation": {
        "comments": "capture",
        "code": "testcode1012",
        "transactionId": "14987654321"
    },
    "id": "6484688186356910704004",
    "orderInformation": {
        "amountDetails": {
            "totalAmount": "10.00",
            "currency": "EUR"
        }
    },
    "reconciliationId": "fgssgsgsgsfg",
    "status": "PENDING",
    "submitTimeUtc": "2022-03-28T12:00:18Z"
}

Back to top