Our team is ready to unveil our biggest update yet: API v2 and support for multiple subscriptions on a single account. API v2 incorporates feedback we heard from our merchants and allows you to integrate with even more flexibility than ever before. For many customers, multiple subscriptions enables scenarios that were difficult workarounds with our first API.

API v2 Improvements

Over the past two years, we’ve heard from hundreds of customers that our first API works incredibly well. From day one, our REST API was designed to be easy to use. We’ve lived with it for two years and found several ways to improve it: better validation errors, more transaction details, reliable pagination, links to nested resources, easier authentication, and official support for creating plans, add-ons, and coupons via the API.

Updated Client Libraries

With the release of API v2, we’re also releasing three completely rewritten client libraries: PHP, Ruby, and Python. PHP now has better exception and error handling. The Ruby client no longer depends on ActiveResource, and it will take advantage of Nokogiri if installed for faster XML parsing. And our Python library is a dramatic update from the first version. An update to our .NET library is coming soon.

Because our API now supports better pagination, the client libraries can paginate through very long lists transparently using iterators. The libraries will automatically lazy load the next page of results when needed. The pagination also switched from page numbers to a cursor, which means the result list no longer returns duplicates if a new record is inserted while you are paginating the results.

Multi Subscription

Recurly was designed to take the pain out of subscription billing. Most merchants manage a single subscription per account and we solved that use case rather well. We took our time to really understand how successful companies manage multiple subscriptions per customer. Next, we built a new API from the ground up since we knew API v1 could never support multiple subscriptions. Finally, we added clarity to our UI to simplify multi subscription management. We hope you like the end result as much as we do.

Updated Documentation

Our documentation has been rewritten to complement our new API and client libraries. It’s fully up to date for API v2 and our client libraries. We pride ourselves on providing documentation that is clear, simple, and complete. This revision has required a complete refresh of our documentation, and we’re proud of the end result.

Recurly’s new MailChimp integration automatically updates your marketing lists in MailChimp. We also pass key customer attributes to MailChimp such as subscription status, account tenure, plan type and a number of other useful account attributes, enabling easy segmentation and filtering of your customer communication lists.

Watch this video tutorial to see how easy it is to connect your Recurly account with MailChimp.

In addition, we have posted documentation to help guide you through the specifics of your Recurly MailChimp integration.

Now you’re all set to automatically integrate your marketing communications with your subscription business.

If you like this feature, please let us know by tweeting to @recurly.

- The Recurly Team

With the Ruby client, just a few lines of code are required to start creating new subscriptions in Recurly from your Rails web app.  We designed the API to simplify the most common API requests about subscriptions.  To that end, this client library makes it incredibly easy to:

• Create a subscription and account at the same time,
• Create a subscription for a new or existing account,
• Cancel a subscription,
• Refund a subscription (full or partial),
• Update an account’s billing information (and validate the new card number or collect a balance, if there is one),
• Query subscription status (active, past due, free + plan information),
• Upgrade or downgrade the subscription
• And more…

In the near future, we’ll include a fully functional subscribe page example.  (The PHP client library has a great example already.)  In the meantime, every function of the client library is demonstrated by unit tests.

Check out our client documentation and the code.

PHP Client Updates

On a related note, the PHP client has also been updated today.  It now has support to lookup the current subscription status for a user.  And, it can perform upgrades and downgrades with a single function call.  Please see our documentation for more information, or grab it from gibhub.

As always, if you have any questions, drop us a line in our support forums and we’ll get back to you soon.

Cheers,
Isaac