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

# GoCardless

> How to connect GoCardless, send mandate requests to customers and collect invoices by direct debit in Nexudus.

## Overview

GoCardless lets customers pay by direct debit from their bank account. Once a customer approves a mandate, Nexudus collects their invoices automatically when they fall due. Payments take several working days to clear, depending on the customer's bank.

GoCardless is available in two scenarios:

* **Plan signup checkout** — Customers can select GoCardless when signing up for a membership plan
* **Pay via invoice** — Customers who receive an invoice can pay it using GoCardless from **My Invoices** in the Members Portal. Invoice payment links don't support GoCardless, because direct debit needs a bank account linked to the customer's account.

GoCardless doesn't add a charge to your Nexudus subscription. GoCardless charges its own fees.

## Features

| Feature | Supported |
| - | - |
| Card payments | No |
| ACH / Direct debit | Yes |
| Recurring payments | Yes |
| 3D Secure | N/A |
| Sandbox mode | No setting in Nexudus |

## Configuration Parameters

To configure GoCardless, go to **Settings → Billing and payments → Payments and currency → Payment methods** and select **GoCardless**.

### Required Settings

| Setting | Description |
| - | - |
| **Enabled** | Master switch to enable or disable GoCardless payments. |

### Customer Type Settings

| Setting | Description |
| - | - |
| **Enable by default for members** | Turns GoCardless on for new members (customers with an active contract for one of your plans). |
| **Enable by default for contacts** | Turns GoCardless on for new contacts (customers with no active contract for one of your plans). |

<Note>These defaults only apply to customers who join after you enable them. For existing customers, turn on **Enable GoCardless Direct Debit payments** on each customer's **Payments** tab, or use a bulk edit to change many customers at once.</Note>

### Optional Settings

| Setting | Description |
| - | - |
| **Use invoice period start date in Nexudus as the charge date in GoCardless** | Use the invoice period start date in Nexudus as the charge date in GoCardless. |
| **Use GoCardless Success+ (automatic retries)** | Enable automatic retries for failed payments using GoCardless Success+. |

## Setting up GoCardless

GoCardless is enabled per location. If you run several locations, repeat these steps in each one. You can connect the same GoCardless account to every location, or a different account per location.

1. Create an account at [gocardless.com](https://gocardless.com) and complete GoCardless's onboarding, including verifying your business details.
2. In Nexudus, go to **Settings → Billing and payments → Payments and currency → Payment methods** and select **GoCardless**.
3. Turn on **Enabled**.
4. Choose whether GoCardless is on by default for new members, new contacts or both.
5. Turn on any optional settings you need, then select **Save changes**.
6. Select **Connect to GoCardless**, sign in to your GoCardless account and approve the connection. You return to Nexudus when it's done.

<Note>GoCardless connects through a sign-in flow rather than API keys, so there are no keys to copy.</Note>

## Sending mandate requests

Customers must approve a direct debit mandate before you can collect from them, and their bank must accept it too.

1. Go to **Operations → Members & contacts**.
2. Tick the customers who should pay by GoCardless.
3. From the bulk actions menu, select **Send Direct Debit request email** and confirm.

Each customer receives an email with a link to enter their bank details and approve the mandate. To resend the request to one customer, open their **Payments** tab, open **Direct debit (GoCardless)** and select **Resend sign-up request notification**.

### How GoCardless works in checkout

1. When a customer selects GoCardless during plan signup checkout, they will be prompted to link their bank account if they haven't already
2. The linking process opens a secure GoCardless popup where the customer selects their bank and authorizes the payment
3. Once linked, future payments are processed automatically via direct debit
4. Payments can take several days to clear depending on the customer's bank

## Troubleshooting

### Payment result: "Invalid request. Status: 422"

The payment is above the transaction limit GoCardless allows for a single customer. Check GoCardless's [transaction limits](https://hub.gocardless.com/s/article/Transaction-Limits) for your currency and ask GoCardless to raise yours.

In the meantime, collect this invoice another way (for example, by bank transfer) and mark it as paid in Nexudus.

### The link in a direct debit request doesn't work

Either GoCardless isn't connected properly, or GoCardless isn't turned on for that customer.

1. Open **GoCardless** from the payment methods list and select **Connect to GoCardless** again. Sign in to GoCardless if asked.
2. Open the customer's **Payments** tab, open **Direct debit (GoCardless)**, turn on **Enable GoCardless Direct Debit payments** and save.
3. Select **Resend sign-up request notification**.

### Other issues

* **Customers unable to link bank accounts** — Verify your GoCardless account is approved and the connection is active
* **Payments taking too long** — Direct debit payments take longer than card payments: usually at least 3 working days, and up to 12 working days for the first payment on a new mandate
* **Recurring payments failing** — Consider enabling GoCardless Success+ for automatic retries on failed payments

## Related

* [Payment gateways](/integrations/payment-gateways)
* [Customer payment methods](/integrations/payment-gateways/customer-payment-methods)
* [Invoices](/platform/finance/invoices)


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