paymill_ruby 1.0.2

data/lib/paymill/restful/methods.rb

@@ -0,0 +1,134 @@
+module Paymill
+  module Restful
+
+    module All
+      def all( arguments = {} )
+        unless arguments.empty?
+          order = "#{arguments[:order].map{ |e| "order=#{e.id2name}" }.join( '&' )}" if arguments[:order]
+          filters = arguments[:filters].map{ |hash| hash.map{ |key, value| "#{key.id2name}=#{value.gsub( ' ', '+' ) }" }.join( '&' ) } if arguments[:filters]
+          count = "count=#{arguments[:count]}" if arguments[:count]
+          offset = "offset=#{arguments[:offset]}" if arguments[:offset]
+          arguments = "?#{[order, filters, offset, count].reject { |e| e.nil? }.join( '&' )}"
+        else
+          arguments = ''
+        end
+
+        response = Paymill.request( Http.all( Restful.demodulize_and_tableize( name ), arguments ) )
+        enrich_array_with_data_count( response['data'].map!{ |element| new( element ) }, response['data_count'] )
+      end
+
+      private
+      def enrich_array_with_data_count( array, data_count )
+        array.instance_variable_set( '@data_count', data_count )
+        def array.data_count
+          @data_count
+        end
+        array
+      end
+    end
+
+    module Find
+      def find( model )
+        model = model.id if model.is_a? self
+        response = Paymill.request( Http.get( Restful.demodulize_and_tableize( name ), model ) )
+        new( response['data'] )
+      end
+    end
+
+    module Create
+      def create( arguments = {} )
+        raise ArgumentError unless create_with?( arguments.keys )
+        response = Paymill.request( Http.post( Restful.demodulize_and_tableize( name ), Restful.normalize( arguments ) ) )
+        new( response['data'] )
+      end
+    end
+
+    module Update
+      def update( arguments = {} )
+        arguments.merge! public_methods( false ).grep( /.*=/ ).map{ |m| m = m.id2name.chop; { m => send( m ) } }.reduce( :merge )
+
+        response = Paymill.request( Http.put( Restful.demodulize_and_tableize( self.class.name ), self.id, Restful.normalize( arguments ) ) )
+        source = self.class.new( response['data'] )
+        self.instance_variables.each { |key| self.instance_variable_set( key, source.instance_variable_get( key ) ) }
+      end
+    end
+
+    module Delete
+      def delete( arguments = {} )
+        response = Paymill.request( Http.delete( Restful.demodulize_and_tableize( self.class.name ), self.id, arguments ) )
+        return self.class.new( response['data'] ) if self.class.name.eql? 'Paymill::Subscription'
+        nil
+      end
+    end
+
+    private
+    def self.demodulize_and_tableize( name )
+      "#{name.split('::').last.downcase}s"
+    end
+
+    def self.normalize( parameters = {} )
+      attributes = {}.compare_by_identity
+      parameters.each do |key, value|
+        if value.is_a? Array
+          value.each.with_index do |e, index|
+            if e.is_a? ShoppingCartItem
+              e.instance_variables.each do |var|
+                attributes["items[#{index}][#{var.to_s[1..-1]}]"] = e.instance_variable_get( var ) unless e.instance_variable_get( var ).to_s.empty?
+              end
+            else
+              attributes["#{key.to_s}[]"] = e
+            end
+          end
+        elsif value.is_a? Base
+          attributes[key.to_s] = value.id
+        elsif value.is_a? Time
+          attributes[key.to_s] = value.to_i
+        elsif value.is_a? Address
+          value.instance_variables.each do |var|
+            attributes["#{key.to_s}[#{var.to_s[1..-1]}]"] = value.instance_variable_get( var ) unless value.instance_variable_get( var ).to_s.empty?
+          end
+        else
+          attributes[key.to_s] = value unless value.nil?
+        end
+      end
+      attributes
+    end
+  end
+
+  module Http
+    def self.all( endpoint, arguments )
+      request = Net::HTTP::Get.new( "/#{Paymill.api_version}/#{endpoint}#{arguments}" )
+      request.basic_auth( Paymill.api_key, '' )
+      request
+    end
+
+    def self.get( endpoint, id )
+      request = Net::HTTP::Get.new( "/#{Paymill.api_version}/#{endpoint}/#{id}" )
+      request.basic_auth( Paymill.api_key, '' )
+      request
+    end
+
+    def self.post( endpoint, id = nil, arguments )
+      request = Net::HTTP::Post.new( "/#{Paymill.api_version}/#{endpoint}/#{id}" )
+      request.basic_auth( Paymill.api_key, '' )
+      request.set_form_data( arguments )
+      request
+    end
+
+    def self.put( endpoint, id, arguments )
+      request = Net::HTTP::Put.new( "/#{Paymill.api_version}/#{endpoint}/#{id}" )
+      request.basic_auth( Paymill.api_key, '' )
+      request.set_form_data( arguments )
+      request
+    end
+
+    def self.delete( endpoint, id, arguments )
+      arguments = arguments.map { |key, value| "#{key.id2name}=#{value}" }.join( '&' )
+      arguments = "?#{arguments}" unless arguments.empty?
+      request = Net::HTTP::Delete.new( "/#{Paymill.api_version}/#{endpoint}/#{id}#{arguments}" )
+      request.basic_auth( Paymill.api_key, '' )
+      # request.set_form_data( arguments ) unless arguments.empty?
+      request
+    end
+  end
+end

