---
title: How to Connect GoCardless to OneSuite
description: "Connect GoCardless so your clients can pay invoices by Pay by Bank. Go to **Settings** > **Integrations** > **Payment** and click **Connect** on the GoCardless card. Paste a Read-write **Access token**. Add the OneSuite webhook URL in GoCardless. Then paste the webhook endpoint's secret into **Webhook endpoint secret** and click **Save**. **In…"
url: "https://help.onesuite.io/docs/how-to-connect-gocardless-to-onesuite/"
updated: "2026-11-16"
category: Payment Integration
---

# How to Connect GoCardless to OneSuite

Connect GoCardless so your clients can pay invoices by Pay by Bank. Go to **Settings** > **Integrations** > **Payment** and click **Connect** on the GoCardless card. Paste a Read-write **Access token**. Add the OneSuite webhook URL in GoCardless. Then paste the webhook endpoint's secret into **Webhook endpoint secret** and click **Save**.

**In this guide you'll learn how to:**

- Create a GoCardless access token
- Add the OneSuite webhook endpoint in GoCardless
- Connect GoCardless to OneSuite
- Understand when an invoice shows as paid

## Before you start

- You need access to **Settings**. If you can't see **Integrations**, ask an admin.
- You need a GoCardless account. Only an admin can create an access token in GoCardless.
- An access token is a private code from GoCardless. It lets OneSuite work with your GoCardless account. Keep it private.
- A webhook is a web address that GoCardless calls to tell OneSuite about a payment. The webhook you add in GoCardless is called a webhook endpoint.
- GoCardless takes invoice payments by Pay by Bank. Payers in the UK pay in GBP. Payers in supported Eurozone countries pay in EUR.
- Use the same environment for the access token and the webhook endpoint. The environment is either sandbox or live. Sandbox is for practice and live is for real payments.

## What does OneSuite ask for when you connect GoCardless?

| Field | Where to find it | Required |
| --- | --- | --- |
| **Access token** | In the GoCardless Dashboard, open **Developers**, then **Create**, then **Access token**. Choose Read-write access. A read-only token cannot open a payment. | Yes |
| **Webhook endpoint secret** | In the GoCardless Dashboard, open **Developers**, then **Webhooks**. GoCardless shows the secret when you create the webhook endpoint. | Yes |
| **Currency** | Starts as **British Pound Sterling (GBP)**. OneSuite uses it when an invoice has no currency of its own. | No |

The dialog also shows a **Webhook URL for your GoCardless dashboard** box with a copy button.

## How do I connect GoCardless to OneSuite?

1. Click your name at the bottom of the sidebar, then click **Settings**.
2. Under **Integrations**, click **Payment**.
3. On the **Payment Methods** page, find **GoCardless** and click **Connect**. Keep the dialog open.
4. In GoCardless, create an access token with Read-write access.
5. Paste the token into **Access token**.
6. Copy the webhook URL from the dialog.
7. Add the URL in GoCardless, as shown in the next section.
8. Copy the endpoint's secret.
9. Paste the secret into **Webhook endpoint secret**.
10. Check the **Currency**.
11. Click **Save**.

![](https://help.onesuite.io/wp-content/uploads/2026/11/open-payment-settings-in-onesuite-1-925x1024.png)

## How do I add the GoCardless webhook?

OneSuite cannot add the endpoint for you. You add it in GoCardless yourself.

1. In the OneSuite dialog, click the copy button beside **Webhook URL for your GoCardless dashboard**.
2. In GoCardless, open **Developers**, then **Webhooks**.
3. Start a new webhook endpoint.
4. Paste the OneSuite URL.
5. Give the endpoint a name.
6. Create the endpoint.
7. Click the new endpoint in the list.
8. Copy its secret.
9. Paste the secret into **Webhook endpoint secret** in OneSuite.

## How do I check it worked?

The GoCardless card on the **Payment Methods** page now says **Connected** instead of **Not connected**. You also see GoCardless marked **Connected** under **Invoices** > **Configure** > **Getting paid** > **Online payments**.

OneSuite switches a connected gateway on for every new invoice. An invoice you created earlier keeps its own choice. To use GoCardless on an older invoice:

1. Open the invoice.
2. Switch GoCardless on in its **Payments** panel.
3. Save the invoice and send it again.

## If something goes wrong

- **Payments are not recorded.** If you change the endpoint's secret or create a new endpoint in GoCardless, paste the new secret into **Webhook endpoint secret** in OneSuite. If you don't, OneSuite cannot verify GoCardless's updates. Some payments may then not be recorded. In GoCardless, open **Developers**, then **Webhooks**. It shows the past 3 months of deliveries, which are the updates GoCardless sent. You can retry failed ones there.
- **The invoice shows a payment in progress.** Until GoCardless confirms a payment, the invoice may show it as in progress. OneSuite marks the invoice paid when GoCardless confirms it.

## FAQs

### Why isn't my GoCardless invoice marked paid straight away?

OneSuite records a bank payment on the invoice once GoCardless confirms it has collected the money. That can take a few days.

### Which access does the GoCardless token need?

It needs Read-write access. A read-only token cannot open a payment.

### Do I need a webhook for GoCardless?

Yes. OneSuite needs the webhook to learn when GoCardless confirms a payment. The steps are in the webhook section above.

## What to do next

**See every gateway:** Browse all the guides in [Payment Integration](https://help.onesuite.io/docs-category/payment-integration/).

**Record the money that arrives:** Log payments made outside a gateway with [How to Record Invoice Payments](https://help.onesuite.io/docs/how-to-record-invoice-payments/).
