FILTER BY TAG
Limited Availability

Acquirer and Merchant: Register for OAuth 2.0

To begin using OAuth 2.0, you must register your application or organization in the
Business Center
.
Follow these steps to register your organization for OAuth 2.0 as an acquirer partner, merchant, or AI agent enabler:
IMPORTANT
Your account must have OAuth Application Management permissions in order to register for OAuth 2.0 in order to register.
  1. On the left navigation panel, choose
    Account Management > OAuth Application Management
    .
  2. Click
    Add Application
    .
    The Add Application page appears.
  3. In the Authentication Type drop-down menu, choose one of these authentication types:

    ADDITIONAL INFORMATION

    • OAuth 2.0 (API Access):
      Use for API authorization access to
      Cybersource
      APIs.
    • OpenID Connect (User Sign-In):
      Used for user authentication and identity, which includes ID token support.
  4. In the Application Type drop-down menu, choose one of these application types:

    ADDITIONAL INFORMATION

    • Web Application:
      Sever-side applications capable of securely storing credentials.
    • Mobile Application (for OpenID Connect only):
      Public client application, such as mobile or native apps.
    • Server Integration (for OAuth 2.0 Connect only):
      Machine-to-machine (M2M) communication without user consent, such as remote MCP or AI agents.
  5. In the Application information section, enter this information:
    • Application name:
      The name of the application that you are registering.
    • Application description:
      A brief description of the application.
  6. In the OAuth configuration section, enter the URL to which the user is redirected after granting permissions with auth_code.
  7. Click
    Next
    when done.
    The Product Configuration page appears.
  8. Configure your API permissions by choosing which
    scopes
    your application can access.
    Scopes determine which
    Cybersource
    APIs your application can use. Only choose the minimum necessary scopes needed for your organization in order to avoid unnecessary access. This is also known as following the principle of least privilege (PoLP).
  9. Click
    Save
    when done.
    Your
    client ID
    and
    client secret
    are generated. These credentials are required for OAuth authentication.
    IMPORTANT
    Securely store these credentials in your system. The client secret displays once and will not be viewable again. If you forget it or it is compromised, you can regenerate a new one any time.
  10. Click
    Done
    to return to the Authorized Applications page.

AFTER COMPLETING THE TASK

After registering your platform as an acquirer or your account as a merchant, you can integrate to one of these OAuth 2.0 methods:
Authorization Code Grant using On-Behalf-of Integration
This method is only available to acquirer partners.
A merchant or user signs in to the
Business Center
and grants your platform permission to act on their behalf. This is also known as
on-behalf-of
(OBO).
To integrate to this method, see Authorization Code Grant.
Authorization Code Grant Using OpenID Connect Integration
This method is only available to acquirer partners.
Your platform authenticates users by redirecting them to a
Business Center
sign-in page. When the user signs in using their account credentials, a federated identity relationship is established with
Cybersource
that enables single sign-on (SSO).
For instructions about how to integrate to this OAuth method, contact
Cybersource
customer support.
Client Credentials Grant using Machine-to-Machine Integration
Your system accesses the
Cybersource
APIs without a user logging in or merchant consent. Both your system and the
Cybersource
gateway authenticate each other.
To integrate to this method, see Client Credentials Grant.