Skip to main content
Access tokens are for using your own GoCardless account with the API. For partner integrations to manage other users’ accounts, use OAuth 2.0 instead. Ensure you are using the correct environment token (Sandbox tokens only work with sandbox API, live tokens only work with live API).

​
Creating Your GoCardless Access Token

GoCardless uses Bearer token authentication for API access. Follow these steps to create an access token from your GoCardless Dashboard.

1

Sign in to GoCardless Dashboard

Sign in to your GoCardless Dashboard (or Sandbox Dashboard for testing).

2

Navigate to API Settings

In the left sidebar, click Developers, then select API settings.

3

Open Access Tokens

You will see the Access tokens page with a list of your existing tokens (if any).

4

Create Access Token

Click the Create access token button in the top right corner.

5

Configure Token Details

In the modal dialog, provide the following details for your token.

  • Name - Enter a descriptive name for the token (e.g., ‘StackOne Integration’)
  • Scope - Select the appropriate access level:
  • • Read only access - For read-only operations
  • • Read-write access - For full API access (create, update, delete operations)
6

Save and Copy Token

Click Create to generate the token.

  • Copy the token immediately as it will only be shown once
  • Store the token securely
7

Select Environment in StackOne

When connecting in StackOne, choose the environment that matches your token type.

  • Production - Use live tokens (starting with live_) for real payments
  • Sandbox - Use sandbox tokens (starting with sandbox_) for testing

​
Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • Access Token
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.