Today, we’re excited to announce the release of our Ruby client library for Recurly. The library is available as a Ruby gem (via gemcutter.org) or plugin. Please see the Ruby client documentation for install instructions.
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