Skip to main content
A GoCardless partner app is required for OAuth connections, and you must accept the partner agreement when creating it. Partner apps are tied to one environment — create the app in the same environment (Production or Sandbox) you will select in the StackOne Connector profile.

​
Create a GoCardless partner app

Register a partner app in the GoCardless dashboard to obtain the OAuth client credentials StackOne needs.

1

Sign in to GoCardless

Sign in to the GoCardless dashboard for the environment you are connecting. Enter your Email address and Password, then click Sign in.

GoCardless sign in page with the Email address and Password fields
2

Open Partner apps

In the left sidebar, click Developers, then select Partner apps from the expanded menu.

The expanded Developers menu in the GoCardless sidebar with Partner apps highlighted
3

Create the partner app

On the Partner apps page, click Create app in the top right corner.

The Partner apps page with the Create app button highlighted
4

Fill in the Create a partner app form

On the Create a partner app page, complete the form:

  • App name — enter a name for your app (for example, StackOne).
  • Description — enter a short description of your app.
  • Homepage URL — enter your company’s website URL.
  • Redirect URLs — enter the StackOne callback URL exactly as: https://api.stackone.com/connect/oauth2/gocardless/callback
  • App logo, Post onboarding URL, Payment setup URL, and Webhook URL are optional and can be left empty.
  • Tick I agree to the terms of the partner agreement, then click Create.
The Create a partner app form with the StackOne callback URL entered in the Redirect URLs field

​
Copy your credentials into StackOne

Your new app’s OAuth credentials are shown on its details page.

1

Copy the Client ID and Client secret

Back on the Partner apps page, click your new app to open its details. Under Oauth configuration, copy the value shown next to Client ID, then click Reveal next to Client secret and copy the revealed value.

  • Client ID — the public identifier of your partner app; paste it into the Client ID field in the StackOne Connector profile.
  • Client Secret — the private key of your partner app; paste the revealed value into the Client Secret field in the StackOne Connector profile and keep it private.
  • You can return to this page at any time to view the credentials again.
The Oauth configuration section of the partner app details page showing Client ID and the Reveal link for Client secret
2

Choose your OAuth scope

Enables actions: Cancel A Mandate, Cancel A Payment, Cancel An Instalment Schedule, Cancel Billing Request, Cancel Subscription, Collect Bank Account For Billing Request, Collect Customer Details For Billing Request, Confirm Payer Details For Billing Request, Create A Creditor Bank Account, Create A Customer, Create A Customer Bank Account, Create A Mandate, Create A Payment, Create Billing Request, Create Billing Request Flow, Create Instalment Schedule With Dates, Create Instalment Schedule With Schedule, Create Refund, Create Subscription, Disable A Creditor Bank Account, Disable A Customer Bank Account, Fallback Billing Request To Direct Debit, Fulfil Billing Request, Get A Single Creditor, Get A Single Creditor Bank Account, Get A Single Customer, Get A Single Customer Bank Account, Get A Single Instalment Schedule, Get A Single Mandate, Get A Single Payment, Get A Single Payout, Get A Single Tax Rate, Get Billing Request, Get Event, Get Refund, Get Subscription, List Billing Requests, List Creditor Bank Accounts, List Creditors, List Customer Bank Accounts, List Customers, List Events, List Instalment Schedules, List Mandates, List Payments, List Payout Items, List Payouts, List Refunds, List Subscriptions, List Tax Rates, Notify Billing Request Customer, Pause Subscription, Reinstate A Mandate, Remove A Customer, Resume Subscription, Retry A Payment, Run Scenario Simulator, Update A Creditor, Update A Customer, Update A Customer Bank Account, Update A Mandate, Update A Payment, Update A Payout, Update An Instalment Schedule, Update Refund, Update Subscription

The optional Scope field in the StackOne Connector profile controls the access level requested during authorization. If left empty it defaults to read_write. Grant the level the connector’s actions need:

  • read_write — full access; required for actions that create, update, or cancel payments, mandates, subscriptions, and customers.
  • read_only — read-only access to all resources; sufficient if you only use list and get actions.
  • The app details page also lets you test both access levels via Preview OAuth flow (Read-write / Read-only).

​
Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for GoCardless:
1

Navigate to Connector Profiles

Login to StackOne and navigate to Connector Profiles
2

Create New Connector Profile

  • Click + Connector Profile
  • Search for and select GoCardless
  • Select Type as OAuth 2.0
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
    • Scope (Optional)
  • (Optional) Select Actions to be enabled for this Connector Profile
  • Click Create profile
Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to Link Accounts for GoCardless.