data/lib/paymill/version.rb

@@ -0,0 +1,3 @@
+module Paymill
+  VERSION = "1.0.2"
+end

data/paymill.gemspec

@@ -0,0 +1,28 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'paymill/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "paymill_ruby"
+  spec.version       = Paymill::VERSION
+  spec.authors       = ["Vassil Nikolov"]
+  spec.email         = ["vassil.nikolov@qaiware.com"]
+  spec.summary       = %q{The official ruby wrapper for PAYMILL's API.}
+  spec.homepage      = "https://github.com/paymill/paymill-ruby"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0") - ['.gitignore', '.travis.yml', '.rspec']
+  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.7"
+  spec.add_development_dependency "activesupport", "~> 4.2"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.3"
+  spec.add_development_dependency "vcr", "~> 2.9"
+  spec.add_development_dependency "webmock", "~> 1.20"
+  spec.add_development_dependency "pry", "~> 0.10"
+  spec.add_development_dependency "guard-rspec", "~> 4.3"
+end

data/samples/authentication/authentication.rb

@@ -0,0 +1 @@
+Paymill.api_key = "<YOUR_PRIVATE_KEY>"

data/samples/clients/create_new_client.rb

@@ -0,0 +1,4 @@
+Paymill::Client.create(
+    email: 'lovely-client@example.com',
+    description: 'Lovely Client'
+)

data/samples/clients/export_clients_list.rb

@@ -0,0 +1 @@
+# Not implemented yet

data/samples/clients/get_client_details.rb

@@ -0,0 +1 @@
+Paymill::Client.find('client_88a388d9dd48f86c3136')

data/samples/clients/list_clients.rb

@@ -0,0 +1 @@
+Paymill::Client.all

data/samples/clients/remove_client.rb

@@ -0,0 +1,2 @@
+client = Paymill::Client.find('client_88a388d9dd48f86c3136')
+client.delete

data/samples/clients/update_client.rb

@@ -0,0 +1,4 @@
+client = Paymill::Client.find('client_88a388d9dd48f86c3136')
+client.email = 'lovely-client@example.com'
+client.description = 'My Lovely Client'
+client.update

data/samples/offers/create_new_offer.rb

@@ -0,0 +1,7 @@
+Paymill::Offer.create(
+    amount: 4200,
+    currency: 'EUR',
+    interval: '1 MONTH',
+    name: 'Nerd Special',
+    trial_period_days: 0
+)

data/samples/offers/export_offers_list.rb

@@ -0,0 +1 @@
+# Not implemented yet

data/samples/offers/get_offer_details.rb

@@ -0,0 +1 @@
+Paymill::Offer.find('offer_40237e20a7d5a231d99b')

data/samples/offers/list_offers.rb

@@ -0,0 +1 @@
+Paymill::Offer.all()

data/samples/offers/remove_offer.rb

@@ -0,0 +1,7 @@
+# with subscriptions:
+offer = Paymill::Offer.find('offer_40237e20a7d5a231d99b')
+offer.delete_with_subscriptions()
+
+# without subscriptions:
+offer = Paymill::Offer.find('offer_40237e20a7d5a231d99b')
+offer.delete_without_subscriptions()

data/samples/offers/update_offer.rb

@@ -0,0 +1,8 @@
+offer = Paymill::Offer.find('offer_40237e20a7d5a231d99b')
+
+offer.name = 'Extended Special'
+offer.interval = '1 MONTH'
+offer.currency = 'USD'
+offer.amount = '3333'
+
+offer.update( update_subscriptions: true )

data/samples/payments/create_new_credit_card_payment_with_token.rb

@@ -0,0 +1 @@
+Paymill::Payment.create( token: '098f6bcd4621d373cade4e832627b4f6' )

data/samples/payments/create_new_credit_card_payment_with_token_and_client.rb

@@ -0,0 +1,4 @@
+Paymill::Payment.create(
+    token: '098f6bcd4621d373cade4e832627b4f6',
+    client: 'client_88a388d9dd48f86c3136'
+)

data/samples/payments/create_new_debit_payment_with_token.rb

@@ -0,0 +1 @@
+Paymill::Payment.create( token: '12a46bcd462sd3r3care4e8336ssb4f5' )

data/samples/payments/create_new_debit_payment_with_token_and_client.rb

@@ -0,0 +1,4 @@
+Paymill::Payment.create(
+    token: '12a46bcd462sd3r3care4e8336ssb4f5',
+    client: 'client_88a388d9dd48f86c3136'
+)

data/samples/payments/export_payments_list.rb

@@ -0,0 +1 @@
+# Not yet implemented

data/samples/payments/get_payment_details.rb

@@ -0,0 +1 @@
+Paymill::Payment.find( 'pay_3af44644dd6d25c820a8' )

data/samples/payments/list_payments.rb

@@ -0,0 +1 @@
+Paymill::Payment.all

data/samples/payments/remove_payment.rb

@@ -0,0 +1,2 @@
+payment = Paymill::Payment.find( 'pay_ea98515b29437b046207ea45' )
+payment.delete

data/samples/preauthorizations/create_new_preauthorization_with_payment.rb

@@ -0,0 +1,8 @@
+payment = Paymill::Payment.create(token: '098f6bcd4621d373cade4e832627b4f6')
+
+Paymill::Preauthorization.create(
+    payment: payment.id,
+    amount: 4200,
+    currency: 'EUR',
+    description: 'description example'
+)

data/samples/preauthorizations/create_new_preauthorization_with_token.rb

@@ -0,0 +1,6 @@
+Paymill::Preauthorization.create(
+    token: '098f6bcd4621d373cade4e832627b4f6',
+    amount: 4200,
+    currency: 'EUR',
+    description: 'description example'
+)

data/samples/preauthorizations/export_preauthorizations_list.rb

@@ -0,0 +1 @@
+# Not implemented yet

data/samples/preauthorizations/get_preauthorization_details.rb

@@ -0,0 +1 @@
+Paymill::Preauthorization.find('preauth_31eb90495837447f76b7')

data/samples/preauthorizations/list_preauthozizations.rb

@@ -0,0 +1 @@
+Paymill::Preauthorization.all()

data/samples/preauthorizations/remove_preauthorization.rb

@@ -0,0 +1,2 @@
+preauthorization = Paymill::Preauthorization.find('preauth_31eb90495837447f76b7')
+preauthorization.delete

data/samples/refunds/create_new_refund.rb

@@ -0,0 +1,11 @@
+transaction = Paymill::Transaction.create(
+    token: '098f6bcd4621d373cade4e832627b4f6',
+    amount: 4200,
+    currency: 'USD'
+)
+
+Paymill::Refund.create(
+    transaction,
+    amount: 4200,
+    description: 'Sample Description'
+)

data/samples/refunds/export_refunds_list.rb

@@ -0,0 +1 @@
+# Not implemented yet

data/samples/refunds/get_refund_details.rb

@@ -0,0 +1 @@
+Paymill::Refund.find('refund_87bc404a95d5ce616049')

data/samples/refunds/list_refunds.rb

@@ -0,0 +1 @@
+Paymill::Refund.all()

data/samples/subscriptions/cancel_subscription.rb

@@ -0,0 +1,2 @@
+subscription = Paymill::Subscription.find('sub_dea86e5c65b2087202e3')
+subscription.cancel()

data/samples/subscriptions/create_new_subscription_with_an_offer.rb

@@ -0,0 +1,15 @@
+payment = Paymill::Payment.create(token: '098f6bcd4621d373cade4e832627b4f6')
+offer = Paymill::Offer.create(
+    amount: 3333,
+    currency: 'EUR',
+    interval: '1 WEEK',
+    name: 'Nerd Special',
+    trial_period_days: 30
+    )
+
+Paymill::Subscription.create(
+    payment: payment,
+    offer: offer,
+    period_of_validity: '2 YEAR',
+    start_at: 2.days.from_now
+)

data/samples/subscriptions/create_new_subscription_with_an_offer_and_different_values.rb

@@ -0,0 +1,19 @@
+payment = Paymill::Payment.create(token: '098f6bcd4621d373cade4e832627b4f6')
+offer = Paymill::Offer.create(
+    amount: 4200,
+    currency: 'EUR',
+    interval: '1 MONTH',
+    name: 'Nerd Special',
+    trial_period_days: 30
+)
+
+Paymill::Subscription.create(
+    payment: payment,
+    offer: offer,
+    amount: 3000,
+    currency: 'EUR',
+    interval: '1 week, monday',
+    name: 'Example Subscription',
+    period_of_validity: '2 YEAR',
+    start_at: 2.days.from_now
+)

data/samples/subscriptions/create_new_subscription_without_an_offer.rb

@@ -0,0 +1,13 @@
+client = Paymill::Client.create(email: 'client@example.com')
+payment = Paymill::Payment.create(token: '098f6bcd4621d373cade4e832627b4f6', client: client)
+
+Paymill::Subscription.create(
+    payment: payment,
+    client: client,
+    name: 'Example Subscription',
+    amount: 3000,
+    currency: 'EUR',
+    interval: '1 week,monday',
+    period_of_validity: '2 YEAR',
+    start_at: 2.days.from_now
+)

data/samples/subscriptions/delete_subscription.rb

@@ -0,0 +1,2 @@
+subscription = Paymill::Subscription.find('sub_dea86e5c65b2087202e3')
+subscription.remove()

data/samples/subscriptions/export_subscriptions_list.rb

@@ -0,0 +1 @@
+# Not implemented yet

data/samples/subscriptions/get_subscription_details.rb

@@ -0,0 +1 @@
+Paymill::Subscription.find("sub_dc180b755d10da324864")

data/samples/subscriptions/list_subscriptions.rb

@@ -0,0 +1 @@
+Paymill::Subscription.all()

data/samples/subscriptions/pause_subscription.rb

@@ -0,0 +1,7 @@
+#pause:
+subscription = Paymill::Subscription.find('sub_dea86e5c65b2087202e3')
+subscription.pause
+
+#play:
+subscription = Paymill::Subscription.find('sub_dea86e5c65b2087202e3')
+subscription.play

data/samples/subscriptions/update_subscription.rb

@@ -0,0 +1,12 @@
+subscription = Paymill::Subscription.find('sub_dea86e5c65b2087202e3')
+subscription.payment = 'pay_95ba26ba2c613ebb0ca8'
+subscription.currency = 'USD'
+subscription.interval = '1 month,friday'
+subscription.name = 'Changed Subscription'
+subscription.trial_end = false
+subscription.update
+
+# for limit / unlimit use
+subscription = Paymill::Subscription.find('sub_dea86e5c65b2087202e3')
+subscription.unlimit
+subscription.limit('12 MONTH')

data/samples/subscriptions/update_subscription_amount.rb

@@ -0,0 +1,7 @@
+#amount temporary:
+subscription = Paymill::Subscription.find('sub_dea86e5c65b2087202e3')
+subscription.update_amount_once(1234)
+
+#amount permanently:
+subscription = Paymill::Subscription.find('sub_dea86e5c65b2087202e3')
+subscription.update_amount_permanently(1234)

data/samples/subscriptions/update_subscription_offer.rb

@@ -0,0 +1,14 @@
+#offer with no refund and unchanged capture date:
+subscription = Paymill::Subscription.find('sub_dea86e5c65b2087202e3')
+offer = Offer.create(name: 'Foo', amount: 4990, currency: 'EUR', interval: '2 WEEK')
+subscription.update_offer_without_changes(offer)
+
+#offer with refund and unchanged capture date:
+subscription = Paymill::Subscription.find('sub_dea86e5c65b2087202e3')
+offer = Offer.create(name: 'Foo', amount: 4990, currency: 'EUR', interval: '2 WEEK')
+subscription.update_offer_with_refund(offer)
+
+#offer with refund and capture date:
+subscription = Paymill::Subscription.find('sub_dea86e5c65b2087202e3')
+offer = Offer.create(name: 'Foo', amount: 4990, currency: 'EUR', interval: '2 WEEK')
+subscription.update_offer_with_refund_and_capture_date(offer)