cardconnect 1.0.0

data/lib/cardconnect/utils.rb

@@ -0,0 +1,22 @@
+module CardConnect
+  module Utils
+
+    def set_attributes(attributes, fields)
+      return if attributes.empty?
+      attributes = symbolize_keys(attributes)
+      fields.each do |attr|
+        next unless attributes[attr]
+        send("#{attr}=", attributes[attr])
+      end
+    end
+
+    def symbolize_keys(hash)
+      symbolized_hash = {}
+      hash.each do |k, v|
+        symbolized_hash[k.to_sym] = v
+      end
+      symbolized_hash
+    end
+
+  end
+end

data/lib/cardconnect/version.rb

@@ -0,0 +1,3 @@
+module CardConnect
+  VERSION = "1.0.0"
+end

data/test/api_request_stubs.rb

@@ -0,0 +1,83 @@
+def valid_auth_request
+  {
+      "merchid" => "000000927996",
+      "accttype" => "VISA",
+      "orderid" => "AB-11-9876",
+      "account" => "4111111111111111",
+      "expiry" => "1212",
+      "amount" => "0",
+      "currency" => "USD",
+      "name" => "TOM JONES",
+      "address" => "123 MAIN STREET",
+      "city" => "anytown",
+      "region" => "NY",
+      "country" => "US",
+      "postal" => "55555",
+      "phone" => "3334445555",
+      "email" => "tom@jones.com",
+      "ecomind" => "E",
+      "cvv2" => "123",
+      "track" => "Y",
+      "tokenize" => "Y",
+      "capture" => "Y",
+      "bankaba" => "1010101",
+      "termid" => "12345",
+      "ssnl4" => "1234",
+      "license" => "CO:1231231234",
+      "profile" => "Y",
+      "userfields" => [
+          {
+              "name0" => "value0"
+          },
+          {
+              "name1" => "value1"
+          }
+      ]
+  }
+end
+
+def valid_capture_request
+  {
+      "retref" => "288002073633",
+      "amount" => "596.00",
+      "taxamnt" => "40.00",
+      "merchid" => "000000927996",
+      "ponumber" => "PO-0736332",
+      "authcode" => "046221",
+      "invoiceid" => "7890"
+  }
+end
+
+def valid_inquire_request
+  {
+      'retref' => '288002073633',
+      'merchid' => '000000927996'
+  }
+end
+
+def valid_settlestat_request
+  {
+      "merchid" => "000000927996",
+      "date" => "0110"
+  }
+end
+
+def valid_refund_request
+  {
+      "retref" => "288009185241",
+      "merchid" => "000000927996",
+      "amount" => "59.60"
+  }
+end
+
+def valid_deposit_request
+  valid_settlestat_request
+end
+
+def valid_void_request
+  {
+      "retref" => "288013185633",
+      "merchid" => "000000927996",
+      "amount" => "101"
+  }
+end

data/test/api_response_stubs.rb

@@ -0,0 +1,120 @@
+def valid_auth_response
+  {
+      "respstat" => "A",
+      "account" => "41XXXXXXXXXX1111",
+      "token" => "9419786452781111",
+      "retref" => "343005123105",
+      "amount" => "111",
+      "merchid" => "020594000000",
+      "respcode" => "00",
+      "resptext" => "Approved",
+      "avsresp" => "9",
+      "cvvresp" => "M",
+      "authcode" => "046221",
+      "respproc" => "FNOR",
+      "commcard" => "N"
+  }
+end
+
+def valid_capture_response
+  {
+      "amount" => "596.00",
+      "setlstat" => "Pending",
+      "retref" => "288002073633",
+      "merchid" => "000000927996",
+      "account" => "41XXXXXXXXXX4113"
+  }
+end
+
+def valid_inquire_response
+  {
+      "amount" => "596.00",
+      "resptext" => "Approval",
+      "setlstat" => "NOTCAPTURED",
+      "respcode" => "00",
+      "retref" => "288015190411",
+      "merchid" => "000000927996",
+      "account" => "41XXXXXXXXXX4113",
+      "respproc" => "FNOR",
+      "respstat" => "A",
+      "currency" => "USD"
+  }
+end
+
+def valid_settlestat_response
+  [
+      {
+          "txns" => [
+              {
+                  "setlstat" => "N",
+                  "retref" => "179001161341"
+              },
+              {
+                  "setlstat" => "Y",
+                  "retref" => "179002161341"
+              }
+          ],
+          "batchid" => "71742042",
+          "hoststat" => "GB",
+          "merchid" => "000000927996",
+          "hostbatch" => "71742041",
+          "respproc" => "FNOR"
+      }
+  ]
+end
+
+def valid_refund_response
+  {
+      "amount" => "59.60",
+      "resptext" => "Approval",
+      "authcode" => "REFUND",
+      "respcode" => "00",
+      "retref" => "288010185242",
+      "merchid" => "000000927996",
+      "respproc" => "PPS",
+      "respstat" => "A"
+  }
+end
+
+def valid_deposit_response
+  [
+      {
+          "accttype" => "VI",
+          "postdate" => "20121009",
+          "cbakamnt" => "0.00",
+          "feeamnt" => "0.55",
+          "currency" => "USD",
+          "amount" => "11.00",
+          "respproc" => "FNOR",
+          "txns" => [
+              {
+                  "merchbatch" => 92821429,
+                  "retref" => "282005142924",
+                  "hostbatch" => "1429",
+                  "feeamnt" => "0.00",
+                  "action" => "DEB",
+                  "depamnt" => "11.00"
+              }
+          ],
+          "resptext" => "Successful or something",
+          "depositid" => 7,
+          "merchid" => "000000927996",
+          "action" => "DEB",
+          "actdate" => "20121008",
+      }
+  ]
+end
+
+def valid_void_response
+  {
+      "amount" => "1.01",
+      "resptext" => "Approval",
+      "authcode" => "REVERS",
+      "respcode" => "00",
+      "retref" => "288013185633",
+      "merchid" => "000000927996",
+      "respproc" => "FNOR",
+      "respstat" => "A",
+      "currency" => "USD"
+  }
+end

