cardgate 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: daed47a0e6496785bc3b54917a82d8c08b1809e2
+  data.tar.gz: 00ed2d0e426b7b18d677b45cc48c757b713cc8ba
+SHA512:
+  metadata.gz: b1abf8bfcc18486173646f117a20c85c4caa68c0a5426211e509d13b1c5e7fda39a9774db44def8b822ad0bf917b2e267737d2500dfe050823df3eea3aeb88bd
+  data.tar.gz: 198ec6d118ba005eb80b65be016eed04ea3212ed48cbcfcfe564e8af716a0530704973875eacc3dcbcc6636f87e255082a74d195f582519294822701c0d62d87

data/.gitignore

@@ -0,0 +1,17 @@
+*.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 cardgate.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Youri van der Lans
+
+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,39 @@
+# Cardgate
+
+This gem is a client for the Cardgate REST API.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'cardgate'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install cardgate
+
+## Usage
+
+To configure this gem on rails, add the following initializer.
+
+```ruby
+unless Rails.env.production?
+  Cardgate::Gateway.environment = :test
+end
+
+Cardgate::Gateway.merchant = ''
+Cardgate::Gateway.api_key = ''
+Cardgate::Gateway.request_logger = true # or false if you want to disable request logging
+```
+
+## Contributing
+
+1. Fork it ( http://github.com/yourivdlans/cardgate/fork )
+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,14 @@
+require 'bundler/gem_tasks'
+
+require 'rake/testtask'
+
+task default: :test
+
+desc 'Run Cardgate unit tests.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+  t.warning = false
+end

data/cardgate.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'cardgate/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "cardgate"
+  spec.version       = Cardgate::VERSION
+  spec.authors       = ["Youri van der Lans"]
+  spec.email         = ["youri@itflows.nl"]
+  spec.summary       = "Cardgate REST API client"
+  spec.description   = "Provides an easy way to communicate with the cardgate REST API"
+  spec.homepage      = "https://github.com/yourivdlans/cardgate"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  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_development_dependency "bundler", "~> 1.5"
+  spec.add_development_dependency "rake", "~> 0"
+  spec.add_development_dependency "mocha", "~> 0"
+
+  spec.add_dependency "faraday", "~> 0.8"
+  spec.add_dependency "faraday_middleware", "~> 0.9"
+end

data/lib/cardgate.rb

@@ -0,0 +1,17 @@
+if !defined?(Rails)
+  require 'deep_merge'
+end
+
+require 'cardgate/callback'
+require 'cardgate/constants'
+require 'cardgate/exception'
+require 'cardgate/gateway'
+require 'cardgate/response'
+require 'cardgate/transaction'
+require 'cardgate/transactions'
+require 'cardgate/payment'
+require 'cardgate/refund'
+require 'cardgate/version'
+
+require 'cardgate/creditcard/creditcard'
+require 'cardgate/ideal/ideal'

data/lib/cardgate/callback.rb

@@ -0,0 +1,42 @@
+module Cardgate
+
+  class Callback
+
+    attr_accessor :is_test, :transaction_id, :currency, :amount, :ref, :status, :hash_key, :hash
+
+    def initialize(attributes = {})
+      attributes.each do |k,v|
+        send("#{k}=", v)
+      end
+    end
+
+    def valid?
+      hash_elements = [ @transaction_id, @currency, @amount, @ref, @status, @hash_key ]
+      hash_elements.unshift 'TEST' if @is_test.to_i == 1
+
+      Digest::MD5.hexdigest(hash_elements.join) == @hash
+    end
+
+    def response
+      "#{@transaction_id}.#{@status}"
+    end
+
+    def successful?
+      [200, 210].include?(@status.to_i)
+    end
+
+    def failed?
+      [300, 301].include?(@status.to_i)
+    end
+
+    def recurring_failed?
+      @status.to_i == 310
+    end
+
+    def refund?
+      @status.to_i == 400
+    end
+
+  end
+
+end

data/lib/cardgate/constants.rb

@@ -0,0 +1,4 @@
+module Cardgate
+  TEST_URL = 'https://api-test.cardgate.com'
+  LIVE_URL = 'https://api.cardgate.com'
+end

data/lib/cardgate/creditcard/creditcard.rb

@@ -0,0 +1 @@
+require 'cardgate/creditcard/refund'

data/lib/cardgate/creditcard/refund.rb

@@ -0,0 +1,27 @@
+module Cardgate
+
+  module Creditcard
+
+    class Refund < Cardgate::Refund
+
+      attr_accessor :descriptor
+
+      private
+
+      def provider
+        'creditcard'
+      end
+
+      def refund_params
+        {
+          refund: {
+            descriptor: @descriptor
+          }
+        }
+      end
+
+    end
+
+  end
+
+end

data/lib/cardgate/exception.rb

@@ -0,0 +1,6 @@
+module Cardgate
+
+  class Exception < StandardError
+  end
+
+end

data/lib/cardgate/gateway.rb

@@ -0,0 +1,37 @@
+require 'faraday_middleware'
+
+module Cardgate
+
+  class Gateway
+
+    class << self
+      attr_accessor :environment, :merchant, :api_key, :request_logger
+    end
+
+    def self.is_test_environment?
+      self.environment == :test
+    end
+
+    def self.request_url
+      if self.is_test_environment?
+        Cardgate::TEST_URL
+      else
+        Cardgate::LIVE_URL
+      end
+    end
+
+    def self.connection
+      raise Cardgate::Exception, 'Merchant and/or API key not set' if !self.merchant || !self.api_key
+
+      Faraday.new(url: self.request_url, ssl: { verify: !is_test_environment? } ) do |faraday|
+        faraday.request  :json
+        faraday.response :json
+        faraday.response :logger if request_logger == true
+        faraday.adapter  Faraday.default_adapter
+        faraday.basic_auth self.merchant, self.api_key
+      end
+    end
+
+  end
+
+end

data/lib/cardgate/ideal/ideal.rb

@@ -0,0 +1,4 @@
+require 'cardgate/ideal/issuer'
+require 'cardgate/ideal/issuers'
+require 'cardgate/ideal/payment'
+require 'cardgate/ideal/refund'

data/lib/cardgate/ideal/issuer.rb

@@ -0,0 +1,24 @@
+module Cardgate
+
+  module Ideal
+
+    class Issuer
+
+      attr_accessor :id, :name, :list
+
+      def initialize(id, name, list)
+        @id = id
+        @name = name
+        @list = list
+      end
+
+
+      def ==(o)
+        o.class == self.class && o.id == id
+      end
+      alias_method :eql?, :==
+    end
+
+  end
+
+end

data/lib/cardgate/ideal/issuers.rb

@@ -0,0 +1,36 @@
+module Cardgate
+
+  module Ideal
+
+    class Issuers
+
+      def self.list
+        find_all_from_api
+      end
+
+      private
+
+      def self.find_all_from_api
+        result = Cardgate::Gateway.connection.get do |req|
+          req.url '/rest/v1/ideal/issuers/'
+          req.headers['Accept'] = 'application/json'
+        end
+
+        response = Cardgate::Response.new(result)
+
+        issuers = response.body['issuers']
+
+        if !issuers.empty?
+          issuers.map do |issuer|
+            Cardgate::Ideal::Issuer.new(issuer['id'], issuer['name'], issuer['list'])
+          end
+        else
+          []
+        end
+      end
+
+    end
+
+  end
+
+end

data/lib/cardgate/ideal/payment.rb

@@ -0,0 +1,25 @@
+module Cardgate
+
+  module Ideal
+
+    class Payment < Cardgate::Payment
+
+      attr_accessor :issuer_id
+
+      def provider
+        'ideal'
+      end
+
+      def payment_params
+        {
+          payment: {
+            issuer_id: @issuer_id
+          }
+        }
+      end
+
+    end
+
+  end
+
+end

data/lib/cardgate/ideal/refund.rb

@@ -0,0 +1,17 @@
+module Cardgate
+
+  module Ideal
+
+    class Refund < Cardgate::Refund
+
+      private
+
+      def provider
+        'ideal'
+      end
+
+    end
+
+  end
+
+end

data/lib/cardgate/payment.rb

@@ -0,0 +1,90 @@
+module Cardgate
+
+  class Payment
+
+    attr_accessor :site_id, :return_url, :control_url, :ref, :amount, :currency,
+                  :language, :ip_address, :first_name, :last_name, :company_name,
+                  :address, :city, :state, :postal_code, :country_code, :phone_number, :email,
+                  :description, :provider
+
+    def initialize(attributes = {})
+      attributes.each do |k,v|
+        send("#{k}=", v)
+      end
+    end
+
+    def default_params
+      default_params = {
+        payment: {
+          site_id: @site_id,
+          currency: @currency,
+          ref: @ref,
+          return_url: @return_url,
+          control_url: @control_url,
+          currency: @currency,
+          language: @language,
+          ip_address: @ip_address,
+          description: @description,
+          amount: @amount
+        }
+      }
+
+      customer_fields = %w(first_name last_name company_name address city state postal_code country_code phone_number email)
+
+      customer_fields.each do |field|
+        var = instance_variable_get("@#{field}")
+
+        if !var.nil? && !var.empty?
+          default_params[:payment][:customer] = {} if default_params[:payment][:customer].nil?
+          default_params[:payment][:customer][field.to_sym] = var
+        end
+      end
+
+      return default_params
+    end
+
+    def initiate
+      @response ||= response
+
+      self
+    end
+
+    def payment_url
+      @response.body['payment']['issuer_auth_url']
+    end
+
+    def transaction_id
+      @response.body['payment']['transaction_id']
+    end
+
+    def params
+      default_params.deep_merge!(payment_params)
+    end
+
+    def payment_params
+      {}
+    end
+
+    def api_payment_endpoint
+      "/rest/v1/#{provider}/payment/"
+    end
+
+    def provider
+      @provider or raise Cardgate::Exception.new('Provider not set for Payment')
+    end
+
+    private
+
+    def response
+      result = Cardgate::Gateway.connection.post do |req|
+        req.url api_payment_endpoint
+        req.headers['Accept'] = 'application/json'
+        req.body = params
+      end
+
+      Cardgate::Response.new(result)
+    end
+
+  end
+
+end