Payments On Rails
E-xact Transactions
(emil@e-xact.com)

<introduction>
Hello

E-xactly, who?

Payment Processor

1-866-733-8613.
Vancouver, BC

:founded => 1999,
:per_year => 3B.dollars,
:team => (2..8)

Me?

About
</introduction>

<exactonrails>
Merchants
|
E-xact
|
Payment Network

special
&&
!special

“Non-special”
• Standard Rails platform
• Plugins - Solr, cache_fu, will_paginate etc.
• Capistrano / Webistrano
• SQL Backend

Apache Proxy
(mod_security, mod_proxy_balancer,...)
|
|||
lighttpd/fastcgi
Rails

“Special”
• Mission Critical Financial services
• High Volume Transactions Processing
• Rails to the “Enterprise”

“Big Rewrite”

Win32 (.NET)

Why Rails?

2006

2006 Fall

2007 Spring

Migrated 5K Customers

Customers

RPM

Primary Provider For
</exactonrails>

<api>
api.e-xact.com

gem install exact4r

# build a purchase request
request = Exact::Request.new({
:transaction_type => \"00\", # purchase
:amount => 10.50,
:cardholder_name => \"Simon Brown\",
:cc_number => \"4111111111111111\",
:cc_expiry => \"1005\", # MUST be YYMM format
:gateway_id => \"XXXXXXX\", # which gateway to submit the request to
:password => \"YYYYYY\" # your password for that gateway
})
response = request.submit

Response
response.transaction_tag # 1234
response.exact_resp_code # \"00\"
response.exact_message # \"Transaction Normal\"
response.bank_resp_code # \"00\"
response.bank_message # \"APPROVED\"

:rest || :json || :soap

SOAP
(legacy)

REST XML
(default)

JSON

uri = URI.parse('https://api.e-xact.com')
http = Net::HTTP.new(uri.host, uri.port)
req_headers= {
'Content-Type' => 'application/json; charset=utf-8'
}
req = {}
req[:amount] = 100.to_s
req[:cardholder_name] = 'Fred Hanks'
req[:email_address] = 'fred@acme.org'
req[:address] = '2000 Elm street'
req[:cc_number] = '4111111111111111'
req[:cc_expiry] = '0907'
req[:transaction_type] = :purchase
req[:gateway_id] = 'XXXXXX'
req[:password] = 'YYYYYYY'
response = http.request_post(uri.path, req.to_json, req_headers)
res = ActiveSupport::JSON.decode(response)
assert_equal 1, res['transaction_approved'], res.inspect

Transaction set
• Purchase
• Refund
• Pre-authorization, completion
• Void
• Debit
• ....

Tagged Transaction

API
|
Cardholder Data
|
E-xact
</api>

<payment_pages>
Payment Pages

$ rails store
create
create app/controllers
create app/helpers
create app/models
create app/views/layouts
create config/environments
create config/initializers
create db
create doc
create lib
create lib/tasks
create log
....

$ ./script/install active_merchant
(http://activemerchant.org)

patch -p0 < am.patch
(http://www.e-xact.com/developers/downloads/#ActiveMerch)

Merchant Site
|
checkout.e-xact.com
|
Cardholder Data
</payment_pages>

Summary

Questions?

Contact