Need help with active_merchant?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

4.4K Stars 2.5K Forks MIT License 5.3K Commits 199 Opened issues


Active Merchant is a simple payment abstraction library extracted from Shopify. 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.

Services available


Need anything else?

Contributors list

Active Merchant

Build Status Code Climate

Active Merchant is an extraction from the ecommerce 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.

It was developed for usage in Ruby on Rails web applications and integrates seamlessly as a Rails plugin, but it also works excellently as a stand alone Ruby 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 is maintained by the Shopify and Spreedly teams, with much help from an ever-growing set of contributors.

See if you want to learn more about using Active Merchant in your applications.

If you'd like to contribute to Active Merchant, please start with our Contribution Guide.


From Git

You can check out the latest source from git:

git clone git://

From RubyGems

Installation from RubyGems:

gem install activemerchant

Or, if you're using Bundler, just add the following to your Gemfile:

gem 'activemerchant'


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

require 'active_merchant'

Use the TrustCommerce test servers

ActiveMerchant::Billing::Base.mode = :test

gateway = :login => 'TestMerchant', :password => 'password')

ActiveMerchant accepts all amounts as Integer values in cents

amount = 1000 # $10.00

The card verification value is also known as CVV2, CVC2, or CID

credit_card = :first_name => 'Bob', :last_name => 'Bobsen', :number => '4242424242424242', :month => '8', :year =>, :verification_value => '000')

Validating the card automatically detects the card type

if credit_card.validate.empty?

Capture $10 from the credit card

response = gateway.purchase(amount, credit_card)

if response.success? puts "Successfully charged $#{sprintf("%.2f", amount / 100)} to the credit card #{credit_card.display_number}" else raise StandardError, response.message end end


For more in-depth documentation and tutorials, see and the API documentation.

Emerging ActiveMerchant 3DS conventions are documented in the Contributing guide and Standardized 3DS Fields guide of the wiki.

Supported Payment Gateways

The ActiveMerchant Wiki contains a table of features supported by each gateway.

API stability policy

Functionality or APIs that are deprecated will be marked as such. Deprecated functionality is removed on major version changes - for example, deprecations from 2.x are removed in 3.x.

Ruby and Rails compatibility policies

Because Active Merchant is a payment library, it needs to take security seriously. For this reason, Active Merchant guarantees compatibility only with actively supported versions of Ruby and Rails. At the time of this writing, that means that Ruby 2.5+ and Rails 5.0+ are supported.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.