data/test/cardconnect/configuration_test.rb

@@ -0,0 +1,28 @@
+require 'test_helper'
+
+describe CardConnect::Configuration do
+  before do
+    @config = CardConnect::Configuration.new
+  end
+
+  after do
+    @config = nil
+  end
+
+  it 'must respond to merchant id' do
+    @config.must_respond_to :merchant_id
+  end
+
+  it 'must respond to api username' do
+    @config.must_respond_to :api_username
+  end
+
+  it 'must respond to api password' do
+    @config.must_respond_to :api_password
+  end
+
+  it 'must respond to endpoint' do
+    @config.must_respond_to :endpoint
+  end
+
+end

data/test/cardconnect/connection_test.rb

@@ -0,0 +1,36 @@
+require 'test_helper'
+
+describe CardConnect::Connection do
+  before do
+    @connection = CardConnect::Connection.new.connection
+  end
+
+  after do
+    @connection = nil
+  end
+
+  describe '#connection' do
+    it 'must have user agent in the headers' do
+      @connection.headers['User-Agent'].must_equal "CardConnectRubyGem/#{CardConnect::VERSION}"
+    end
+
+    it 'must have a URL that matches the configured endpoint' do
+      @connection.url_prefix.host.must_equal URI.parse(CardConnect.configuration.endpoint).host
+      @connection.url_prefix.scheme.must_equal "https"
+    end
+
+    describe 'Faraday handlers' do
+      it 'must have a handler for basic authentication first' do
+        @connection.builder.handlers.first.must_be :===, Faraday::Request::BasicAuthentication
+      end
+
+      it 'must have a handler for encoding the request as json second' do
+        @connection.builder.handlers[1].must_be :===, FaradayMiddleware::EncodeJson
+      end
+
+      it 'must have a handler for parsing the json response third' do
+        @connection.builder.handlers[2].must_be :===, FaradayMiddleware::ParseJson
+      end
+    end
+  end
+end

data/test/cardconnect/services/authorization/authorization_request_test.rb

