The GoCardless gateway provides your donors with an easy way to pay via Direct Debit. The gateway offers a modern interface and easy integration with support for recurring donations. The following article will describe how the plugin works and how you can begin accepting donations via Direct Debit today.

Getting Started with GoCardless

In order to accept payments with GoCardless using Give you will need to have an active GoCardless account, the GoCardless Give add-on, and the Give Core plugin installed and activated.

Click here for instructions on installing and activating Give Add-ons.

Note: You can always access your add-on purchase receipts, downloads, and licenses from your Give Account dashboard.

After the GoCardless add-on is activated, go to “Donations > Settings” and click on the Payment Gateways tab. There you will see the default Payment Gateways (PayPal Standard, Test Payment, and Offline Donations). You should also see GoCardless as an option as well. Click on the GoCardless checkbox to enable it as an active payment gateway for your website.

Connecting to GoCardless

The Give integration with GoCardless offers an fast and easy way to connect your website with the gateway without having to hassle with any API keys or complicated setups.

Connecting to the GoCardless Sandbox

The GoCardless sandbox offers an easy way to test your integration before going live. The first thing you’re going to need is a separate test account on the GoCardless sandbox site. If you don’t have one, please create a free GoCardless sandbox account for testing.

Once you have created a free test account, log into your WordPress website and navigate to Donations > Settings > Payment Gateways > Go Cardless. Once there, click on the link below the main connect button that says “Not ready to accept live payments? Click here to connect using sandbox mode.”

Connecting to GoCardless’ Sandbox

Once you click that button you will be redirected to the GoCardless sandbox to authenticate with the Give integration. You may have to login to connect, so be sure to login with your sandbox credentials rather than your live ones.

Login to connect to GoCardless

After you successfully connect you will see the following screen:

Click the button to redirect and your site will then be connected to GoCardless’ Sandbox.

Creating the GoCardless Webhook

Now that you are connected you will see a new field appears called “Webhook Secret”:

The GoCardless Webhook Secret Field

Webhooks are required so that your website can communicate with GoCardless. To receive webhooks, click on the link within the field’s description and copy-and-paste the webhook URL provided into GoCardless.

Paste the URL provided in this field.

Name the webhook something useful like “My Website – Give Webhook”. Don’t fill out anything into the “Secret” field or check the “webhook client certificate” box. Click the “Create webhook endpoint” button once the URL and name field are completed. This will submit the form and create your webhook endpoint.

Next, click on the webhook to view its details. You should see it is enabled and a secret key is provided:

Copy the Secret key from GoCardless into the Give Settings field

Copy and paste the key from GoCardless into the Give settings field and click Save changes. That’s the last step, Give is now ready for testing sandbox donations with GoCardless.

Notes on Testing GoCardless

To ensure you’re testing properly please ensure that Give is in Test Mode. Read more about Give’s Test Mode if you’re not sure how to do that. As well, to complete a donation via GoCardless use their test bank details:

Test bank details – use the GoCardless test credentials when testing your integration:

  • In the UK, use the sort code 200000 and the account number 44779911
  • In Sweden, use the clearingnummer (branch code) 5527 and the kontonummer (account number) 1234512
  • Everywhere else, use the IBAN GB60 BARC 2000 0055 7799 11

This will ensure the transaction is processed properly and redirect you back to your website’s successful donation page when complete.

Connecting to GoCardless Live

When you’re ready to accept live donations, it’s time to connect to GoCardless’ production environment. You’ll notice the process is identical to the sandbox connection described above. Here are the quick steps:

  1. Disconnect from the GoCardless Sandbox
  2. Click the “Authenticate with GoCardless” button
  3. Login with your GoCardless live account
  4. Setup the webhook URL
  5. Take Give out of Test Mode
  6. Double-check that the GoCardless gateway is enabled

After the steps above are completed your Give-powered donation forms are ready to start accepting donations.