Page tree
Skip to end of metadata
Go to start of metadata

Table of Contents

About GoCardless

GoCardless is the easy way to collect Direct Debit. Already serving more than 30000 businesses, perfect for recurring billing and B2B invoicing. Learn more about GoCardless on their website at

Installing GoCardless

To install the GoCardless payment gateway, visit [Settings] > [Company] > [Payment Gateways] > Available, and click the "Install" button for GoCardless.

A message will be displayed, indicating that the payment gateway was successfully installed.

Enter the details provided by GoCardless.

Access TokenEnter the Access Token that you created in your GoCardless Account. More details on creating this below.
Webhook Secret

Enter the Webhook Secret that you created in your GoCardless Account. More details on creating this below.

Payment Options

Payment Options allow you to accept one time or subscription payments. The following options are available:

  • One time and subscription payments when possible
  • One time payments only
  • Subscription payments only

We recommend "One time and subscription payments when possible".

GoCardless WebhookThis is the URL you should point your Webhook to in your GoCardless Account when creating a Webhook.
Accepted Currencies

Check the currencies that you would like to be processed through this payment gateway.

The following currencies are available:


When finished, click "Update Settings" to save the details. You have successfully installed and configured GoCardless!

Creating Access Tokens and Webhooks

To create an access token and webhook, log into your GoCardless account. Click "Developers" on the left, then the "Create" menu. Add an Access Token, then a Webhook. Your Webhook should be at least 40 characters.

Creating an Access Token

  1. Enter a Name, like "Blesta"
  2. Select "Read-write access" for scope
  3. Copy and save the Access Token that is generated by GoCardless and enter it into Blesta

Creating a Webhook

  1. Enter a name like "Blesta"
  2. Enter the Webhook API as shown in Blesta
  3. Enter a Secret that is at least 40 characters in length, and save in Blesta.

Configuration for Non-Apache Servers

GoCardless uses a non-standard header in its webhook callbacks.  In order to make sure that the header is available so that you can successfully process the webhook, you will need to modify your .htaccess file and add:

RewriteEngine On
RewriteRule .* - [e=HTTP_WEBHOOK_SIGNATURE:%{HTTP:Webhook-Signature}]

Common Issues

Problem: A customer made a payment, and it's stuck in "Pending" status.
Solution: It can take up to 5 days for the bank transfer to complete successfully. Once that has happened, the status will be updated from "Pending" to "Active".

Problem: I get the error "You must enter a valid Webhook Secret."
Answer: Make sure your Webhook Secret is at least 40 characters long.

  • No labels