pay_simple 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 2532957b6fb8a3d031363541f83eb3b0b562caa9
+  data.tar.gz: 5525f4e0701481d83433b63c87a81ffe8ff4a859
+SHA512:
+  metadata.gz: 22546392eccc615b4a0f879061d8395ef3ae4a17c4573dea6b1e126a2cf624065cc2075d34472fe3d85881bac0fa5960aa88e82c4c54f19eb1dc5428c5176652
+  data.tar.gz: ea1bb1450e5066982e06d0505711f71a4fbc4d7d80cc5d6d64b52efd378476770ab84c29e4f53b8c04fdb4b08031983d217871e83cebd6910848f256beb79e31

data/.gitignore

@@ -0,0 +1,5 @@
+./spec/config.yml
+spec/concept_testing.rb
+spec/config.yml
+*.swp
+*.swo

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,12 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in paysimple.gemspec
+gemspec
+
+gem 'httparty'
+gem 'rspec'
+
+group :test do
+  gem 'factory_girl'
+  gem 'simplecov'
+end

data/Gemfile.lock

@@ -0,0 +1,35 @@
+PATH
+  remote: .
+  specs:
+    PS (0.0.0)
+      httparty
+      json
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    diff-lcs (1.2.4)
+    hooks (0.3.1)
+    httparty (0.11.0)
+      multi_json (~> 1.0)
+      multi_xml (>= 0.5.2)
+    json (1.8.0)
+    multi_json (1.7.9)
+    multi_xml (0.5.5)
+    rspec (2.14.1)
+      rspec-core (~> 2.14.0)
+      rspec-expectations (~> 2.14.0)
+      rspec-mocks (~> 2.14.0)
+    rspec-core (2.14.5)
+    rspec-expectations (2.14.2)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.14.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  PS!
+  hooks
+  httparty
+  rspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 CTA
+
+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,100 @@
+# Paysimple
+
+A multiformat integration with paysimple's version 3 api. 
+
+We hope to replace the already existing paysimple gem that hasn't been updated in years.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'paysimple'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install paysimple
+
+## Usage
+  please note that the documention, and the gem are still works in progress. Clone this repo for usage at your own risk.
+
+### Connection to paysimple
+    require 'paysimple' 
+    PS::Base.establish_connection(
+      :format => "JSON",
+      :apikey => your_api_key,
+      :userkey => the_user_key,
+      :company_name => your_company_name
+    )
+### Creating a customer
+    require 'paysimple'
+    PS::Base.establish_connection( ... )
+
+    customer_params = {                                                  
+     :first_name => "test",                           
+     :middle_name => "e",                             
+     :last_name => "name",                            
+     :email => "example@test.com",                    
+     :phone => "0000000000",                          
+     :billing_address1 => "1600 Pennsylvania Ave NW", 
+     :billing_city => "Washington",                   
+     :billing_state => 8,                             
+     :billing_postal_code => 20500,                   
+     :billing_country_code => "USA",                  
+     :shipping_same_as_billing => 1
+    }
+
+    customer = PS::Customer.create(customer_params)
+    p customer
+    # => 
+      #<PS::Customer ps_reference_id: 1, billing_address1: '1600 Pennsylvania Ave NW', billing_city: 'Washington', billing_postal_code: '20500', billing_state: 8, email: 'example@test.com', first_name: 'test', last_name: 'e', phone: '0000000000', shipping_same_as_billing: 1>
+
+### Making a payment
+    customer = PS::Customer.find(1)
+    cc = PS::CreditCardAccount.create({ 
+      :account_number => "4111111111111111",
+      :c_c_expiry => "2014/12",
+      :c_c_type => CreditCardIssuer::VISA,
+      :customer_id => customer.ps_reference_id
+    })
+    payment = Payment.make(customer.ps_reference_id, 100000, cc.ps_reference_id)
+### Alternative method of making a payment
+    customer = {                                                  
+     :first_name => "test",                           
+     :middle_name => "e",                             
+     :last_name => "name",                            
+     :email => "example@test.com",                    
+     :phone => "0000000000",                          
+     :billing_address1 => "1600 Pennsylvania Ave NW", 
+     :billing_city => "Washington",                   
+     :billing_state => 8,                             
+     :billing_postal_code => 20500,                   
+     :billing_country_code => "USA",                  
+     :shipping_same_as_billing => 1
+    }
+    customer_account = {
+      :account_number => "4111111111111111",
+      :c_c_expiry => "2014/12",
+      :c_c_type => CreditCardIssuer::VISA,
+    }
+    amount = 100
+
+    response = PS::Customer.create_and_make_cc_payment(
+      customer,
+      customer_account,
+      amount
+    )
+
+    response.map(&:class) #=> [ PS::Customer, PS::CreditCardAccount, PS::Payment ]
+
+
+## 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 @@
+require "bundler/gem_tasks"

data/lib/ps.rb