@@ -0,0 +1,141 @@
+require 'test_helper'
+
+describe CardConnect::Service::AuthorizationRequest do
+  before do
+    @request = CardConnect::Service::AuthorizationRequest.new(valid_auth_request)
+  end
+
+  after do
+    @request = nil
+  end
+
+  describe 'FIELDS' do
+    it 'should have merchant id' do
+      @request.merchid.must_equal "000000927996"
+    end
+
+    it 'should have account' do
+      @request.account.must_equal "4111111111111111"
+    end
+
+    it 'should have expiry' do
+      @request.expiry.must_equal "1212"
+    end
+
+    it 'should have amount' do
+      @request.amount.must_equal "0"
+    end
+
+    it 'should have currency' do
+      @request.currency.must_equal "USD"
+    end
+
+    it 'should have account type' do
+      @request.accttype.must_equal "VISA"
+    end
+
+    it 'should have name' do
+      @request.name.must_equal "TOM JONES"
+    end
+
+    it 'should have address' do
+      @request.address.must_equal "123 MAIN STREET"
+    end
+
+    it 'should have city' do
+      @request.city.must_equal "anytown"
+    end
+
+    it 'should have country' do
+      @request.country.must_equal "US"
+    end
+
+    it 'should have phone' do
+      @request.phone.must_equal "3334445555"
+    end
+
+    it 'should have postal' do
+      @request.postal.must_equal "55555"
+    end
+
+    it 'should have email' do
+      @request.email.must_equal "tom@jones.com"
+    end
+
+    it 'should have ecomind' do
+      @request.ecomind.must_equal "E"
+    end
+
+    it 'should have cvv2' do
+      @request.cvv2.must_equal "123"
+    end
+
+    it 'should have order id' do
+      @request.orderid.must_equal "AB-11-9876"
+    end
+
+    it 'should have track' do
+      @request.track.must_equal "Y"
+    end
+
+    it 'should have bankaba' do
+      @request.bankaba.must_equal "1010101"
+    end
+
+    it 'should have tokenize' do
+      @request.tokenize.must_equal "Y"
+    end
+
+    it 'should have termid' do
+      @request.termid.must_equal "12345"
+    end
+
+    it 'should have capture' do
+      @request.capture.must_equal "Y"
+    end
+
+    it 'should have ssnl4 field' do
+      @request.ssnl4.must_equal "1234"
+    end
+
+    it 'should have license field' do
+      @request.license.must_equal "CO:1231231234"
+    end
+
+    it 'should have profile field' do
+      @request.profile.must_equal "Y"
+    end
+
+    describe "userfields" do
+      it 'should be an array of name-value pairs' do
+        @request.userfields.must_be_kind_of Array
+        @request.userfields.first.must_be_kind_of Hash
+        @request.userfields.first['name0'].must_equal 'value0'
+      end
+    end
+  end
+
+  describe '#valid?' do
+    it 'should not be valid if no attributes are passed in' do
+      CardConnect::Service::AuthorizationRequest.new.valid?.must_equal false
+    end
+
+    it 'should be valid if valid attributes are passed in' do
+      CardConnect::Service::AuthorizationRequest.new(valid_auth_request).valid?.must_equal true
+    end
+  end
+
+  describe '#errors' do
+    CardConnect::Service::AuthorizationRequest::REQUIRED_FIELDS.each do |field|
+      it "should have an error message if #{field} is missing" do
+        CardConnect::Service::AuthorizationRequest.new.errors.must_include "#{field.to_s.capitalize} is missing"
+      end
+    end
+  end
+
+  describe '#payload' do
+    it 'should generate hash with all the right values' do
+      @request.payload.must_equal symbolize_keys(valid_auth_request)
+    end
+  end
+end

data/test/cardconnect/services/authorization/authorization_response_test.rb

@@ -0,0 +1,93 @@
+require 'test_helper'
+
+describe CardConnect::Service::AuthorizationResponse do
+  before do
+    @response = CardConnect::Service::AuthorizationResponse.new(valid_auth_response)
+  end
+
+  after do
+    @response = nil
+  end
+
+  describe 'FIELDS' do
+    it 'should have the merchant id' do
+      @response.merchid.must_equal "020594000000"
+    end
+
+    it 'should have the status' do
+      @response.respstat.must_equal "A"
+    end
+
+    it 'should have the Retrieval Reference Number' do
+      @response.retref.must_equal "343005123105"
+    end
+
+    it 'should have the Account Number' do
+      @response.account.must_equal "41XXXXXXXXXX1111"
+    end
+
+    it 'should have the Token' do
+      @response.token.must_equal "9419786452781111"
+    end
+
+    it 'should have the Amount' do
+      @response.amount.must_equal "111"
+    end
+
+    it 'should have the Response Code' do
+      @response.respcode.must_equal "00"
+    end
+
+    it 'should have the Response text' do
+      @response.resptext.must_equal "Approved"
+    end
+
+    it 'should have the Response Processor' do
+      @response.respproc.must_equal "FNOR"
+    end
+
+    it 'should have the AVS response code' do
+      @response.avsresp.must_equal "9"
+    end
+
+    it 'should have the CVV response code' do
+      @response.cvvresp.must_equal "M"
+    end
+
+    it 'should have the Authorization code' do
+      @response.authcode.must_equal "046221"
+    end
+
+    it 'should have the Commercial Card Flag' do
+      @response.commcard.must_equal "N"
+    end
+  end
+
+  describe '#success?' do
+    it 'should be true when there are no errors' do
+      @response.success?.must_equal true
+    end
+
+    it 'should be false when there are errors' do
+      response = CardConnect::Service::AuthorizationResponse.new(valid_auth_response.merge!("respstat" => "B", "resptext" => "this is an error"))
+      response.success?.must_equal false
+    end
+  end
+
+  describe '#errors' do
+    it 'should be empty when there are no errors' do
+      @response.errors.must_be_empty
+    end
+
+    it 'should be an array of error messages when there are errors' do
+      response = CardConnect::Service::AuthorizationResponse.new(valid_auth_response.merge!("respstat" => "B", "resptext" => "this is an error"))
+      response.errors.must_equal ["this is an error"]
+    end
+  end
+
+  describe "#body" do
+    it 'should generate hash with all the right values' do
+      @response.body.must_equal symbolize_keys(valid_auth_response)
+    end
+  end
+end