telleroo 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e58a73456b50f8d6c1baa85d5d3908491edb20ef
+  data.tar.gz: 3c67b94c2c312a133e542c032f63af145264187a
+SHA512:
+  metadata.gz: e36502edacc356742e3bdd7dec3bf479e070bb863c834a2a7a5441a9979962c5c38259617e6afb381de112959c0fd1f4099bff1843b3e2b429e885427b918789
+  data.tar.gz: eadbe341d18c934bee16e03385055a9a93e0b4683c94a7b6fd137995dd9e16e64cb5f67a8c9291b1f8143f0a7e60478793d4030c4fbb7d5ac7816192937ec4bc

data/.gitignore

@@ -0,0 +1,12 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.3.1
+before_install: gem install bundler -v 1.14.6

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in telleroo.gemspec
+gemspec

data/Guardfile

@@ -0,0 +1,9 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard :rspec, cmd: 'bundle exec rspec' do
+  watch('spec/spec_helper.rb')                        { 'spec' }
+  watch('spec/rails_helper.rb')                       { 'spec' }
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$}) { |m| "spec/lib/#{m[1]}_spec.rb" }
+end

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 nick
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,172 @@
+# Telleroo
+
+This is a simple wrapper for the Telleroo API. API Documentation is [available here](http://docs.telleroo.com). This gem uses `MultiJson` to parse responses which are otherwise returned unadulterated.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'telleroo'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install telleroo
+
+## Configuration
+
+`Telleroo::Client` can be configured from an initializer:
+
+```
+
+  Telleroo.configure do |config|
+    config.authorization_token = "YOUR_AUTH_TOKEN"
+    config.endpoint = 'https://sandbox.telleroo.com'
+  end
+
+```
+
+or by passing an options block to `Telleroo::Client.new`
+
+```
+
+client = Telleroo::Client.new do |config|
+  config.authorization_token = "YOUR_AUTH_TOKEN"
+  config.endpoint = 'https://sandbox.telleroo.com'
+end
+
+```
+
+## Usage
+
+After configuring a `client`, the following calls are available to you:
+
+**List Accounts**
+
+Retrieves all bank accounts assigned to your company
+```
+client.accounts()
+
+```
+
+**List Recipients**
+
+Retrieves all recipients under your company.
+```
+client.recipients()
+
+```
+
+**Get Recipient**
+
+Retrieves a single recipient given a recipient_id.
+
+```
+client.get_recipient("ff17b231-2bc4-485e-967e-231867e15fd6")
+
+```
+
+**Create Recipient**
+
+Creates a single recipient.
+
+Note: `GBP` Recipients require `account_no` and `sort_code` passed in `options` while `EUR` require `iban` and `bic`.
+
+```
+client.create_recipient(name: 'Nick Lloyd',
+                        currency_code: 'GBP',
+                        options: {
+                          account_no: '72345678',
+                          sort_code: '623456'
+                        }
+                      )
+```
+
+**Delete Recipient**
+
+Retrieves a single recipient given a recipient_id.
+
+```
+client.delete_recipient("ff17b231-2bc4-485e-967e-231867e15fd6")
+
+```
+
+**Create Bank Transfer to Recipient**
+
+Triggers an instantaneous bank transfer to a existing recipient from your account. [See docs](http://docs.telleroo.com/#bank-transfers-to-recipient-id) for additional available params to pass into options.
+
+```
+client.create_transfer(
+        account_id: 'a6a2b79c-33b5-4ed5-90fd-bfb8f1d4085a',
+        currency_code: 'GBP',
+        amount: 10000,
+        recipient_id: 'ff17b231-2bc4-485e-967e-231867e15fd6',
+        idempotent_key: 'abcd-123456789-efgh',
+        options: {
+          reference: 'foobar'
+        }
+      )
+```
+
+**Create an Adhoc Bank Transfer**
+
+Send all params required to both create a Recipient and transfer funds in a single call.
+
+```
+client.create_adhoc_transfer({
+        account_id: 'a6a2b77c-33b5-4ed5-90fd-bfb8f1d4085a',
+        currency_code: 'GBP',
+        amount: 10000,
+        recipient_name: 'Rick Floyd',
+        account_no: 12345678,
+        sort_code: 665544,
+        idempotent_key: 'abcd-123456789-efgh',
+        reference: 'foo',
+        tag: 'bar',
+        reconciliation: 'baz'
+      })
+
+```
+
+**List Transactions**
+
+Returns all activity on a specified bank account. [See docs](http://docs.telleroo.com/#transactions-list) for additional available params to pass into options.
+
+```
+client.transactions(
+        account_id: 'a6a2b77c-33b5-4ed5-90fd-bfb8f1d4085a',
+        start_date: '09-06-2017',
+        end_date: '09-07-2017'
+      )
+
+```
+
+**Get Transaction**
+
+Retrieves all relevant data of a single transaction including the transfer status.
+
+```
+get_transaction(id)
+
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/playpasshq/telleroo.
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/lib/telleroo.rb

@@ -0,0 +1,25 @@
+require 'active_support/inflector'
+require 'telleroo/version'
+require 'telleroo/configuration'
+require 'telleroo/client'
+
+ActiveSupport::Inflector.inflections(:en) do |inflect|
+  inflect.acronym 'API'
+end
+
+module Telleroo
+  def self.config
+    @config ||= Configuration.new
+  end
+
+  def self.configure
+    yield config
+  end
+
+  # Return the config values set in this module
+  def self.options
+    Hash[
+      * Configuration::VALID_CONFIG_KEYS.map { |key| [key, send(key)] }.flatten
+    ]
+  end
+end

data/lib/telleroo/api.rb

@@ -0,0 +1,14 @@
+require 'telleroo/api/accounts'
+require 'telleroo/api/recipients'
+require 'telleroo/api/bank_transfers'
+require 'telleroo/api/transactions'
+
+module Telleroo
+  # Includes all API Modules
+  module API
+    include Telleroo::API::Accounts
+    include Telleroo::API::Recipients
+    include Telleroo::API::BankTransfers
+    include Telleroo::API::Transactions
+  end
+end

data/lib/telleroo/api/accounts.rb

@@ -0,0 +1,17 @@
+module Telleroo
+  module API
+    # Telleroo Accounts. These are Bank Accounts
+    module Accounts
+      # The default name of the bank account is primary account, which is
+      # accessible through a unique id. Your account number and sort code
+      # are returned here as well. All bank accounts linked to your
+      # company are returned with this request.
+
+      # Returns bank accounts list
+      # @return [Array]
+      def accounts
+        get('accounts')
+      end
+    end
+  end
+end

data/lib/telleroo/api/bank_transfers.rb

@@ -0,0 +1,87 @@
+module Telleroo
+  module API
+    # Telleroo Transfers. These are bank transfers from your
+    # Source Account to Recipient
+    module BankTransfers
+      # This triggers an instantaneous bank transfer to a existing recipient -
+      # Faster Payments per default - out of your primary account.
+      # Telleroo gives you back a unique transfer_id that can be referenced on
+      # the statement.
+      # The default currency is GBP and the format is pence (100 equals 1 GBP).
+      # All transfers are approved per default and are directly placed into
+      # the payments scheme after passing through validation
+      # (e.g. sufficient account balance).
+
+      # Instructs bank transfer to a saved recipient
+
+      # @param [String] account_id Telleroo ID of the Source Account
+      # @param [String] currency_code Currency of Account
+      # @param [Integer] amount The Amount in cents of the transfer
+      # @param [String] idempotent_key Unique key for each transaction
+      # @param [Hash] options Optional Detail
+
+      # {
+      #   "bank_transfer": {
+      #     "id": "842963c5-e230-42ef-8de8-2b7a459026",
+      #     "processed_at": "2016-12-02T12:15:22.486Z",
+      #     "transaction_type": "Debit",
+      #     "currency_code": "GBP",
+      #     "amount": 100,
+      #     "recipient_id": "ff17b231-2bc4-485e-967e-231867e15fd6",
+      #     "status": "Preparing Payment",
+      #     "status_info": "Creating payment request",
+      #     "reconciliation": "f9q3408rh3",
+      #     "reference": "PayslipDec16",
+      #     "account_id": "ed5af7d2-741c-4905-a3ba-66d332d604",
+      #     "tag": "Payroll",
+      #     "end_balance": 2100,
+      #     "idempotent_key": "2130948",
+      #     "created_at": "2017-3-08T13:15:32.237Z",
+      #     "updated_at": "2017-3-08T13:15:32.237Z"
+      #   }
+      # }
+
+      # @return [Hash]
+      def create_transfer(account_id: nil, currency_code: nil, amount: nil, recipient_id: nil, idempotent_key: nil, options: {})
+        params = {
+          account_id: account_id,
+          currency_code: currency_code,
+          amount: amount,
+          recipient_id: recipient_id,
+          idempotent_key: idempotent_key
+        }.merge(options)
+
+        post('bank_transfers', params)
+      end
+
+      # Send all params to both create a Recipient and transfer funds in
+      # a single call.
+
+      # {
+      #   "bank_transfer": {
+      #     "id": "842963c5-e230-42ef-8de8-2b7a459026",
+      #     "processed_at": "2016-12-02T12:15:22.486Z",
+      #     "transaction_type": "Debit",
+      #     "currency_code": "GBP",
+      #     "amount": 100,
+      #     "recipient_id": "ff17b231-2bc4-485e-967e-231867e15fd6",
+      #     "status": "Preparing Payment",
+      #     "status_info": "Creating payment request",
+      #     "reconciliation": "f9q3408rh3",
+      #     "reference": "PayslipDec16",
+      #     "account_id": "ed5af7d2-741c-4905-a3ba-66d332d604",
+      #     "tag": "Payroll",
+      #     "end_balance": 2100,
+      #     "idempotent_key": "2130948",
+      #     "created_at": "2017-3-08T13:15:32.237Z",
+      #     "updated_at": "2017-3-08T13:15:32.237Z"
+      #   }
+      # }
+
+      # @return [Hash]
+      def create_adhoc_transfer(params)
+        post('adhoc_bank_transfers', params)
+      end
+    end
+  end
+end

data/lib/telleroo/api/recipients.rb

@@ -0,0 +1,79 @@
+module Telleroo
+  module API
+    # Telleroo Recipients. These are Bank Accounts that receive funds
+    module Recipients
+      # Return all Recipients associated to your account
+
+      # {
+      #   "recipients": [
+      #     {
+      #       "id": "ff17b231-2bc4-485e-967e-231867e15fd6",
+      #       "name": "John Archer",
+      #       "currency_code": "GBP",
+      #       "account_no": "12345678",
+      #       "sort_code": "123456",
+      #       "legal_type": "PRIVATE"
+      #     },
+      #     {
+      #       "id": "1fdfef97-95b8-4985-917a-5d9ac9d52d35",
+      #       "name": "Antonio Silva",
+      #       "currency_code": "EUR",
+      #       "iban": "12345678901234567",
+      #       "bic": "12345678901",
+      #       "legal_type": "PRIVATE"
+      #     }
+      #   ]
+      # }
+
+      # @return [Array]
+      def recipients
+        get('recipients')
+      end
+
+      # This endpoint retrieves a single recipient by entering the recipient_id
+
+      # @param [String] id The Telleroo ID of the Recipient
+      # @return [Hash]
+      def get_recipient(id)
+        get("recipients/#{id}")
+      end
+
+      # This creates a new recipient. Telleroo gives you back a unique
+      # recipient_id that can be referenced when creating a bank transfer.
+
+      # @param [String] name The name of the Account Holder
+      # @param [String] currency_code Currency of Account
+      # @param [Hash] options Optional Account Detail
+
+      # {
+      #   "recipient": {
+      #     "id": "ff17b231-2bc4-485e-967e-231867e15fd6",
+      #     "name": "Jefke Vermeulen",
+      #     "currency_code": "GBP",
+      #     "account_no": "12345678",
+      #     "sort_code": "224657",
+      #     "legal_type": "PRIVATE"
+      #   }
+      # }
+
+      # @return [Hash]
+
+      def create_recipient(name: nil, currency_code: nil, options: {})
+        params = {
+          name: name,
+          currency_code: currency_code
+        }.merge(options)
+
+        post('recipients', params)
+      end
+
+      # This removes a recipient. Removing a recipient means you
+      # can no longer use their recipient ID.
+
+      # @param [String] id The Telleroo ID of the Recipient
+      def delete_recipient(id)
+        delete("recipients/#{id}")
+      end
+    end
+  end
+end

data/lib/telleroo/api/transactions.rb

@@ -0,0 +1,98 @@
+module Telleroo
+  module API
+    # Telleroo Accounts. These are Bank Accounts
+    module Transactions
+      # This returns all activity on a specified bank account.
+
+      # Returns transaction overview
+
+      # @param [String] account_id Telleroo ID of the Source Account
+      # @param [Date] start_date Filetr results by start date (DD-MM-YYYY)
+      # @param [Date] end_date Filter results by end date (DD-MM-YYYY)
+      # @param [Integer] page pagination
+
+      # {
+      #   "transactions": [
+      #     {
+      #       "id": "842963c5-e230-42ef-8de8-2b7a459026",
+      #       "processed_at": "2016-12-01T12:15:23.486Z",
+      #       "transaction_type": "Credit",
+      #       "currency_code": "GBP",
+      #       "amount": "1000",
+      #       "recipient_id": null,
+      #       "status": "Credited",
+      #       "status_info": "Funds successfully credited",
+      #       "reconciliation": "3456yujk",
+      #       "reference": "Funding Telleroo",
+      #       "account_id": "ed5af7d2-741c-4905-a3ba-66d332d604",
+      #       "tag": "Sponsoring",
+      #       "end_balance": 1560,
+      #       "created_at": "2016-12-01T12:15:22.486Z",
+      #       "updated_at": "2016-12-01T12:15:22.486Z"
+      #     },
+      #     {
+      #       "id": "842963c5-e230-42ef-8de8-2b7a459026",
+      #       "processed_at": "2016-12-01T12:15:23.486Z",
+      #       "transaction_type": "Debit",
+      #       "currency_code": "GBP",
+      #       "amount": "100",
+      #       "recipient_id": "122963c5-e230-42ef-8de8-327459026",
+      #       "status": "Preparing Payment",
+      #       "status_info": "Creating payment request",
+      #       "reconciliation": "f9q3408rh3",
+      #       "reference": "Withdrawal Telleroo",
+      #       "account_id": "ed5af7d2-741c-4905-a3ba-66d332d604",
+      #       "tag": "Manutd",
+      #       "end_balance": 1460,
+      #       "idempotent_key": "6130348",
+      #       "created_at": "2016-12-01T12:15:22.486Z",
+      #       "updated_at": "2016-12-01T12:15:22.486Z"
+      #     }
+      #   ]
+      # }
+
+      # @return [Array]
+      def transactions(account_id: nil, start_date: nil, end_date: nil, page: 1)
+        params = {
+          account_id: account_id,
+          start_date: start_date,
+          end_date: end_date,
+          page: page
+        }
+        get('transactions', params)
+      end
+
+      # This endpoint retrieves a single transaction by entering
+      # the transaction_id
+
+      # Show single transaction
+      # @param [String] id The Telleroo ID of the Transaction
+
+      # {
+      #   "transaction": {
+      #     "id": "842963c5-e230-42ef-8de8-2b7a459026",
+      #     "processed_at": "2016-12-01T12:15:23.486Z",
+      #     "transaction_type": "Debit",
+      #     "currency_code": "GBP",
+      #     "amount": 100,
+      #     "recipient_id": "442663c5-e230-32ef-8de8-1b7a459026",
+      #     "status": "Preparing Payment",
+      #     "status_info": "Creating payment request",
+      #     "reconciliation": "f9q3408rh3",
+      #     "reference": "Withdrawal Telleroo",
+      #     "account_id": "ed5af7d2-741c-4905-a3ba-66d332d604",
+      #     "tag": "Manutd",
+      #     "end_balance": 2200,
+      #     "idempotent_key": "6130348",
+      #     "created_at": "2016-12-02T12:15:22.486Z",
+      #     "updated_at": "2016-12-02T12:15:22.486Z"
+      #   }
+      # }
+
+      # @return [Hash]
+      def get_transaction(id)
+        get("transactions/#{id}")
+      end
+    end
+  end
+end

data/lib/telleroo/client.rb

@@ -0,0 +1,37 @@
+require 'telleroo/connection'
+require 'telleroo/request'
+require 'telleroo/api'
+
+module Telleroo
+  # Client for the Telleroo API
+  class Client
+    include Telleroo::Connection
+    include Telleroo::Request
+    include Telleroo::API
+
+    # Define the same set of accessors as the Telleroo module
+    attr_accessor *Configuration::VALID_CONFIG_KEYS
+    attr_accessor :last_response
+
+    # Initializes a new Client object
+    #
+    # @param options [Hash]
+    # @return [Telleroo::Client]
+    def initialize(options = {})
+      # Merge the config values from the module and those passed
+      # to the client.
+      merged_options = Telleroo.config.options.merge(options)
+
+      # Copy the merged values to this client and ignore those
+      # not part of our configuration
+      Configuration::VALID_CONFIG_KEYS.each do |key|
+        send("#{key}=", merged_options[key])
+      end
+      yield(self) if block_given?
+    end
+
+    def last_response
+      @last_response if defined? @last_response
+    end
+  end
+end

data/lib/telleroo/configuration.rb

@@ -0,0 +1,29 @@
+require 'active_support/configurable'
+
+module Telleroo
+  # Configuration.
+  #
+  # Allows this:
+  # Telleroo.configure do |config|
+  #   config.authorization_token = 'deadbeef'
+  #   config.endpoint = 'https://sandbox.telleroo.com'
+  # end
+
+  class Configuration
+    include ActiveSupport::Configurable
+    VALID_CONFIG_KEYS = [:authorization_token, :endpoint].freeze
+
+    config_accessor :authorization_token
+
+    config_accessor :endpoint do
+      'https://sandbox.telleroo.com'
+    end
+
+    # Return the configuration values set in this module
+    def options
+      Hash[
+        *Configuration::VALID_CONFIG_KEYS.map { |key| [key, send(key)] }.flatten
+      ]
+    end
+  end
+end

data/lib/telleroo/connection.rb

@@ -0,0 +1,20 @@
+require 'faraday'
+require 'telleroo/response/raise_client_error'
+require 'telleroo/response/raise_server_error'
+
+module Telleroo
+  # Setup Faraday Connection to use for requests
+  module Connection
+    private
+
+    def connection
+      @connection ||= Faraday.new(url: @endpoint) do |faraday|
+        faraday.use Telleroo::Response::RaiseClientError
+        faraday.use Telleroo::Response::RaiseServerError
+        faraday.headers['Authorization'] = @authorization_token
+        faraday.headers['Content-Type'] = 'application/json'
+        faraday.adapter Faraday.default_adapter
+      end
+    end
+  end
+end

data/lib/telleroo/error.rb

@@ -0,0 +1,21 @@
+module Telleroo
+  # Handle Errors returned from API
+  class Error < StandardError
+    attr_reader :http_headers
+
+    def initialize(message, http_headers)
+      @http_headers = http_headers
+      super(message)
+    end
+
+    class ServerError < Telleroo::Error; end
+    class ServiceUnavailable < Error::ServerError; end
+    class ApplicationError < Error::ServerError; end
+
+    class ClientError < Telleroo::Error; end
+    class Unauthorized < Error::ClientError; end
+    class NotAcceptable < Error::ClientError; end
+    class Unprocessable < Error::ClientError; end
+    class RateLimit < Error::ClientError; end
+  end
+end

data/lib/telleroo/request.rb

@@ -0,0 +1,40 @@
+require 'multi_json'
+
+module Telleroo
+  # Handles HTTP requests
+  module Request
+    def get(path, params = {}, options = {})
+      request(:get, path, params, options)
+    end
+
+    def post(path, params = {}, options = {})
+      request(:post, path, params, options)
+    end
+
+    def delete(path, params = {}, options = {})
+      request(:delete, path, params, options)
+    end
+
+    private
+
+    # @return [Hash]
+    def request(method, path, params, _options)
+      response = connection.run_request(method, nil, nil, nil) do |request|
+        case method.to_sym
+        when :get, :delete
+          request.url(path, params)
+        when :post
+          request.path = path
+          request.body = JSON.dump(params) unless params.empty?
+        end
+      end
+
+      @last_response = response
+      load_json(response.body) unless response.body.empty?
+    end
+
+    def load_json(response)
+      MultiJson.load(response, symbolize_keys: true)
+    end
+  end
+end

data/lib/telleroo/response/raise_client_error.rb

@@ -0,0 +1,26 @@
+require 'faraday'
+require 'telleroo/error'
+
+module Telleroo
+  module Response
+    # Handles API Response Errors
+    class RaiseClientError < Faraday::Response::Middleware
+      def on_complete(env)
+        status  = env[:status].to_i
+        body    = env[:body]
+        headers = env[:response_headers]
+
+        case status
+        when 401
+          raise Telleroo::Error::Unauthorized.new body, headers
+        when 406
+          raise Telleroo::Error::NotAcceptable.new body, headers
+        when 422
+          raise Telleroo::Error::Unprocessable.new body, headers
+        when 429
+          raise Telleroo::Error::RateLimit.new body, headers
+        end
+      end
+    end
+  end
+end

data/lib/telleroo/response/raise_server_error.rb

@@ -0,0 +1,21 @@
+require 'faraday'
+require 'telleroo/error'
+
+module Telleroo
+  module Response
+    # Handle Server Errors
+    class RaiseServerError < Faraday::Response::Middleware
+      def on_complete(env)
+        status  = env[:status].to_i
+        headers = env[:response_headers]
+
+        case status
+        when 500
+          raise Telleroo::Error::ApplicationError.new "500 Something went wrong on our end. Please try again later.", headers
+        when 503
+          raise Telleroo::Error::ServiceUnavailable.new "503 No server is available to handle this request.", headers
+        end
+      end
+    end
+  end
+end

data/lib/telleroo/version.rb

@@ -0,0 +1,3 @@
+module Telleroo
+  VERSION = '0.1.0'.freeze
+end

data/telleroo.gemspec

@@ -0,0 +1,45 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'telleroo/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'telleroo'
+  spec.version       = Telleroo::VERSION
+  spec.authors       = ['Nick Lloyd']
+  spec.email         = ['nick@playpass.be']
+
+  spec.description   = 'A Ruby interface to the Telleroo API.'
+  spec.summary       = spec.description
+  spec.homepage      = 'https://github.com/playpasshq/telleroo'
+  spec.license       = 'MIT'
+
+  # # Prevent pushing this gem to RubyGems.org. To allow pushes either set the
+  # # 'allowed_push_host' to allow pushing to a single host or delete this
+  # section to allow pushing to any host.
+  # if spec.respond_to?(:metadata)
+  #   spec.metadata['allowed_push_host'] = 'TODO:'
+  # else
+  #   raise 'RubyGems 2.0 or newer is required to protect against ' \
+  #     'public gem pushes.'
+  # end
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+  spec.add_dependency 'activesupport', '> 4'
+  spec.add_dependency 'faraday'
+  spec.add_dependency 'multi_json'
+
+  spec.add_development_dependency 'bundler', '~> 1.14'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'vcr', '~> 3.0'
+  spec.add_development_dependency 'webmock', '~> 3.0'
+  spec.add_development_dependency 'guard'
+  spec.add_development_dependency 'guard-rspec'
+end

metadata

@@ -0,0 +1,206 @@
+--- !ruby/object:Gem::Specification
+name: telleroo
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Nick Lloyd
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2017-06-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '4'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: guard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A Ruby interface to the Telleroo API.
+email:
+- nick@playpass.be
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- Guardfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/telleroo.rb
+- lib/telleroo/api.rb
+- lib/telleroo/api/accounts.rb
+- lib/telleroo/api/bank_transfers.rb
+- lib/telleroo/api/recipients.rb
+- lib/telleroo/api/transactions.rb
+- lib/telleroo/client.rb
+- lib/telleroo/configuration.rb
+- lib/telleroo/connection.rb
+- lib/telleroo/error.rb
+- lib/telleroo/request.rb
+- lib/telleroo/response/raise_client_error.rb
+- lib/telleroo/response/raise_server_error.rb
+- lib/telleroo/version.rb
+- telleroo.gemspec
+homepage: https://github.com/playpasshq/telleroo
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.12
+signing_key: 
+specification_version: 4
+summary: A Ruby interface to the Telleroo API.
+test_files: []