Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

...

...

Overview

...

GoCardless

...

Overview

HostBill GoCardless module allows to:

...

Installing HostBill

HostBill installation is fully automated and takes just seconds, more info at Installation

 

Configuring module

  1. In HostBill go to Settings > Modules, find and activate GoCardless.com module
  2. You will be taken to Settings > Modules > Payment to configure your module
  3. Provide your Webhook secret and Access token settings available in Developer tab of your GoCardless.com account
  4. Save changes
Image Removed

Setting GoCardless.com account

  1. In HostBill go to Settings->Modules->Payment->GoCardless.com
  2. Copy Callback URL
  3. Go to GoCardless.com, login to your account and paste URIs mentioned above into Developer→Create→Webhook endpoint
  4. Enter your webhook secret, same one as entered in module configuration
  5. Save changes

How GoCardless.com works with HostBill

  • Customer choose to pay invoice using GoCardless module
  • He is redirected to GoCardless to enter his bank details for direct debits
  • Gocardless sends customer token representing his bank account to HostBill to store
  • HostBill uses this token to charge bank account using GoCardless. Token is stored in client profile
  • With each next invoice generated for customer using GoCardless module, HostBill will attempt to charge customer token stored.
  • Module will follow automation settings for captures set in Settings → Billing → Credit Cards

Image Removed

...

is a next generation online payments company. GoCardless makes it incredibly cheap and easy for anyone to take payments online using the Direct Debit infrastructure. HostBill supports GoCardless payment gateway for collecting payments out of the box.

Activating the module

...

In order to activate the module login to your HostBill admin panel, go to Settings → Modules → Payment Modules, choose GoCardless gateway and click Activate.  

Module configuration

...

Once the payment gateway is activated you need to configure it. 
Please see external articles on how to setup:

Then proceed to filling in all other configuration fields:

  1. Access token - obtained from Gocardless management dashboard → Developers → Create → Access tokens  (read-write)
  2. Webhook secret - obtained from Gocardless management dashboard → Developers → Create → Webhook Endpoint (use module's "callback url"  in webhook URL field)
  3. Test mode - when enabled module should oparete on Sandbox token from gocardless
  4. Assume successfull payment - Once enabled, as soon payment is submitted it will be added to HostBill in Processing state. Once payment is succesfull it will change transaction status in HostBill to Success. If it fails, it will be charged back in HostBill
  5. Override charge days - Enter amount of days before due date to debit, if set to 0/empty it will use HostBill global credit card capture settings
  6. Enable custom payment reference - Custom payment reference needs to be first enabled at Gocardless for your scheme identifier. Once this feature is enabled, module will send reference (invoice id) to gocardless when creating payment

All required information can be obtained once you login to your GoCardless merchant panel.

Image Added

Automated mandate captures

Automated mandate captures for this module are controlled by General Settings → Billing → eCheck/ACH/Bank/SEPA 

Image Added

FAQ

...

Question: I've enabled the module but it does not display in my client portal.
Answer: This module does not support the currency you attempt to display it in, please use background currency conversion.


Question: How to use existing GoCardless mandates?
Answer: The "mandate" field is added to the client profile when installing the GoCardless module. Once this field is filled it will be used for next GoCardless captures. To associate an existing mandate, enter the mandate ID from GoCardless - Unique identifier, beginning with “MD”. Please note that this prefix may not apply to mandates created before 2016.

Image Added


"