require File.dirname(__FILE__) + '/viaklix'
module ActiveMerchant #:nodoc:
module Billing #:nodoc:
# = Elavon Virtual Merchant Gateway
#
# == Example use:
#
# gateway = ActiveMerchant::Billing::ElavonGateway.new(
# :login => "my_virtual_merchant_id",
# :password => "my_virtual_merchant_pin",
# :user => "my_virtual_merchant_user_id" # optional
# )
#
# # set up credit card obj as in main ActiveMerchant example
# creditcard = ActiveMerchant::Billing::CreditCard.new(
# :type => 'visa',
# :number => '41111111111111111',
# :month => 10,
# :year => 2011,
# :first_name => 'Bob',
# :last_name => 'Bobsen'
# )
#
# # run request
# response = gateway.purchase(1000, creditcard) # authorize and capture 10 USD
#
# puts response.success? # Check whether the transaction was successful
# puts response.message # Retrieve the message returned by Elavon
# puts response.authorization # Retrieve the unique transaction ID returned by Elavon
#
class ElavonGateway < Gateway
class_attribute :test_url, :live_url, :delimiter, :actions
self.test_url = 'https://demo.myvirtualmerchant.com/VirtualMerchantDemo/process.do'
self.live_url = 'https://www.myvirtualmerchant.com/VirtualMerchant/process.do'
self.display_name = 'Elavon MyVirtualMerchant'
self.supported_countries = ['US', 'CA']
self.supported_cardtypes = [:visa, :master, :american_express, :discover]
self.homepage_url = 'http://www.elavon.com/'
self.delimiter = "\n"
self.actions = {
:purchase => 'CCSALE',
:credit => 'CCCREDIT',
:refund => 'CCRETURN',
:authorize => 'CCAUTHONLY',
:capture => 'CCFORCE',
:void => 'CCVOID'
}
# Initialize the Gateway
#
# The gateway requires that a valid login and password be passed
# in the +options+ hash.
#
# ==== Options
#
# * :login -- Merchant ID
# * :password -- PIN
# * :user -- Specify a subuser of the account (optional)
# * :test => +true+ or +false+ -- Force test transactions
def initialize(options = {})
requires!(options, :login, :password)
@options = options
super
end
# Make a purchase
def purchase(money, creditcard, options = {})
form = {}
add_invoice(form, options)
add_creditcard(form, creditcard)
add_address(form, options)
add_customer_data(form, options)
add_test_mode(form, options)
commit(:purchase, money, form)
end
# Authorize a credit card for a given amount.
#
# ==== Parameters
# * money - The amount to be authorized as an Integer value in cents.
# * credit_card - The CreditCard details for the transaction.
# * options
# * :billing_address - The billing address for the cardholder.
def authorize(money, creditcard, options = {})
form = {}
add_invoice(form, options)
add_creditcard(form, creditcard)
add_address(form, options)
add_customer_data(form, options)
add_test_mode(form, options)
commit(:authorize, money, form)
end
# Capture authorized funds from a credit card.
#
# ==== Parameters
# * money - The amount to be captured as an Integer value in cents.
# * authorization - The approval code returned from the initial authorization.
# * options
# * :credit_card - The CreditCard details from the initial transaction (required).
def capture(money, authorization, options = {})
requires!(options, :credit_card)
form = {}
add_approval_code(form, authorization)
add_invoice(form, options)
add_creditcard(form, options[:credit_card])
add_customer_data(form, options)
add_test_mode(form, options)
commit(:capture, money, form)
end
# Refund a transaction.
#
# This transaction indicates to the gateway that
# money should flow from the merchant to the customer.
#
# ==== Parameters
#
# * money -- The amount to be credited to the customer as an Integer value in cents.
# * identification -- The ID of the original transaction against which the refund is being issued.
# * options -- A hash of parameters.
def refund(money, identification, options = {})
form = {}
add_txn_id(form, identification)
add_test_mode(form, options)
commit(:refund, money, form)
end
# Void a previous transaction
#
# ==== Parameters
#
# * authorization - The authorization returned from the previous request.
def void(identification, options = {})
form = {}
add_txn_id(form, identification)
add_test_mode(form, options)
commit(:void, nil, form)
end
# Make a credit to a card. Use the refund method if you'd like to credit using
# previous transaction
#
# ==== Parameters
# * money - The amount to be credited as an Integer value in cents.
# * creditcard - The credit card to be credited.
# * options
def credit(money, creditcard, options = {})
if creditcard.is_a?(String)
raise ArgumentError, "Reference credits are not supported. Please supply the original credit card or use the #refund method."
end
form = {}
add_invoice(form, options)
add_creditcard(form, creditcard)
add_address(form, options)
add_customer_data(form, options)
add_test_mode(form, options)
commit(:credit, money, form)
end
private
def add_invoice(form,options)
form[:invoice_number] = (options[:order_id] || options[:invoice]).to_s.slice(0, 10)
form[:description] = options[:description].to_s.slice(0, 255)
end
def add_approval_code(form, authorization)
form[:approval_code] = authorization.split(';').first
end
def add_txn_id(form, authorization)
form[:txn_id] = authorization.split(';').last
end
def authorization_from(response)
[response['approval_code'], response['txn_id']].join(';')
end
def add_creditcard(form, creditcard)
form[:card_number] = creditcard.number
form[:exp_date] = expdate(creditcard)
if creditcard.verification_value?
add_verification_value(form, creditcard)
end
form[:first_name] = creditcard.first_name.to_s.slice(0, 20)
form[:last_name] = creditcard.last_name.to_s.slice(0, 30)
end
def add_verification_value(form, creditcard)
form[:cvv2cvc2] = creditcard.verification_value
form[:cvv2cvc2_indicator] = '1'
end
def add_customer_data(form, options)
form[:email] = options[:email].to_s.slice(0, 100) unless options[:email].blank?
form[:customer_code] = options[:customer].to_s.slice(0, 10) unless options[:customer].blank?
end
def expdate(creditcard)
year = sprintf("%.4i", creditcard.year)
month = sprintf("%.2i", creditcard.month)
"#{month}#{year[2..3]}"
end
def add_address(form,options)
billing_address = options[:billing_address] || options[:address]
if billing_address
form[:avs_address] = billing_address[:address1].to_s.slice(0, 30)
form[:address2] = billing_address[:address2].to_s.slice(0, 30)
form[:avs_zip] = billing_address[:zip].to_s.slice(0, 10)
form[:city] = billing_address[:city].to_s.slice(0, 30)
form[:state] = billing_address[:state].to_s.slice(0, 10)
form[:company] = billing_address[:company].to_s.slice(0, 50)
form[:phone] = billing_address[:phone].to_s.slice(0, 20)
form[:country] = billing_address[:country].to_s.slice(0, 50)
end
if shipping_address = options[:shipping_address]
first_name, last_name = parse_first_and_last_name(shipping_address[:name])
form[:ship_to_first_name] = first_name.to_s.slice(0, 20)
form[:ship_to_last_name] = last_name.to_s.slice(0, 30)
form[:ship_to_address1] = shipping_address[:address1].to_s.slice(0, 30)
form[:ship_to_address2] = shipping_address[:address2].to_s.slice(0, 30)
form[:ship_to_city] = shipping_address[:city].to_s.slice(0, 30)
form[:ship_to_state] = shipping_address[:state].to_s.slice(0, 10)
form[:ship_to_company] = shipping_address[:company].to_s.slice(0, 50)
form[:ship_to_country] = shipping_address[:country].to_s.slice(0, 50)
form[:ship_to_zip] = shipping_address[:zip].to_s.slice(0, 10)
end
end
def parse_first_and_last_name(value)
name = value.to_s.split(' ')
last_name = name.pop || ''
first_name = name.join(' ')
[ first_name, last_name ]
end
def add_test_mode(form, options)
form[:test_mode] = 'TRUE' if options[:test_mode]
end
def message_from(response)
success?(response) ? response['result_message'] : response['errorMessage']
end
def success?(response)
!response.has_key?('errorMessage')
end
def commit(action, money, parameters)
parameters[:amount] = amount(money)
parameters[:transaction_type] = self.actions[action]
response = parse( ssl_post(test? ? self.test_url : self.live_url, post_data(parameters)) )
Response.new(response['result'] == '0', message_from(response), response,
:test => @options[:test] || test?,
:authorization => authorization_from(response),
:avs_result => { :code => response['avs_response'] },
:cvv_result => response['cvv2_response']
)
end
def post_data(parameters)
result = preamble
result.merge!(parameters)
result.collect { |key, value| "ssl_#{key}=#{CGI.escape(value.to_s)}" }.join("&")
end
def preamble
result = {
'merchant_id' => @options[:login],
'pin' => @options[:password],
'show_form' => 'false',
'result_format' => 'ASCII'
}
result['user_id'] = @options[:user] unless @options[:user].blank?
result
end
def parse(msg)
resp = {}
msg.split(self.delimiter).collect{|li|
key, value = li.split("=")
resp[key.strip.gsub(/^ssl_/, '')] = value.to_s.strip
}
resp
end
end
end
end