GoCardless

The GoCardless extension provides the integration between WooCommerce and the UK-based, direct-debit GoCardless payment gateway, so store owners may collect online payments.

Bank Payments only appears as a payment method if the customer’s billing country is in:

• Australia (AU)
• New Zealand (NZ)
• United States (US)
• Canada (CA)

or on the list of SEPA countries:

• Austria (AT), Belgium (BE), Bulgaria (BG), Switzerland (CH), Cyprus (CY), Czech Republic (CZ), Denmark (DK), Estonia (EE), Finland (FI), France (FR), Germany (DE), United Kingdom (GB), Greece (GR, Croatia (HR), Hungary (HU), Ireland (IE), Iceland (IS), Italy (IT), Liechtenstein (LI), Latvia (LV), Lithuania (LT), Luxembourg (LU), Malta (MT), Monaco (MC), Netherlands (NL), Norway (NO), Poland (PL), Portugal (PT), Romania (RO), Sweden (SE), San Marino (SM), Slovakia (SK), Slovenia (SI), Spain (ES).

While GoCardless can collect from customers in the above countries, note that GoCardless can only on-board merchants from:

• Austria
• Australia
• Belgium
• Denmark
• Finland
• France
• Germany
• Ireland
• Luxembourg
• Netherlands
• Spain
• Sweden
• United Kingdom
• United States
• Canada

• GoCardless account
• SSL Certificate with https:// included in path, e.g., https://example.com/wc-api/WC_Gateway_GoCardless/
• WooCommerce version 8.4 or higher
• WordPress version 6.1 or higher
• PHP version 7.2 or higher

1. Download the .zip file from your WooCommerce account.
2. Go to: WordPress Admin > Plugins > Add New and Upload Plugin with the file you downloaded with Choose File.
3. Install Now and Activate the extension.

More information at: Install and Activate Plugins/Extensions.

To use GoCardless, you need an existing or new merchant account. To sign up for a new (free) account:

1. Go to: gocardless.com
2. Select Sign Up Now.
3. Complete all fields (required).
4. Select Create Your Account.

You can also sign up for GoCardless from the plugin settings. However, if you go this route, the instructions will be slightly different than described below in Setup and Configuration.

There are two parts to setting up GoCardless on your WooCommerce Store: Connecting your GoCardless account and configuring GoCardless settings in your WooCommerce store.

After installing the GoCardless gateway plugin, the first step is to connect your GoCardless account. Here’s how to connect it: 

1. Go to WooCommerce > Settings > Payments.
2. Click the toggle under Enabled to activate Bank pay (open banking and direct debit via GoCardless).
3. Select Finish set up. You are taken to Bank pay (open banking and direct debit via GoCardless) settings.
   
4. Select Connect with GoCardless.
5. Log in to your GoCardless account. If you haven’t yet created an account, select Sign Up.
   
6. If successful, an authentication notice will appear.
7. Select the That’s My Site – Redirect Me button.
   
8. Skip down to GoCardless Sync.
   
9. Click the Dashboard link. A new window opens at GoCardless.
10. Enter info in the Create Webhook Endpoint screen.
    • Name: Copy the Name from the GoCardless Sync section and paste it.
    • URL: Copy the URL from the GoCardless Sync section and paste it.
    • Secret: Copy the Secret from the GoCardless Sync section and paste it.
    • Webhook client certificate: Can be deselected
      
11.  Select the Create Webhook Endpoint button.
12.  Close the GoCardless webhooks endpoints window.
13.  Return to the Bank pay (open banking and direct debit via GoCardless) settings screen at your store.
14.  Save changes.

Stay on this screen for next steps.

Once you’ve connected your GoCardless account and WooCommerce store, to finish setting up your payment gateway configure the following settings:

• Enable/Disable – Turn on or turn off.
• Title – Enter a name displayed in checkout. Default is “Pay by bank”.
• Description – Enter what the user sees in the checkout. Default is: “Pay securely via your bank account.”
• Direct Debit Scheme – Select a scheme. Default is: Automatically detected from the customer’s bank account
• Instant Bank Pay – Enable Instant Bank Pay to collect payments instantly using open banking wherever it is supported. By default, this feature is disabled and needs to be enabled to be used.
• Log debug messages – Enabled and useful for troubleshooting purposes, if/when issues arise.
• Save changes.

If you want to test the GoCardless gateway in sandbox before going live, this section describes the steps you need to take to enable sandbox mode.

1. Disconnect from GoCardless if you are connected. If you are already disconnected, go to step 2.
   
2. Select the “Not ready to accept live payments?” link.
   
3. Repeat the above setup and configuration for setting up a live environment for the test environment.
4. Test transactions using GoCardless test credentials.
   • In the UK, use the sort code 200000 and the account number 55779911
   • 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

When you are ready to go live, use the following steps:

1. Use your live credentials and not the test credentials
2. Connect to GoCardless
3. Enable Direct Debit (GoCardless) on your WooCommerce site

When checking out with GoCardless active, customers see an option for GoCardless which allows them to pay via Direct Debit or Instant Bank Pay (if enabled). There is also an option to save payment information. This section describes the customer checkout experience using these options and the steps they follow to complete their orders.

The GoCardless Payment Gateway supports collecting payments using the following methods:

• Instant Bank Pay: Enables collection of payment on the spot with instant confirmation. Available for UK (GBP), Germany (EURO), and France (EURO) payments for now, with more schemes coming soon (see more details). By default, Instant Bank Pay is disabled, and payments are collected using Direct Debit setup. You can enable it from the GoCardless settings in your WooCommerce store.

• Direct Debit: Collects customers’ bank details and authorization for the collection of future payments by Direct Debit.

When the customer tries to complete the order, a GoCardless JavaScript Drop-in will open to collect payment. This creates a mandate (a direct debit authorization from the customer to collect future payments) and then collects payment for the order.

Customers may also choose to securely save payment information so they need not re-enter for future transactions. Instead, they would select an option:

Once the customer completes the steps in the Drop-in, the order will be placed, and the standard WooCommerce order confirmation will be shown:

Opening the order screen, you see all the details. GoCardless gives the status of those transactions via the webhook.

Note that direct debit payments don’t process instantly and work differently than card payments. More info at: How Direct Timings Work.

Yes, the GoCardless extension supports BACS and the payment methods mentioned in the GoCardless API documentation.

While GoCardless can collect from customers from many countries, note that GoCardless can only on-board merchants from Austria, Belgium, Finland, France, Germany, Ireland, Luxembourg, Netherlands, Spain, Sweden, United Kingdom, United States, and Canada.

Yes, you need to manually fill in the webhook secret and configure the webhook endpoint. It cannot be automated, so we made it as painless as possible.

The selection is automated and depends on two things: first, whether Instant Bank payments are supported for both the customer and the merchant, and second, the items being purchased. For example, Instant Bank Pay will be used for simple product purchases where the customer’s billing address is in the UK (GBP), Germany (EURO), and France (EURO). Similarly, for the same setup, subscription product purchases will be completed using the Instant Bank Payment and Direct Debit (mandate) setup flow. For countries and currencies where instant payment is not supported, the Direct Debit (mandate) only flow will be used.

GoCardless collects payments by setting up a Direct Debit (Mandate). This Direct Debit mandate can be used to collect future payments. Even for a simple product, GoCardless sets up a Direct Debit and collects the payment under the mandate. As a result, every payment—whether for a one-time purchase or a subscription—is processed via this Direct Debit (Mandate), which is recurrent. Therefore, transactions appear as recurrent.
It is important to note that for merchants and customers in the UK (GBP), Germany (EUR), and France (EUR), GoCardless supports Instant Bank Pay (IBP). IBP allows for one-off payments that are collected instantly without setting up a Direct Debit, and these transactions are not marked as recurrent.

If you use a security or firewall plugin or have a firewall application on your server, be sure that you allow requests from GoCardless in that plugin’s settings. GoCardless sends webhooks from the following IP addresses which you may wish to add to your firewall’s approved list:

• 35.204.73.47
• 35.204.191.250
• 35.204.214.181

Ensure that you’re verified by GoCardless, as no payouts are made until this is done. Keep an eye out for emails from GoCardless, and check your Spam folder, as you are also notified when funds are waiting.

Yes. As described in the Usage section, customers may opt to securely store payment information for future checkout.

GoCardless includes support for WooCommerce Pre-Orders (separate purchase).

Yes, it’s possible to use GoCardless to accept automatic, recurring payments for WooCommerce Subscriptions (separate purchase).

Merchants need only click the Connect button to hook up their GoCardless account. It’s not necessary to Create an App.

Create an App is for developers seeking to code their own applications from scratch and not use the GoCardless for WooCommerce extension or any other already made.

Yes. As of version 2.4.5, WooCommerce GoCardless includes support for merchants upgrading to Pro and/or Plus. It:

• Notifies via webhook with event “mandate_replaced” with the new mandate in the payload.
• Gives an error response about mandate replacement when payment is created with the old mandate.

woocommerce_gocardless_after_billing_request_fulfilled - do_action( 'woocommerce_gocardless_after_billing_request_fulfilled', $billing_request );

This action hook can be used to further manipulate information after a billing request is fulfilled. One such example would be to update the customer information on the GoCardless side.  Here’s how the snippet can be formatted to achieve that:

add_action( 'woocommerce_gocardless_after_billing_request_fulfilled', 'process_billing_request' );

function process_billing_request( $billing_request ) {
    $customer_id = wc_clean( $billing_request['links']['customer'] );
    $data        = array(); // Add customer data here
    WC_GoCardless_API::update_customer( $customer_id, $data );
}

Now, there are three filters for updating initial order status:

• woocommerce_gocardless_create_payment_subscription_order_status — default to processing. Triggered when an order contains a Subscription product
• woocommerce_gocardless_create_payment_subscription_renewal_order_status — default to processing. Triggered when an order contains a Subscription renewal
• woocommerce_gocardless_create_payment_order_status — default to on-hold