HTTPS clone URL

Subversion checkout URL

Active Merchant is a simple payment abstraction library used in and sponsored by Shopify. It is written by Tobias Luetke, Cody Fauser, and contributors. The aim of the project is to feel natural to Ruby users and to abstract as many parts as possible away from the user to offer a consistent interface across all supported gateways.

README.md

Active Merchant

Active Merchant is an extraction from the e-commerce system Shopify.
Shopify's requirements for a simple and unified API to access dozens of different payment
gateways with very different internal APIs was the chief principle in designing the library.

Active Merchant has been in production use since June 2006 and is now used in most modern
Ruby applications which deal with financial transactions.

It was developed for usage in Ruby on Rails web applications and integrates seamlessly
as a plugin but it also works excellently as a stand alone library.

See {file:GettingStarted.md} if you want to learn more about using Active Merchant in your
applications.

Installation

From Git

You can check out the latest source from git:

git clone git://github.com/Shopify/active_merchant.git

As a Rails plugin

ActiveMerchant includes an init.rb file. This means that Rails will automatically load ActiveMerchant on startup. Run
the following command from the root directory of your Rails project to install ActiveMerchant as a Rails plugin:

script/plugin install git://github.com/Shopify/active_merchant.git

From RubyGems

Installation from RubyGems

gem install activemerchant

Alternatively, add the following to your Gemfile

gem 'activemerchant', :require => 'active_merchant'

Usage

This simple example demonstrates how a purchase can be made using a person's
credit card details.