Authorize.Net Ruby SDK¶ ↑
The Authorize.Net Ruby SDK is meant to offer an alternate object-oriented model of development with the Authorize.net APIs (Version 3.1). The SDK is based entirely off the name-value pair API, but performs the core payment activities (such as error handling/parsing, network communication, and data encoding) behind the scenes. Providing the end developer with this allows the developer to start integrating immediately without having to write out a mass of boiler plate code.
Prerequisites¶ ↑
-
Ruby 1.8.7 or higher
-
RubyGem 1.3.7 or higher (to build the gem)
-
RDoc 1.0 or higher (to build documentation)
-
Rake 0.8.7 or higher (to use the rake tasks)
Installation¶ ↑
Goto the Authorize.Net SDK download page and download the Ruby gem. Then
> gem install authorize-net-1.0.0.gem
Usage¶ ↑
Server Integration Method (SIM)¶ ↑
A generator is provided to aid in setting up a Server Integration Method application. In the example below 'payments' is the name of the controller to generate.
> sudo gem install rails -v '~> 2.1' > rails my_sim_app > cd my_sim_app > script/generate authorize_net_sim payments YOUR_API_LOGIN_ID YOUR_TRANSACTION_KEY MERCH_HASH_KEY > script/server
After running the generator you will probably want to customize the payment page found in 'app/views/payments/payment.erb' and the thank you page found in 'app/views/payments/thank_you.erb'.
You may also want to customize the actual payment form and receipt pages. That can be done by making the necessary changes to the AuthorizeNet::SIM::Transaction
object ('@sim_transaction') found in the payment
action in 'app/controllers/payments_controller.rb'. The styling of those hosted pages are controlled by the AuthorizeNet::SIM::HostedReceiptPage
and AuthorizeNet::SIM::HostedPaymentForm
objects (which are passed to the AuthorizeNet::SIM::Transaction
).
There is also a default layout generated, 'app/views/layouts/authorize_net.erb'. If you already have your own layout, you can delete that file and the reference to it in the controller ('app/controllers/payments_controller.rb').
Credit Card Test Numbers¶ ↑
For your reference, you can use the following test credit card numbers. The expiration date must be set to the present date or later. Use 123 for the CCV code.
- American Express
-
370000000000002
- Discover
-
6011000000000012
- Visa
-
4007000000027
- JCB
-
3088000000000017
- Diners Club/ Carte Blanche
-
38000000000006