Skip to login Skip to content
Developer Cybersource Logo

Our API

Learn about Cybersource REST APIs, Developer guides & Release notes

API reference

View sample code and API field descriptions. Send requests to the sandbox and see the responses.

Developer guides

View feature-level guides with prerequisite and use-case information for implementing our API

Release notes

These release notes cover all releases to the production for the APIs and SDKs every month

Getting started

Use these developer resources to make your first API call.

 

Hello world

Step by step guide to make first Cybersource REST API call.

REST API SDKs

An inventory of SDKs & Sample codes in 6 languages to help you kick start your integration

 

Testing

Guide with sandbox testing instructions and processor specific testing trigger data.

 

Postman collection

A collection to make sample REST API calls. It provides samples for all supported HTTP methods.

Response (error) codes Understand all different error codes that Cybersource REST API responds with.

Accept payments

In-person Accept

Accept payments in person through a range of supported payment devices provided by us or integrate your existing payment devices to our payments network

Online payments

Start accepting payments online—quickly, securely, and globally. We offer a range of solutions to help you optimize payments across channels while protecting sensitive data.

Plugin connections

See our latest plugins and integrations.

 

Technology Partners

See our latest integrations and ISV solutions

Support

Reach out to our award-winning customer support team, or contact sales directly.

FAQ Frequently asked questions relating to Cybersource REST APIs and developer center.

Sales help Learn more about how our services can help your business. Call sales: 1-800-530-9095

Contact us

Cybersource on GitHub

Cybersource Community Forum

News and announcements

Feedback

Menu
API Overview
  • Card Present Connect | Mass Transit Developer Guide
    • Recent Revisions to This Document
    • VISA Platform Connect: Specifications and Conditions for Resellers/Partners
  • Introduction to Card Present Connect | Mass Transit
    • Rider Benefits
    • Transit System Benefits
    • Mass Transit Terminology
    • Mass Transit Prerequisites
    • Mass Transit Validation and Certification
      • Message-Level Validation
      • EMV L3 Certification
    • Mass Transit Transactions
      • Aggregated
      • Debt Recovery
      • Card Types and Transaction Models
      • Aggregated Model with the Token Management Service
      • Multiple Accounts for Processing Functions
      • Journey History Service
      • American Express Mass Transit Model
        • American Express Pay As You Go
        • American Express Authorization and Capture Options
      • Mastercard Mass Transit Model
        • Mastercard Pay As You Go
      • Visa Mass Transit Model
        • Visa Mobility and Transport Transaction
  • 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

Required Fields for a Mastercard Authorization with a Token Using the REST API

clientReferenceInformation.code
clientReferenceInformation.partner.solutionId
The value for this field is provided by
Cybersource
.
clientReferenceInformation.partner.thirdPartyCertificationNumber
The value for this field is provided by
Cybersource
.
clientReferenceInformation.transactionId
orderInformation.amountDetails.currency
orderInformation.amountDetails.totalAmount
paymentInformation.initiationChannel
pointOfSaleInformation.catLevel
Set this field to
2
.
pointOfSaleInformation.entryMode
Set this field to
contactless
.
pointOfSaleInformation.terminalCapability
Set this field to
5
.
pointOfSaleInformation.terminalId
pointOfSaleInformation.terminalPinCapability
Set this field to
0
.
processingInformation.authorizationOptions.aggregatedAuthIndicator
Set this field to
true
.
processingInformation.authorizationOptions.authIndicator
Set this field to
0
.
processingInformation.authorizationOptions.deferredAuthIndicator
Set this field to
true
.
processingInformation.authorizationOptions.transportationMode
processingInformation.captureOptions.dateToCapture
processingInformation.commerceIndicator
Set this field to
retail
.
processingInformation.industryDataType
Set this field to
transit
.
tokenInformation.jti
Generate this value using the UUID2/UUID4 data format.
Previous topic
Next topic
Back to top

Visa

Cybersource.com

Terms + conditions

Cookie policy

Privacy Notice

Your privacy rights

© 2024 Cybersource. All rights reserved. All brand names and logos are the property of their respective owners, are used for identification purposes only, and do not imply product endorsement or affiliation with Cybersource.