cardconnect 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a8573cecba2cb8cac90e17b0ce8ca92e73280253
+  data.tar.gz: 5ca366ccec6c686f6e2e19fd159e4761cd93825e
+SHA512:
+  metadata.gz: 5065e73f0951b0fe238b049dd333f8a1f3fd4c6ca2f328858b0f869a3c9e344bc8a3a42bb7ed916050c3ea1609b56529b9fc60d77086485031872b14cb401d85
+  data.tar.gz: 3561424fc95e5a43e0d2c51db6673c6cedabd8354effa6f9f76abbdd2e7e35c6ff0f4093f9132859ea3cc1e20518fc6b28a5f40ef2db976cad7316abc17f69a9

data/.gitignore

@@ -0,0 +1,18 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+.ruby-version
+.ruby-gemset
+*.iml
+.idea/

data/Gemfile

@@ -0,0 +1,11 @@
+source 'https://rubygems.org'
+
+gem 'rake'
+gem 'yard'
+
+group :test do
+  gem 'minitest', '>= 5.4'
+end
+
+# Specify your gem's dependencies in cardconnect.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 mc-pair2
+
+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,154 @@
+# CardConnect
+
+CardConnect API Ruby Wrapper
+
+[![Gem Version](https://badge.fury.io/rb/cardconnect.svg)](http://badge.fury.io/rb/cardconnect)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'cardconnect'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install cardconnect
+
+## Usage
+
+For Rails in config/initializers/cardconnect.rb
+
+NOTE: Merchant ID can also be passed in with params when building a request. If no ID is passed in then the request will use the ID from the configuration.
+
+```ruby
+CardConnect.configure do |config|
+  config.merchant_id = '<merchant-id-number>'
+  config.api_username = '<api user id>'
+  config.api_password = '<api user password>'
+  config.endpoint = 'https://url.goeshere.com:6443'
+end
+```
+
+## Services
+
+### Authorization Service
+
+CardConnect documentation for this service can be found here: http://developer.cardconnect.com/cardconnect-api/#authorization-service
+
+Example:
+
+```ruby
+service = CardConnect::Service::Authorization.new
+service.build_request(params)
+response = service.submit
+```
+
+### Capture Service
+
+CardConnect documentation for this service can be found here: http://developer.cardconnect.com/cardconnect-api/#capture-service
+
+Example:
+
+```ruby
+service = CardConnect::Service::Capture.new
+service.build_request(params)
+response = service.submit
+```
+
+### Void Service
+
+CardConnect documentation for this service can be found here: http://developer.cardconnect.com/cardconnect-api/#void-service
+
+Example:
+
+```ruby
+service = CardConnect::Service::Void.new
+service.build_request(params)
+response = service.submit
+```
+
+### Refund Service
+
+CardConnect documentation for this service can be found here: http://developer.cardconnect.com/cardconnect-api/#refund-service
+
+Example:
+
+```ruby
+service = CardConnect::Service::Refund.new
+service.build_request(params)
+response = service.submit
+```
+
+### Inquire Service
+
+CardConnect documentation for this service can be found here: http://developer.cardconnect.com/cardconnect-api/#inquire-service
+
+Example:
+
+```ruby
+service = CardConnect::Service::Inquire.new
+service.build_request(params)
+response = service.submit
+```
+
+### Settlement Status Service
+
+CardConnect documentation for this service can be found here: http://developer.cardconnect.com/cardconnect-api/#settlement-status-service
+
+Example:
+
+```ruby
+service = CardConnect::Service::SettlementStatus.new
+service.build_request(params)
+response = service.submit
+```
+
+### Deposit Service
+
+CardConnect documentation for this service can be found here: http://developer.cardconnect.com/cardconnect-api/#deposit-service
+
+Example:
+
+```ruby
+service = CardConnect::Service::Deposit.new
+service.build_request(params)
+response = service.submit
+```
+
+### Response Codes
+
+http://developer.cardconnect.com/cardconnect-api/#response-codes
+
+## To Do:
+
+#### Authorization Service
+
+* Support for custom descriptor fields
+* Support for Card Present authorizations is untested
+* Support 3D Secure processing
+
+#### Capture Service
+
+* Support for Level 3 data including items
+
+#### Funding Service
+
+* Funding Service needs to be implemented
+
+#### Profile Service
+
+* Profile Service needs to be implemented
+
+## Contributing
+
+1. Fork it ( https://github.com/mobilecause/cardconnect/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 a new Pull Request

data/Rakefile

@@ -0,0 +1,178 @@
+require "bundler/gem_tasks"
+
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+  t.pattern = "test/**/*_test.rb"
+end
+
+namespace :cardconnect do
+  require 'cardconnect'
+
+  def cardconnect_configure(args)
+    CardConnect.configure do |config|
+      config.merchant_id = args.merchant_id
+      config.api_username = args.api_username
+      config.api_password = args.api_password
+      config.endpoint = args.api_endpoint
+    end
+  end
+
+  desc "Ping the API Server"
+  task :ping, [:merchant_id, :api_username, :api_password, :api_endpoint] do |t, args|
+    cardconnect_configure(args)
+
+    response = CardConnect::Connection.new.ping_server
+    puts response.body
+  end
+
+  desc "Simulate an Authorization request"
+  task :authorize, [:capture?, :merchant_id, :api_username, :api_password, :api_endpoint] do |t, args|
+    cardconnect_configure(args)
+
+    auth_params = {
+        'account' => '4111111111111111',
+        "accttype" => "VISA",
+        'expiry' => '1220',
+        'amount' => '1000',
+        'currency' => 'USD',
+        "tokenize" => "Y"
+    }
+
+    auth_params.merge!("capture" => "Y") if args[:capture?]
+
+    auth = CardConnect::Service::Authorization.new
+    auth.build_request(auth_params)
+
+    if auth.request.valid?
+      response = auth.submit
+      puts response.body
+    else
+      puts auth.request.errors
+    end
+  end
+
+  desc "Simulate a Capture request"
+  task :capture, [:retref, :merchant_id, :api_username, :api_password, :api_endpoint] do |t, args|
+    cardconnect_configure(args)
+
+    capture_params = {
+        'merchid' => CardConnect.configuration.merchant_id,
+        'retref' => args.retref
+    }
+
+    capture = CardConnect::Service::Capture.new
+    capture.build_request(capture_params)
+
+    if capture.request.valid?
+      response = capture.submit
+      puts response.body
+    else
+      puts capture.request.errors
+    end
+  end
+
+  desc "Simulate a Void request"
+  task :void, [:retref, :merchant_id, :api_username, :api_password, :api_endpoint] do |t, args|
+    cardconnect_configure(args)
+
+    void_params = {
+        'merchid' => CardConnect.configuration.merchant_id,
+        'retref' => args[:retref]
+    }
+
+    void = CardConnect::Service::Void.new
+    void.build_request(void_params)
+
+    if void.request.valid?
+      response = void.submit
+      puts response.body
+    else
+      puts void.request.errors
+    end
+  end
+
+  desc "Simulate a Refund request"
+  task :refund, [:retref, :merchant_id, :api_username, :api_password, :api_endpoint] do |t, args|
+    cardconnect_configure(args)
+
+    refund_params = {
+        'merchid' => CardConnect.configuration.merchant_id,
+        'retref' => args[:retref]
+    }
+
+    refund = CardConnect::Service::Refund.new
+    refund.build_request(refund_params)
+
+    if refund.request.valid?
+      response = refund.submit
+      puts response.body
+    else
+      puts refund.request.errors
+    end
+  end
+
+  desc "Simulate an Inquire request"
+  task :inquire, [:retref, :merchant_id, :api_username, :api_password, :api_endpoint] do |t, args|
+    cardconnect_configure(args)
+
+    inquire_params = {
+        'merchid' => CardConnect.configuration.merchant_id,
+        'retref' => args[:retref]
+    }
+
+    inquire = CardConnect::Service::Inquire.new
+    inquire.build_request(inquire_params)
+
+    if inquire.request.valid?
+      response = inquire.submit
+      puts response.body
+    else
+      puts inquire.request.errors
+    end
+  end
+
+  desc "Simulate a Settlement Status request"
+  task :settle_status, [:date, :merchant_id, :api_username, :api_password, :api_endpoint] do |t, args|
+    # Date format is MMDD
+    cardconnect_configure(args)
+
+    settle_params = {
+        'merchid' => CardConnect.configuration.merchant_id,
+        'date' => args[:date]
+    }
+
+    status = CardConnect::Service::SettlementStatus.new
+    status.build_request(settle_params)
+
+    if status.request.valid?
+      response = status.submit
+      puts response.body
+    else
+      puts status.request.errors
+    end
+  end
+
+  desc "Simulate a Deposit request"
+  task :deposit, [:date, :merchant_id, :api_username, :api_password, :api_endpoint] do |t, args|
+    # Date format is MMDD
+    cardconnect_configure(args)
+
+    deposit_params = {
+        'merchid' => CardConnect.configuration.merchant_id,
+        'date' => args[:date]
+    }
+
+    deposit = CardConnect::Service::Deposit.new
+    deposit.build_request(deposit_params)
+
+    if deposit.request.valid?
+      response = deposit.submit
+      puts response.body
+    else
+      puts deposit.request.errors
+    end
+  end
+
+end

data/cardconnect.gemspec

@@ -0,0 +1,25 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'cardconnect/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "cardconnect"
+  spec.version       = CardConnect::VERSION
+  spec.authors       = ["Tim McKenzie", "Prashant Mokkarala", "Jason Taylor"]
+  spec.email         = ["tim@mobilecause.com", "prashant@mobilecause.com", "j.m.taylor1@gmail.com"]
+  spec.summary       = %q{CardConnect API Ruby Wrapper}
+  spec.description   = %q{CardConnect API Ruby Wrapper}
+  spec.homepage      = "http://developer.cardconnect.com/"
+  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.0'
+
+  spec.add_dependency 'faraday', '~> 0.9.0'
+  spec.add_dependency 'faraday_middleware', '~> 0.9.1'
+end

data/lib/cardconnect.rb

@@ -0,0 +1,49 @@
+require "cardconnect/version"
+
+require 'cardconnect/utils'
+require 'cardconnect/error'
+require 'cardconnect/configuration'
+require 'cardconnect/connection'
+
+require 'cardconnect/services/authorization/authorization_request'
+require 'cardconnect/services/authorization/authorization_response'
+require 'cardconnect/services/capture/capture_request'
+require 'cardconnect/services/capture/capture_response'
+require 'cardconnect/services/settlement_status/settlement_status_request'
+require 'cardconnect/services/settlement_status/settlement_status_response'
+require 'cardconnect/services/inquire/inquire_request'
+require 'cardconnect/services/inquire/inquire_response'
+require 'cardconnect/services/refund/refund_request'
+require 'cardconnect/services/refund/refund_response'
+require 'cardconnect/services/deposit/deposit_request'
+require 'cardconnect/services/deposit/deposit_response'
+require 'cardconnect/services/void/void_request'
+require 'cardconnect/services/void/void_response'
+
+require 'cardconnect/services/service_endpoint'
+require 'cardconnect/services/authorization/authorization'
+require 'cardconnect/services/capture/capture'
+require 'cardconnect/services/settlement_status/settlement_status'
+require 'cardconnect/services/inquire/inquire'
+require 'cardconnect/services/refund/refund'
+require 'cardconnect/services/deposit/deposit'
+require 'cardconnect/services/void/void'
+
+module CardConnect
+
+  class << self
+
+    def configure
+      yield(configuration)
+    end
+
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def connection
+      @connection ||= Connection.new.connection
+    end
+
+  end
+end