How to Integrate Chargify with a Rails 3.x app

Many of us need to integrate a billing system in our web-based application to bill customers. Chargify is one such recurring billing management system that allows you to manage subscriptions and bill customers by integrating it with you site all validations and reports are handled by chargify and so there's no need to build a custom billing application. Its a reliable Software-as-a-Service (SaaS) offering and it supports a number of gateways worldwide.

We faced the same issue while integrating a Ruby on Rails app with Chargify.

This blog demonstrates how you can integrate chargify in your Rails3.x app and test it in the test mode.

• Chargify Account Configuration
• Sign up for a Chargify Developer Plan
• Login to it, enable API access and note down the API key.

Add a site on your Chargify account. Note down the subdomain entered during the process.

Click on the newly created site and add products. Note down the product-handle entered during this process. Note down the site shared key from Sites -> Your Site -> Settings -> Hosted Page URLs

Rails App

Download the rails demo app from this link https://github.com/newgenappsa/chargify-rails3.x

Note that official 'Chargify API wrapper for Ruby' gem is included in the Gemfile: gem 'chargify_api_ares'

Install the gem using the bundle install command

We use it to fetch transactions in the next page. The _form.html.erb view includes the fields which are displayed in the hosted url. You can choose to add optional fields per your requirement as explained in the chargify help docs.

Chargify does the validation once you submit the form and any errors from chargify can be displayed to the user as:

<%if @subscription != nil %> <% if @subscription.errors.any? %> <div id="error_explanation"> <h2><%= pluralize(@subscription.errors.count, "error") %> prohibited this payment from being saved:</h2> <ul> <% @subscription.errors.full_messages.each do |msg| %> <li><%= msg %></li> <% end %> </ul> </div> <% end %> <%end%>

In the payment_controller -> index action we find for a list of successful subscription transactions

subscriptions = Chargify::Subscription.find(session[:subscription_id]) @transactions = subscriptions.transactions

and display them in the index.html.erb as follows:

<h3>Payment History</h3> <table> <tr> <th>Date</th> <th>Type</th> <th>Amount</th> <th>Description</th> </tr> <% @transactions.each do |transaction| %> <tr> <td><%= transaction.created_at %></td> <td><%= transaction.type %></td> <td><%= ((transaction.amount_in_cents)/100).to_s + ' USD' %></td> <td><%= transaction.memo %></td> </tr> <% end %>

</table>

Note that you need to enter card number as 1 in the test mode. That's the only valid card number in the test mode. This is how you can integrate Chargify to your site. This is a most basic example. You can add other optional fields mentioned in the chargify help docs and refer chargify API to see if you need any other feature from it.

If you liked this post, do not forget to share it.