= Merb Merchant

This library is a merb specific fork of the awesome gem ActiveMerchant: [http://activemerchant.org]

It aims for a lower memory footprint (no active_support dependency) and better integration with Merb view,
and configuration with Merb::Config

== Supported Direct Payment Gateways

The {ActiveMerchant Wiki}[http://github.com/Shopify/active_merchant/wikis] contains a {table of features supported by each gateway}[http://github.com/Shopify/active_merchant/wikis/gatewayfeaturematrix].

* {Authorize.Net CIM}[http://www.authorize.net/] - US
* {Authorize.Net}[http://www.authorize.net/] - US
* {Beanstream.com}[http://www.beanstream.com/] - CA
* {Braintree}[http://www.braintreepaymentsolutions.com] - US
* {CardStream}[http://www.cardstream.com/] - GB
* {CyberSource}[http://www.cybersource.com] - US
* {DataCash}[http://www.datacash.com/] - GB
* {Efsnet}[http://www.concordefsnet.com/] - US
* {eWAY}[http://www.eway.com.au/] - AU
* {E-xact}[http://www.e-xact.com] - CA, US
* {LinkPoint}[http://www.linkpoint.com/] - US
* {Modern Payments}[http://www.modpay.com] - US
* {Moneris}[http://www.moneris.com/] - CA
* {NetRegistry}[http://www.netregistry.com.au] - AU
* {NETbilling}[http://www.netbilling.com] - US
* {PayJunction}[http://www.payjunction.com/] - US
* {PaySecure}[http://www.commsecure.com.au/paysecure.shtml] - AU
* {PayPal Express Checkout}[https://www.paypal.com/cgi-bin/webscr?cmd=xpt/merchant/ExpressCheckoutIntro-outside] - US, CA, SG, AU
* {PayPal Payflow Pro}[https://www.paypal.com/cgi-bin/webscr?cmd=_payflow-pro-overview-outside] - US, CA, SG, AU
* {PayPal Website Payments Pro (UK)}[https://www.paypal.com/uk/cgi-bin/webscr?cmd=_wp-pro-overview-outside] - GB
* {PaymentExpress}[http://www.paymentexpress.com/] - AU, MY, NZ, SG, ZA, GB, US
* {PayPal Website Payments Pro (CA)}[https://www.paypal.com/cgi-bin/webscr?cmd=_wp-pro-overview-outside] - CA
* {PayPal Express Checkout}[https://www.paypal.com/cgi-bin/webscr?cmd=xpt/merchant/ExpressCheckoutIntro-outside] - US
* {PayPal Website Payments Pro (US)}[https://www.paypal.com/cgi-bin/webscr?cmd=_wp-pro-overview-outside] - US
* {Plug'n Pay}[http://www.plugnpay.com/] - US
* {Protx}[http://www.protx.com] - GB
* {Psigate}[http://www.psigate.com/] - CA
* {PSL Payment Solutions}[http://www.paymentsolutionsltd.com/] - GB
* {Quickpay}[http://quickpay.dk/] - DK
* {Realex}[http://www.realexpayments.com/] - IE, GB
* {Sage Payment Solutions}[http://www.sagepayments.com] - US, CA
* {SecurePay}[http://securepay.com.au] - AU
* {SecurePay}[http://www.securepay.com/] - US
* {SecurePayTech}[http://www.securepaytech.com/] - NZ
* {SkipJack}[http://www.skipjack.com/] - US, CA
* {TransFirst}[http://www.transfirst.com/] - US
* {TrustCommerce}[http://www.trustcommerce.com/] - US
* {USA ePay}[http://www.usaepay.com/] - US
* {Verifi}[http://www.verifi.com/] - US
* {ViaKLIX}[http://viaklix.com] - US
* {Wirecard}[http://www.wirecard.com] - DE

== Supported Offsite Payment Gateways

* {PayPal Website Payments Standard}[https://www.paypal.com/cgi-bin/webscr?cmd=_wp-standard-overview-outside]
* Chronopay[http://www.chronopay.com]
* Nochex[http://www.nochex.com]
* {Banca Sella GestPay}[https://www.sella.it/banca/ecommerce/gestpay/gestpay.jsp]
* {2 Checkout}[http://www.2checkout.com]
* {HiTRUST}[http://www.hitrust.com.hk/]

== Download

Currently this library is available with git from:

  git://github.com/merbjedi/merb_merchant.git

== Installation

=== From Git

You can check out the latest source from git:

  > git pull git://github.com/merbjedi/merb_merchant.git


=== As a Merb Plugin

dependency "merb_merchant"


=== As a Rails plugin

If you are looking for a Rails Plugin, use the original ActiveMerchant: http://activemerchant.org

=== From Ruby Gems

Installation from RubyGems

  > gem install merb_merchant

== Sample Usage
  require 'rubygems'
  require 'merb_merchant'

  # Use the TrustCommerce test servers
  MerbMerchant::Billing::Base.mode = :test

  # MerbMerchant accepts all amounts as Integer values in cents
  # $10.00
  amount = 1000

  # The card verification value is also known as CVV2, CVC2, or CID 
  credit_card = MerbMerchant::Billing::CreditCard.new(
                  :first_name         => 'Bob',
                  :last_name          => 'Bobsen',
                  :number             => '4242424242424242',
                  :month              => '8',
                  :year               => '2012',
                  :verification_value => '123'
                )

  # Validating the card automatically detects the card type
  if credit_card.valid?

    # Create a gateway object for the TrustCommerce service
    gateway = MerbMerchant::Billing::TrustCommerceGateway.new(
                :login => 'TestMerchant',
                :password => 'password'
              )

    # Authorize for the amount
    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