Recurly Build Status Gem Version

REXML could not parse this XML/HTML: 

[Recurly]('s Ruby client library is an interface to its

You can also look at [rubydocs](
to see documentation on the classes and methods available.

## Installation

Recurly is packaged as a Ruby gem. We recommend you install it with
[Bundler]( by adding the following line to your Gemfile:

``` ruby
gem 'recurly', '~> 2.10.0'

Recurly will automatically use [Nokogiri]( (for a nice
speed boost) if it's available and loaded in your app's environment.

## Configuration

If you're using Rails, you can generate an initializer with the following

``` bash
$ rails g recurly:config

If you're not using Rails, use the following template:

``` ruby
Recurly.subdomain      = ENV['RECURLY_SUBDOMAIN']
Recurly.api_key        = ENV['RECURLY_API_KEY']

Configure the client library with
[your API credentials](

* `RECURLY_SUBDOMAIN` should contain subdomain for your recurly account.
* `RECURLY_API_KEY` is your "Private API Key" which can be found under "API Credentials" on the `api_access` admin page.

The default currency is USD. To override with a different code:

``` ruby
Recurly.default_currency = 'EUR' # Assign nil to disable the default entirely.

If you are using [Recurly.js]( you can store "Public API Key" (which can be found
under "API Credentials" on the `api_access` admin page):

``` ruby
Recurly.js.public_key = ENV['RECURLY_PUBLIC_API_KEY']

Then, in your Rails project you can create `recurly_service.js.erb` file and
[configure]( recurly.js with public key this way:

``` js
recurly.configure({ publicKey: '