@@ -0,0 +1,32 @@
+# gems
+require 'httparty'
+require 'json'
+
+# core classes
+require 'ps/exceptions'
+require 'ps/api'
+require 'ps/base'
+
+# ps objects
+require 'ps/object'
+require 'ps/objects/customer'
+require 'ps/objects/customer_account'
+require 'ps/objects/credit_card_account'
+require 'ps/objects/ach_account'
+require 'ps/objects/payment'
+require 'ps/objects/recurring_payment'
+require 'ps/objects/user'
+
+
+require 'ps/response'
+# enumerables 
+require 'ps/enumerations'
+
+# util
+require 'ps/util.rb'
+require 'ps/util/string'
+require 'ps/util/hash'
+require 'ps/util/state'
+
+module PS
+end

data/lib/ps/api.rb

@@ -0,0 +1,80 @@
+module PS
+  module Api 
+    ##
+    # Establishes the connection to the appropriate paysimple v3 api.
+    # Defaults to JSON
+    def connect(format)
+      format ||= "JSON"
+      begin
+        require "ps/api/#{format.downcase}"
+      rescue LoadError
+        raise ConnectionError, "#{format} is not a supported format"
+      end
+      $api = PS::Api.const_get(format.downcase.capitalize).new
+    end
+
+    def validate_and_assign(params)
+      required_attributes().each do |key|
+        if params.key?(key) then
+          $api.instance_variable_set("@#{key.to_s}", params[key])
+        else
+          raise ArgumentError, "Missing required attribute: #{key}"
+        end
+      end
+    end
+
+    def required_attributes
+      $api.instance_variables.map do |instance_variable| 
+        instance_variable.to_s[1..-1].to_sym
+      end
+    end
+
+    def connection_hash
+      {
+        :apikey => $api.apikey,
+        :userkey => $api.userkey,
+        :company_name => $api.company_name,
+        :host => host()
+      }
+    end
+
+    def request(method, params={}, &block)
+      response = Response.new($api.request(method, camel_case_request(params)))
+      block[response] if block
+    end
+
+    def env 
+      $api.env
+    end
+
+    #TODO: make constants
+    def host
+      if env() == "development" then
+        "https://sandbox-api.paysimple.com/3.00/paysimpleapi"
+      elsif env() == "production" then
+        "https://api.paysimple.com/3.00/paysimpleapi"
+      end
+    end
+    
+    #Paysimple expects the attribute names to be in CamelCase, but that isn't 
+    #very ruby-esque; so, in an effort to be more ruby-esque, we define and 
+    #work with the attributes in snake case. The method bellow converts from 
+    #the ruby-esque snake case to PS' CamelCase.
+    def camel_case_request(params)
+      params.each { |key, value| value.camel_case_keys if value.class == Hash }
+    end
+
+    ##
+    # returns the conditions for detecting if something is a date format for
+    # the current format class
+    def date?(object)
+      $api.date?(object)
+    end
+    
+    ##
+    # How to parse dates for thi current format
+    def parse_date(date)
+      $api.parse_date(date)
+    end
+  end
+end

data/lib/ps/api/json.rb

@@ -0,0 +1,78 @@
+# encoding: utf-8
+module PS
+  module Api
+    class Json 
+      include HTTParty
+      attr_reader :apikey, :userkey, :company_name, :env
+
+      def initialize 
+        @apikey = nil
+        @userkey = nil
+        @company_name = nil
+        @env = "production"
+      end
+
+      def request(method, params={})
+        post_response = self.class.post(request_url(method), options_hash(params)).parsed_response
+        post_response['d'] || post_response
+      end
+
+      def date?(object)
+        object.instance_of?(String) && object.include?("Date")
+      end
+
+      #do some conversion for the ASP.net json dates
+      def parse_date(str)             
+        Time.at(str[/([0-9]+)-([0-9]+)/,1].to_i/1000)
+      end                                            
+
+      private
+        #TODO refactor
+        def format_request_dates(request)
+          request.each do |request_key,request_value|
+            if request_value.instance_of? Hash then
+              request_value.each do |obj_key, obj_value|
+                if obj_value.instance_of? Time then
+                  request[request_key][obj_key] = format_date(obj_value)
+                end
+              end
+            elsif request_value.instance_of? Time then
+              request[request_key] = format_date(request_value)
+            end
+          end
+        end
+
+        #format http://msdn.microsoft.com/en-us/library/bb299886.aspx#intro_to_json_sidebarb 
+        def format_date(date)
+          "/Date(#{(date.to_i*1000)}-0600)/"
+        end                                            
+
+        def options_hash(post_data)
+          post_data[:apikey] = @apikey
+          post_data[:userkey] = @userkey
+          post_data = format_request_dates(post_data).to_json
+          { 
+            :body => post_data, 
+            :headers => header(post_data.to_json.length.to_s)
+          }
+        end
+
+        def request_url(method)
+          "#{Base.host()}/#{name()}/#{method}"
+        end
+
+        def name 
+          self.class.name.split('::').last.downcase
+        end
+        
+        def header(content_length)
+          {
+            'Content-Type' => "application/json;charset=utf-8",
+            'Accept' => "application/json",
+            'User-Agent' => @company_name,
+            'Content-Length' => content_length
+          }
+        end
+    end
+  end
+end

