datacash 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: fcc6b1f0993e561e5b5e93d37d6e4cef4445bc8e
+  data.tar.gz: 133a4c6c605c49911cc3e02d644d2c80503a0dc2
+SHA512:
+  metadata.gz: 0c06d551c2beedc9015f32c8e761d8e220c176eb02c7a4c6e58cdf9a4ec3595b73a8983dc2636c125bed7b94bb755cdc8781493d695a171711e06feb29855601
+  data.tar.gz: b93e1fad07c9ebc94de5017339acdcc9e53b40f0ca59eae483ccd1418697cbd88feab2166a92acbef1a993a3c4981331058e8053e9399a281c0115a532b976a7

data/.gitignore

@@ -0,0 +1,18 @@
+.rspec
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Robert Williams, Richard Grundy
+
+MIT License
+
+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,48 @@
+# Datacash
+
+This is an unofficial library!
+
+DataCash, a MasterCard Company, is an international provider of credit / 
+debit card processing and industry leading fraud / risk management solutions.
+
+This library provides an idiomatic interface to the DataCash gateway. I would 
+highly recommend reading the DataCash Developers Guide which is available in the
+[Developers Area](https://testserver.datacash.com/software/download.cgi). You will
+will need a [test login](https://testserver.datacash.com/software/integration.shtml)
+to be able to download the developers guide and to play with the gateway.
+
+## Configuration
+
+```ruby
+# Gemfile
+gem 'datacash'
+
+# config/initializers/datacash.rb
+Datacash.configure do |config|
+  config.client = "123456"
+  config.password = "password1234"
+  config.environment = :live || :test
+end
+# or
+Datacash.configuration.client = "123456"
+```
+
+## Usage
+
+You can play with the library using the console. Run ```rake console```
+then configure using the method above.
+
+### Query
+
+```ruby
+reference = "3403410491041490149314"
+Datacash::Client.new.query(reference) # => Datacash::Response::Response
+```
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,9 @@
+require "bundler/gem_tasks"
+
+task :console do
+  require 'datacash'
+  include Datacash
+
+  require 'pry'
+  binding.pry
+end

data/datacash.gemspec

@@ -0,0 +1,34 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'datacash/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "datacash"
+  spec.version       = Datacash::VERSION
+  spec.authors       = ["Robert Williams", "Richard Grundy"]
+  spec.email         = ["rob@r-williams.com", "richguk@gmail.com"]
+  spec.description   = "This library provides an idiomatic interface to the DataCash gateway."
+  spec.summary       = "This library provides an idiomatic interface to the DataCash gateway."
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "builder"
+  spec.add_dependency "hashie"
+  spec.add_dependency "activesupport"
+  spec.add_dependency "multi_xml", "~> 0.5.3"
+  spec.add_dependency "rest-client", "~> 1.6"
+  spec.add_dependency 'gem_config'
+
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "pry"
+  spec.add_development_dependency "webmock"
+end

data/lib/datacash.rb

@@ -0,0 +1,51 @@
+require 'date'
+
+require 'gem_config'
+require 'rest_client'
+require 'builder'
+require 'multi_xml'
+require 'hashie'
+require 'active_support/core_ext/hash/conversions'
+require 'hashie/extensions/structure'
+
+require 'datacash/exceptions'
+
+module Datacash
+  include GemConfig::Base
+
+  TIME_FORMAT = '%Y%m%d %H:%M:%S'
+
+  with_configuration do
+    has :client, classes: String
+    has :password, classes: String
+    has :environment, values: [:test, :live], default: :test
+  end
+
+  autoload :Client, 'datacash/client'
+
+  module Request
+    autoload :Amount,                 'datacash/request/amount'
+    autoload :Authentication,         'datacash/request/authentication'
+    autoload :Base,                   'datacash/request/base'
+    autoload :Browser,                'datacash/request/browser'
+    autoload :Card,                   'datacash/request/card'
+    autoload :Cv2Avs,                 'datacash/request/cv2avs'
+    autoload :CardTransaction,        'datacash/request/card_transaction'
+    autoload :HistoricTransaction,    'datacash/request/historic_transaction'
+    autoload :HpsTransaction,         'datacash/request/hps_transaction'
+    autoload :Request,                'datacash/request/request'
+    autoload :ThreeDSecure,           'datacash/request/three_d_secure'
+    autoload :Transaction,            'datacash/request/transaction'
+    autoload :TransactionDetails,     'datacash/request/transaction_details'
+    autoload :Thirdman,               'datacash/request/thirdman'
+  end
+
+  module Response
+    autoload :AuthAttempts,           'datacash/response/auth_attempts'
+    autoload :Base,                   'datacash/response/base'
+    autoload :Card,                   'datacash/response/card'
+    autoload :HpsTransaction,         'datacash/response/hps_transaction'
+    autoload :QueryTransactionResult, 'datacash/response/query_transaction_result'
+    autoload :Response,               'datacash/response/response'
+  end
+end

data/lib/datacash/client.rb

@@ -0,0 +1,61 @@
+module Datacash
+  class Client
+
+    ENDPOINTS = {
+      live: "https://mars.transaction.datacash.com/Transaction",
+      test: "https://accreditation.datacash.com/Transaction/cnp_a"
+    }.freeze
+
+    def initialize(options={})
+      @client      = options.fetch(:client, Datacash.configuration.client)
+      @password    = options.fetch(:password, Datacash.configuration.password)
+      @environment    = options.fetch(:environment, Datacash.configuration.environment)
+      @rest_client = options.fetch(:rest_client, RestClient)
+    end
+
+    def post(request)
+      prepare_request(request)
+
+      handle_response do 
+        rest_client.post(
+          endpoint,
+          request.to_xml, 
+          content_type: :xml, 
+          accept: :xml
+        )
+      end
+    end
+
+    def query(datacash_reference)
+      request = Request::Request.new(transaction: {
+        historic_transaction: { 
+          method: "query", reference: datacash_reference
+        }
+      })
+      post(request)
+    end
+
+    private
+    attr_reader :rest_client, :environment, :client, :password
+
+    def parse_response_to_hash(response)
+      MultiXml.parse(response, :symbolize_keys => true)[:Response]
+    end
+
+    def endpoint
+      ENDPOINTS[environment]
+    end
+
+    def prepare_request(request)
+      request.add_authentication(client: client, password: password)
+    end
+
+    def handle_response(&block)
+      response = Response::Response.new(parse_response_to_hash(yield))
+      if response.reason =~ /invalid client\/pass/i
+        raise AuthenticationError, response
+      end
+      response
+    end
+  end
+end

data/lib/datacash/exceptions.rb

@@ -0,0 +1,3 @@
+module Datacash
+  class AuthenticationError < StandardError; end;
+end

data/lib/datacash/request/amount.rb

@@ -0,0 +1,14 @@
+module Datacash
+  module Request
+    class Amount < Base
+      root 'amount'
+
+      key :amount, default: '0.00'
+
+      def to_xml(options={})
+        xml = options[:builder] ||= Builder::XmlMarkup.new
+        xml.tag!(self.class.root, self[:amount], currency: self[:currency])
+      end
+    end
+  end
+end

data/lib/datacash/request/authentication.rb

@@ -0,0 +1,7 @@
+module Datacash
+  module Request
+    class Authentication < Base
+      root "Authentication"
+    end
+  end
+end

data/lib/datacash/request/base.rb

@@ -0,0 +1,37 @@
+module Datacash
+  module Request
+    class Base < Hash
+      include Hashie::Extensions::Coercion
+      include Hashie::Extensions::MergeInitializer
+
+      def initialize(*args)
+        self.class.keys.each do |key, options|
+          self[key] = options.fetch(:default, nil)
+        end
+        super
+      end
+
+      def self.keys
+        @keys ||= {}
+      end
+
+      def self.key(key, options={})
+        keys[key] = options
+      end
+
+      def self.root(name=nil)
+        @root = name if name
+        @root
+      end
+
+      def to_xml(options = {})
+        super(options.merge(
+          root: self.class.root,
+          skip_types: true,
+          indent: 0,
+          dasherize: false
+        ))
+      end
+    end
+  end
+end

data/lib/datacash/request/browser.rb

@@ -0,0 +1,11 @@
+module Datacash
+  module Request
+    class Browser < Base
+      root "Browser"
+
+      key :device_category, default: 0
+      key :accept_headers, default: '*/*'
+      key :user_agent, default: 'Mozilla/5.0'
+    end
+  end
+end

data/lib/datacash/request/card.rb

@@ -0,0 +1,9 @@
+module Datacash
+  module Request
+    class Card < Base
+      root "Card"
+
+      coerce_key :cv2avs, Cv2Avs
+    end
+  end
+end

data/lib/datacash/request/card_transaction.rb

@@ -0,0 +1,11 @@
+module Datacash
+  module Request
+    class CardTransaction < Base
+      root "CardTxn"
+
+      coerce_key :card, Card
+
+      key :method, default: 'auth'
+    end
+  end
+end

data/lib/datacash/request/cv2avs.rb

@@ -0,0 +1,7 @@
+module Datacash
+  module Request
+    class Cv2Avs < Base
+      root "Cv2Avs"
+    end
+  end
+end

data/lib/datacash/request/historic_transaction.rb

@@ -0,0 +1,8 @@
+module Datacash
+  module Request
+    class HistoricTransaction < Base
+      root "HistoricTxn"
+      key :method, default: 'query'
+    end
+  end
+end

data/lib/datacash/request/hps_transaction.rb

@@ -0,0 +1,8 @@
+module Datacash
+  module Request
+    class HpsTransaction < Base
+      root "HpsTxn"
+      key :method, default: 'setup_full'
+    end
+  end
+end

data/lib/datacash/request/request.rb

@@ -0,0 +1,19 @@
+module Datacash
+  module Request
+    class Request < Base
+      root "Request"
+
+      coerce_key :authentication, Authentication
+      coerce_key :transaction, Transaction
+
+      key :authentication, default: Authentication.new
+      key :transaction, default: Transaction.new
+
+      def add_authentication(options = {})
+        self[:authentication] ||= {}
+        self[:authentication][:client]   = options.fetch(:client)
+        self[:authentication][:password] = options.fetch(:password)
+      end
+    end
+  end
+end

data/lib/datacash/request/thirdman.rb

@@ -0,0 +1,23 @@
+module Datacash
+  module Request
+    class Thirdman < Base
+      root "The3rdMan"
+
+      class CustomerInformation < Base
+        root "CustomerInformation"
+      end
+
+      class DeliveryAddress < Base
+        root "DeliveryAddress"
+      end
+
+      class BillingAddress < Base
+        root "BillingAddress"
+      end
+
+      coerce_key :customer_information, CustomerInformation
+      coerce_key :delivery_address, DeliveryAddress
+      coerce_key :billing_address, BillingAddress
+    end
+  end
+end