Recurly | Drupal 8 Project | Drupal 8

Recurly | Drupal 8 Project


Project Name : Recurly
Drupal.org project Link : Recurly
Created : 2016-05-27
Last Update : 2018-01-22
Current Version : 8.x-1.3
Download Recurly 8.x-1.3 Version From Drupal.org : Download

This project integrates Drupal with Recurly, a subscription billing service that takes the headache out of subscription management. It can work in conjunction with your existing payment gateway or merchant account (see the list of supported payment gateways) or you can use the included Recurly Gateway (which is included free with all accounts).

This project includes a few sub-modules that allow users to choose how deeply they wish to integrate their Drupal site with Recurly:

  • Recurly: The main Recurly module provides basic Drupal integration, including receiving push notifications from Recurly.com. It also includes built-in pages for users to view invoices, subscriptions, and to upgrade/downgrade their subscription level.
  • Recurly Hosted Pages: Rather than hosting account management yourself, you can use Recurly.com to handle all aspects of subscription management through their hosted pages option. This requires the least amount of integration with Drupal, thus the least responsibility for customer data. Recurly's hosted pages are PCI-DSS Level 1 compliant. Sites using this solution will still need to comply with the shortened self-assessment questionnaire (SAQ-A) to meet PCI compliance on their own site.
  • Recurly.js: Recurly provides a client-side credit card authorization mechanism called Recurly.js that interacts with the payment gateway through JavaScript. Because the credit card information is not processed by your server, your responsibility is dramatically reduced. Like the Hosted Pages solution, you may achieve PCI compliance through the shortened self-assessment questionnaire (SAQ-A). This approach allows users to make payments from within your site but with the least responsibility possible.

For more information about Recurly and PCI-compliance, see the Recurly documentation on PCI-compliance.

This module uses Recurly's PHP client library to provide various points of integration with Drupal.

Here's a blog post with details on getting started with this module and Recurly.js: Integrating Recurly and Drupal. And a blog post on testing Recurly webhooks locally: Testing Recurly Webhooks with Ngrok.

8.x-1.0: This is our initial Drupal 8 development release - issues can be found in the issue queue, please help test and patch!

7.x-2.0: This release updates the Recurlyjs module to use v3 of the Recurly.js library. This release was sponsored by TheaterMania and Chromatic. As always with a dev release, this requires testing before putting into production.

Change notes:
#2296401: Recurly.js v3 - Updated to use Recurly.js v3. The library is now dynamically loaded and no longer needs to be downloaded and placed in your codebase. When upgrading from 7.x-1.x to 7.x-2.x, you can delete the recurlyjs library.

  • The recurlyjs module no longer uses custom form elements.
  • Recurlyjs is now configured with a Public Key, not the Transparent Post key.
  • The billing forms are now created by Drupal, not Recurly, but processed by Recurly, as detailed above.
  • The dev release does not yet have PayPal or bank account support.
  • Form elements have been changed and the existing css no longer applies, this needs a refactor.

Installation instructions

  1. Download and install the module Libraries API 7.x-2.x.
  2. Download the Recurly PHP client library into your site's sites/all/libraries/recurly directory.
  3. Download and install this module.
  4. Copy/paste the Private API Key and Public Key from Recurly.com into your Drupal site. These can be found by logging in to Recurly and going to developer/api_access.
  5. Copy/paste the push notification URL from Drupal into Recurly.com.
  6. Read the full README for complete instructions.