On This Page
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.
- Log in to theBusiness Center:
- On the left navigation panel, chooseAccount Management > OAuth Application Management.
- ClickAdd Application.The Add Application page appears.
- 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 toCybersourceAPIs.
- OpenID Connect (User Sign-In):Used for user authentication and identity, which includes ID token support.
- 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.
- 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.
- In the OAuth configuration section, enter the URL to which the user is redirected after granting permissions with auth_code.
- ClickNextwhen done.The Product Configuration page appears.
- Configure your API permissions by choosing whichscopesyour application can access.Scopes determine whichCybersourceAPIs 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).
- ClickSavewhen done.Yourclient IDandclient secretare generated. These credentials are required for OAuth authentication.IMPORTANTSecurely 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.
- ClickDoneto 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 theBusiness Centerand grants your platform permission to act on their behalf. This is also known ason-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 aBusiness Centersign-in page. When the user signs in using their account credentials, a federated identity relationship is established withCybersourcethat enables single sign-on (SSO).
- For instructions about how to integrate to this OAuth method, contactCybersourcecustomer support.
- Client Credentials Grant using Machine-to-Machine Integration
- Your system accesses theCybersourceAPIs without a user logging in or merchant consent. Both your system and theCybersourcegateway authenticate each other.
- To integrate to this method, see Client Credentials Grant.