> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Adyen OAuth 2.0 connector profile – StackOne setup guide

> Set up the OAuth 2.0 connector profile for Adyen in StackOne. One-time admin setup required before your users can link Adyen accounts via Hub.

> [!WARNING]
>
> Creating an OAuth app needs a Customer Area user with permission to manage OAuth apps. On live, only Adyen partner accounts can create OAuth apps. Scopes are fixed when the app is created, so select every scope you need before you click Create client.

Select Actions to adjust the guideSome actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.

Select all
Clear

ActionScope(s)

Loading actions...No actions match your search.

Dynamic Guide URL

Copy URL

Scopes Selected

<pre role="textbox" aria-readonly="true" tabIndex="0" />

Separator

Copy scopes

## Creating an OAuth app

An Adyen OAuth app lets StackOne call Adyen on behalf of the merchant accounts that approve it. Register it once; each customer then signs in to Adyen and grants access.

**1. Sign in to Adyen**

Sign in to the Customer Area for the environment you are connecting:

<ul>
  <li>**Test** — [Adyen test Customer Area](https://ca-test.adyen.com)</li>
  <li>**Production** — [Adyen live Customer Area](https://ca-live.adyen.com)</li>
  <li>In the sidebar, click **Settings**, then click **OAuth apps** under **Developers**.</li>
</ul>

![The Settings page with Settings in the sidebar and OAuth apps under Developers highlighted](https://mintcdn.com/stackone-60/eTLrFzg-j9yjnxiV/connectors/adyen/images/oauth2-setup-open-oauth-apps.png?fit=max\&auto=format\&n=eTLrFzg-j9yjnxiV\&q=85\&s=7e804e8b74628808cb47a0b54edcb948)

**2. Start a new app**

On the **OAuth apps** page, click **Create OAuth app**.

![The OAuth apps page with the Create OAuth app button highlighted](https://mintcdn.com/stackone-60/eTLrFzg-j9yjnxiV/connectors/adyen/images/oauth2-setup-create-oauth-app.png?fit=max\&auto=format\&n=eTLrFzg-j9yjnxiV\&q=85\&s=51c1f2b4add9d242b6daa386187435c0)

**3. Fill in public info**

Merchants see these details when they approve access.

<ul>
  <li>App name: `StackOne Integration`</li>
  <li>Website: `https://www.stackone.com`</li>
  <li>Description: `Integration with StackOne`</li>
  <li>Click **Continue**.</li>
</ul>

![The Public info step with the App name, Website and Description fields and the Continue button highlighted](https://mintcdn.com/stackone-60/eTLrFzg-j9yjnxiV/connectors/adyen/images/oauth2-setup-public-info.png?fit=max\&auto=format\&n=eTLrFzg-j9yjnxiV\&q=85\&s=ad7331ac8622cb000836e7ee3815caa0)

**4. Enter the redirect URL**

On the **OAuth client** step, enter the StackOne callback URL and start choosing scopes.

<ul>
  <li>Redirect URL: `https://api.stackone.com/connect/oauth2/adyen/callback`</li>
  <li>Under **Payments**, select **Perform online payments**.</li>
  <li>Under **Tokenization**, select **Allow tokenization of payment details**.</li>
</ul>

![The OAuth client step with the Redirect URL and the Payments and Tokenization scope options highlighted](https://mintcdn.com/stackone-60/eTLrFzg-j9yjnxiV/connectors/adyen/images/oauth2-setup-redirect-url.png?fit=max\&auto=format\&n=eTLrFzg-j9yjnxiV\&q=85\&s=7207bb0dd4f62e9c326378b325a57f1f)

**5. Select the remaining scopes**

Enables actions: Cancel Payment, Cancel Payment By Merchant Reference, Create Order, Create Payment Link, Create Payment Session, Create Stored Payment Method, Delete Stored Payment Method, Get Card Details, Get Merchant Account, Get Payment Link, Get Payment Methods, Get Payment Session, Get Stored Payment Methods, Refund Payment, Set Up Merchant Webhook, Start Transaction, Update Payment Amount, Update Payment Link

In every remaining group (**Pay by link**, **Account settings**, **Webhooks**, **Cloud device api**, **Terminals**, **Terminal settings**, **Terminal actions** and **Android files**), select the option for the scopes below, then click **Create client**.

<ul>
  <li>If you selected exactly these scopes, leave the **Scopes** field in the StackOne Connector profile empty.</li>
  <li>If you chose a different option in any group, or left a group at **No access**, enter the app's scopes in the **Scopes** field, separated by spaces. Adyen rejects the authorization with invalid\_scope unless they match the app exactly.</li>
  <li>Scopes cannot be changed after the app is created.</li>
</ul>

![The Pay by link, Account settings and Webhooks scope options and the Create client button highlighted](https://mintcdn.com/stackone-60/eTLrFzg-j9yjnxiV/connectors/adyen/images/oauth2-setup-scopes.png?fit=max\&auto=format\&n=eTLrFzg-j9yjnxiV\&q=85\&s=c419c9d9f126bd0de2248bf6c721f599)

<ul>
  <li>
    psp.onlinepayment:write
  </li>

  <li>
    psp.onlinepayment.tokenization:write
  </li>

  <li>
    psp.paybylink:write
  </li>

  <li>
    psp.accountsettings:write
  </li>

  <li>
    psp.webhook:write
  </li>

  <li>
    psp.clouddeviceapi:write
  </li>

  <li>
    psp.terminals:reassign
  </li>

  <li>
    psp.terminalsettings:write.advanced
  </li>

  <li>
    psp.terminalactions:write
  </li>

  <li>
    psp.androidfiles:write
  </li>
</ul>

**6. Copy the client credentials**

On **Copy your OAuth client secret**, click **Copy** next to **Client ID** and next to **Client secret**.

<ul>
  <li>The client secret is shown only once and cannot be retrieved later. Store it securely for use later.</li>
  <li>Paste the values into the **Client ID** and **Client Secret** fields in the StackOne Connector profile.</li>
  <li>Click **Done**.</li>
</ul>

![The Copy your OAuth client secret step with both Copy buttons and the Done button highlighted and the secret hidden](https://mintcdn.com/stackone-60/eTLrFzg-j9yjnxiV/connectors/adyen/images/oauth2-setup-client-secret.png?fit=max\&auto=format\&n=eTLrFzg-j9yjnxiV\&q=85\&s=e07e4fcfae3c7232aba3ee00de038178)

## Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for **Adyen**:

**1. Open the connector**

Log in to StackOne, open [Connectors](https://app.stackone.com/connectors), and select **Adyen**.

**2. Choose actions and events**

<ul>
  <li>Click **Add Profile**.</li>
  <li>If the connector offers more than one authentication method, set the **Auth Method** filter to **OAuth 2.0**.</li>
  <li>Select the actions, and any events, to enable for this Connector Profile.</li>
  <li>Click **Continue**.</li>
</ul>

**3. Set up authentication**

<ul>
  <li>Select **Authentication Type** as **OAuth 2.0**.</li>

  <li>
    Fill out the fields using details retrieved from your provider:

    <ul>
      <li>**Client ID**</li>
      <li>**Client Secret**</li>
      <li>**Scopes** (Optional)</li>
    </ul>
  </li>

  <li>Click **Create Profile**.</li>
</ul>

Congratulations! The new Connector Profile now shows up on the connector page. If you created it as a project member rather than an admin, it starts disabled until a project admin enables it. You can now continue to [Link Accounts](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md) for **Adyen**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.