data/lib/ps/base.rb

@@ -0,0 +1,22 @@
+module PS
+  class Base 
+    #hmm...
+    extend Api
+    include Api
+
+    ## params.keys -> [
+    # :apikey,
+    # :userkey,
+    # :company_name
+    ##]
+    def self.establish_connection(params={})
+      connect(params.delete(:format))
+      params[:env] ||= "development"
+      validate_and_assign(params)
+    end
+
+    def self.current_connection
+      puts connection_hash().inspect
+    end
+  end
+end

data/lib/ps/enumerations.rb

@@ -0,0 +1,191 @@
+class CreditCardIssuer
+  VISA     = 1
+  MASTER   = 2
+  AMEX     = 3
+  DISCOVER = 4
+end
+
+class BillingFrequencyType
+  DAILY                 = 1
+  WEEKLY                = 2
+  BI_WEEKLY             = 3
+  FIRST_OF_MONTH        = 4
+  SPECIFIC_DAY_OF_MONTH = 5
+  LAST_OF_MONTH         = 6
+  QUARTERLY             = 7
+  SEMI_ANNUALLY         = 8
+  ANNUALLY              = 9
+end
+
+class RecurringScheduleType
+  PAYMENT_PLAN = 1
+  BILL_PAYMENT = 2
+end
+
+class ErrorCodeType
+  NONE = 0
+end
+
+class PaymentType
+  CC  = 1
+  ACH = 2
+end
+
+class CreditCardPaymentType
+  MOTO  = 11
+  SWIPE = 10
+end
+
+class AchPaymentType
+  ARC  = 3
+  WEB  = 4
+  TEL  = 5
+  PPD  = 6
+  CCD  = 7
+  BOC  = 8
+  RCK  = 9
+  ACHD = 16
+end
+
+class Sort
+  ASC  = 0
+  DESC = 1
+end
+
+class PaymentStatus
+  ALL               = -1
+  PENDING           = 0
+  POSTED            = 1
+  SETTLED           = 2
+  FAILED            = 3
+  RESUBMITTED       = 4
+  VOIDED            = 5
+  REVERSED          = 6
+  SAVED             = 7
+  SCHEDULED         = 8
+  REVERSEPOSTED     = 9
+  CHARGEBACK        = 10
+  CLOSECHARGEBACK   = 11
+  AUTHORIZED        = 12
+  RETURNED          = 13
+  REVERSECHARGEBACK = 14
+  REVERSENSF        = 15
+  REVERSERETURN     = 16
+  REFUNDSETTLED     = 17
+end
+
+module PS
+  class InvoiceScheduleStatus
+    EXPIRED   = 1
+    SUSPENDED = 2
+    DRAFT     = 3
+    ACTIVE    = 4
+  end
+  
+  class InvoiceStatus
+    PAID          = 0
+    UNPAID        = 1
+    DRAFT         = 2
+    CANCELLED     = 3
+    OVERDUE       = 4
+    PAIDPARTIALLY = 5
+  end
+
+  class ScheduleStatus
+    DISABLE     = 0
+    ACTIVE      = 1
+    PAUSE_UNTIL = 2
+    EXPIRED     = 3
+    SUSPENDED   = 4
+  end
+
+  class PaymentDateRangeType
+    PAYMENT_DATE = 0
+    SETTLED_DATE = 1
+  end
+
+  class Country
+    MERICA = 1 # :D
+    AMERICA = 1
+    CANADA = 3
+  end
+
+  class States
+    AP = 74
+    WI = 49
+    GA = 11
+    MD = 21
+    ME = 22
+    GU = 68
+    CA = 5
+    VT = 47
+    AR = 3
+    ID = 14
+    VA = 46
+    AS = 71
+    CT = 7
+    FL = 10
+    OH = 36
+    AA = 76
+    FM = 75
+    MH = 70
+    KY = 18
+    PR = 52
+    SK = 64
+    MI = 23
+    PA = 39
+    AB = 53
+    OK = 37
+    NS = 59
+    LA = 19
+    NB = 56
+    NT = 58
+    AE = 72
+    NC = 28
+    NU = 60
+    TX = 44
+    PW = 73
+    PE = 62
+    ON = 61
+    NV = 34
+    ND = 29
+    VI = 69
+    YT = 65
+    AZ = 4
+    NE = 30
+    WA = 48
+    IL = 15
+    MN = 24
+    UT = 45
+    MO = 25
+    RI = 40
+    NY = 35
+    MP = 67
+    DC = 8
+    WV = 50
+    IN = 16
+    NH = 31
+    AK = 1
+    OR = 38
+    OTHER = 66
+    NJ = 32
+    SC = 41
+    BC = 54
+    AL = 2
+    MA = 20
+    QC = 63
+    MS = 26
+    SD = 42
+    TN = 43
+    DE = 9
+    MB = 55
+    KS = 17
+    NL = 57
+    MT = 27
+    WY = 51
+    CO = 6
+    NM = 33
+    IA = 13
+    HI = 12
+  end
+end