Allorails

Allorails is a Ruby client for Allopass's online payment REST API. It allows Ruby and Rails developers to easily integrate their software with the Allopass online payment platform.

Despite the name, Allorails does not require Rails, and can be used just like any ordinary Ruby gem:

gem install allorails

will install the allorails gem on your system. You can then require "allorails" from your Ruby code, which makes the Allorails class available.

Rails users, you can simply add the following line to your Gemfile

gem allorails

You can provide configuration options to Allorails by calling Allorails.config :

Allorails.config({
  :accounts => {
    :'your@account.email' => {
      :api_key => 'your-allopass-api-key',
      :private_key => 'your-allopass-private-key'
    }
  }
})

Rails users: you can put the above code in an initializer, e.g. config/initializers/allorails.rb, or use the allorails.yml configuration method explained below.

Multiple accounts can be set up by adding other email addresses to the :accounts hash.

Now that the configuration is done, let's start using the API:

api = Allorails::Api.new
response = api.get_onetime_pricing({'site_id' => YOUR_SITE_ID, 'country' => 'UK'})
puts response.creation_date

If you have set up multiple accounts, you can choose which one to use by passing the email address to Api.new: Allorails::Api.new('your@account.email')

You can put your configuration options in a yaml file located at config/allorails.yml. This file must have the same structure as the standard database.yml file found in all Rails applications, i.e. it must include a key for each environment:

development:
  accounts:
    your@account.email:
      api_key: "YOUR_API_KEY"
      private_key: "YOUR_PRIVATE_KEY" 
  
  # optional settings
  # (the values below are the defaults)
  default_hash: "sha1"
  network_timeout: 20
  network_protocol: "http"
  network_port: 80
  host: "api.allopass.com"

Allorails is inspired by the Allopass ApiKit for Python written by Pierre Geoffroy and available here.