York UK Hosting Fork v1.1.0-YUH

This is a fork of v1.1.0 created by York UK Hosting. The fork implements the following:

1. Fixes the callback 500 error
2. Account level billing rather than product/service level. A single agreement can then used to bill for any invoice.
3. Supression of 'payment failed' emails to prevent confusion
4. Support to request GoCardless payments X days ahead of invoice due date to ensure payments are received by the due date rather than after.
5. Store the PreAuth in a separate table so that GoCardless can be used alongside a credit/debit card within a single account.

Installation:

The contents of GoCardless_WHMCS directory needs to be copied to the /modules/gateway directory. The gocardless_hook.php file in the gocardless subdirectory should be moved to /includes/hooks and the two parameters modified as required.

v6 compatibility - It has not been tested but it uses init.php and does not use any templates so will hopefully work. If you do test let me know the outcome - [email protected].

Config at gocardless.com...

Locate 'URI Settings' then populate 'Redirect URI' and 'WebHook URI'.

e.g. Redirect URI = https://www.example.com/modules/gateways/gocardless/redirect.php e.g. WebHook URI = https://www.example.com/modules/gateways/gocardless/callback.php

This fork is provided without any warranty implied or otherwise. Test in a development environment before using.

Announcement

As of 15th August 2013, the GoCardless WHMCS module will no longer be supported. You are, however, welcome to continue using the module indefinitely.

If changes to WHMCS break the module, it is likely that we will release fixes, but technical assistance will not be available.

The module is open source, so anyone is welcome to modify and distribute the module as they see fit.

GoCardless WHMCS Module

The GoCardless WHMCS module provides a simple way to use GoCardless from within WHMCS.

Requirements

You must have WHMCS version 5.1.2 or later to use this WHMCS module.

WHMCS 5.2 instructions

WHMCS introduced some breaking changes for modules. To make this module compatible with v5.2, open both redirect.php and callback.php and follow the instructions in the first couple of lines of the file.

Getting started

1. Download the latest version of the module.
2. Unzip the downloaded archive
3. Copy the contents of the GoCardless_WHMCS directory into your_whmcs_install/modules/gateways so that it replaces the existing version
4. Follow our dedicated guide to using the module on the GoCardless site

Support

As of 15th August 2013, the GoCardless WHMCS module will no longer be supported. You are, however, welcome to continue using the module indefinitely.

If changes to WHMCS break the module, it is likely that we will release fixes, but technical assistance will not be available.

The module is open source, so anyone is welcome to modify and distribute the module as they see fit.

Changelog

v1.1.0

• Designed for variable payments - now always uses a £5000 pre-auth
• Always use the "mark as paid instantly" option - WHMCS will still be updated down the line if there is a failure
• Updates descriptions on pre-authorisations and individual payments
• Prevents customers from setting up multiple pre-authorizations if there is one set up but not yet billed again for an invoice
• General bug fixes

v1.0.5

• Updates for compatability with WHMCS Version 5.2

v1.0.4

• Fixes an issue where the first payment amount differs from the recurring amount
• Improves support for WHMCS installations with SSL enabled
• Improves logging where WHMCS tries to capture payment for an invoice which already has a pending bill on GoCardless

v1.0.3

• Fixes an issue with connection to our SSL service experienced on some environments

v1.0.2

• Fixes issue with the GoCardless payment button in Internet Explorer - only affects a subset of WHMCS installations

v1.0.1

• Updates the WHMCS cron so any issues whilst collecting do not affect other payment gateways

v1.0

• Adds support for setup fees, allowing one-off products at the beginning of a recurring package
• Support for GoCardless Sandbox mode
• Added "Instant Activation" option to mark payments as paid straight away, rather than waiting for feedback from GoCardless
• Reliability improvements and bug fixes

v.01

• Initial release