Active Merchant

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 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:

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

From RubyGems

Installation from RubyGems:

geminstallactivemerchant

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

gem'activemerchant'

Usage

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

require'rubygems'require'active_merchant'# Use the TrustCommerce test servers
ActiveMerchant::Billing::Base.mode=:testgateway=ActiveMerchant::Billing::TrustCommerceGateway.new(: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=ActiveMerchant::Billing::CreditCard.new(:first_name=>'Bob',:last_name=>'Bobsen',:number=>'4242424242424242',:month=>'8',:year=>Time.now.year+1,:verification_value=>'000')# Validating the card automatically detects the card type
ifcredit_card.validate.empty?# Capture $10 from the credit card
response=gateway.purchase(amount,credit_card)ifresponse.success?puts"Successfully charged $#{sprintf("%.2f",amount/100)} to the credit card #{credit_card.display_number}"elseraiseStandardError,response.messageendend