simplepay 0.2.1 → 0.2.2

data/History.txt

@@ -1,3 +1,7 @@
+== 0.2.2 2009-06-07
+
+* Added Donation service support.
+
 == 0.2.1 2009-01-06
 
 * Maintenance release for missing files.

data/Manifest.txt

@@ -11,6 +11,7 @@ lib/simplepay/helpers/notification_helper.rb
 lib/simplepay/helpers/rails_helper.rb
 lib/simplepay/rails.rb
 lib/simplepay/service.rb
+lib/simplepay/services/donation.rb
 lib/simplepay/services/marketplace.rb
 lib/simplepay/services/marketplace_policy.rb
 lib/simplepay/services/standard.rb
@@ -29,6 +30,7 @@ script/destroy
 script/generate
 simplepay.gemspec
 test/simplepay/helpers/test_notifier.rb
+test/simplepay/services/test_donation.rb
 test/simplepay/services/test_marketplace.rb
 test/simplepay/services/test_marketplace_policy.rb
 test/simplepay/services/test_standard.rb

data/lib/simplepay.rb

@@ -5,7 +5,7 @@ require 'active_support'
 
 module Simplepay
   
-  VERSION = '0.2.1' unless const_defined?(:VERSION)
+  VERSION = '0.2.2' unless const_defined?(:VERSION)
 
   mattr_accessor :aws_access_key_id
   mattr_accessor :aws_secret_access_key

data/lib/simplepay/service.rb

@@ -128,5 +128,6 @@ end
 
 require 'simplepay/services/subscription'
 require 'simplepay/services/standard'
+require 'simplepay/services/donation'
 require 'simplepay/services/marketplace'
 require 'simplepay/services/marketplace_policy'

data/lib/simplepay/services/donation.rb

@@ -0,0 +1,88 @@
+module Simplepay
+  module Services
+  
+    ##
+    # The Amazon Simple Pay Donation service is used to facilitate the collection 
+    # of donations to your organization, or another's organization via the 
+    # marketplace functionality.  When used through the marketplace functionality,
+    # you may charge a commission fee for brokering the exchange.
+    # 
+    # Note that donation recipients must accept your marketplace fee policy before
+    # the payment buttons for their donations may be generated.   This can be 
+    # accomplished using the +MarketplacePolicy+ service with the form helper 
+    # (see examples).
+    # 
+    # === Simple Pay Donation Fields
+    # 
+    # ==== Required Fields
+    # 
+    # The following attributes are required when generating a Simple Pay Donation
+    # form (in addition to those listed in +SimplePay::Service+):
+    # 
+    # amount:: The dollar value you'd like to collect
+    # 
+    # ==== Optional Fields
+    # 
+    # immediate_return:: Immediately returns the customer to your +return_url+ directly after payment.
+    # ipn_url:: Fully-qualified URL to which Amazon will POST instant payment notifications.
+    # process_immediately:: Instructs Amazon to immediately process the payment.
+    # reference_id:: A custom string your can set to identify this transaction, it will be returned with the IPNs and other returned data.
+    # return_url:: Fully-qualified URL for where to send your customer following payment.
+    # 
+    # ===== Marketplace Fields
+    # 
+    # recipient_email:: The email address of the donation recipient (important and must be correct)
+    # fixed_marketplace_fee::  The fixed marketplace fee to add to each transaction
+    # variable_marketplace_fee:: The variable marketplace fee to add to each transaction
+    # 
+    # === Example
+    # 
+    #     (in your view, sellers need to accept the marketplace fee policy using the form helper)
+    #
+    #     <%= simplepay_form_for(:marketplace_policy, {
+    #       :max_fixed_fee    => 10.00,
+    #       :max_variable_fee => 5,
+    #       :return_url       => 'http://yourservice.com'
+    #     }) %>
+    #
+    #     (in your view, payment form generated for end users using the form helper)
+    #     
+    #     <%= simplepay_form_for(:donation, {
+    #       :amount                   => 34.95,
+    #       :description              => "Mutual profit!",
+    #       :recipient_email          => 'seller@gmail.com',
+    #       :fixed_marketplace_fee    => 10.00,
+    #       :variable_marketplace_fee => 5
+    #     }) %>
+    # 
+    class Donation < Service
+
+        required_field :access_key
+        required_field :signature
+        required_field :account_id,           :as     => :amazon_payments_account_id
+
+        required_field :description
+        required_field :amount,               :class  => Support::Amount
+        required_field :cobranding_style,     :value  => 'logo'
+        required_field :donation_widget,      :as     => :is_donation_widget,
+                                              :value  => '1'
+        
+        field :reference_id
+        field :immediate_return,              :class  => Support::Boolean
+        field :collect_shipping_address,      :class  => Support::Boolean
+        field :process_immediately,           :class  => Support::Boolean,
+                                              :as     => :process_immediate
+
+        field :return_url
+        field :ipn_url
+        field :abandon_url
+        
+        # Marketplace inputs (recipient email required when using)
+        field :fixed_marketplace_fee,         :class  => Support::Amount
+        field :variable_marketplace_fee
+        field :recipient_email
+        
+      end
+    
+  end
+end

data/simplepay.gemspec

@@ -2,42 +2,42 @@
 
 Gem::Specification.new do |s|
   s.name = %q{simplepay}
-  s.version = "0.2.1"
+  s.version = "0.2.2"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Nathaniel E. Bibler"]
   s.cert_chain = ["/Users/nathan/.gem/gem-public_cert.pem"]
-  s.date = %q{2008-12-11}
+  s.date = %q{2009-06-07}
   s.description = %q{This gem provides a Rails interface to the Amazon Simple Pay payment service.}
   s.email = ["gem@nathanielbibler.com"]
   s.extra_rdoc_files = ["History.txt", "Manifest.txt", "README.rdoc"]
-  s.files = ["History.txt", "Manifest.txt", "README.rdoc", "Rakefile", "lib/simplepay.rb", "lib/simplepay/authentication.rb", "lib/simplepay/constants.rb", "lib/simplepay/errors.rb", "lib/simplepay/helpers/form_helper.rb", "lib/simplepay/helpers/notification_helper.rb", "lib/simplepay/helpers/rails_helper.rb", "lib/simplepay/rails.rb", "lib/simplepay/service.rb", "lib/simplepay/services/standard.rb", "lib/simplepay/services/subscription.rb", "lib/simplepay/support.rb", "lib/simplepay/support/amount.rb", "lib/simplepay/support/billing_frequency.rb", "lib/simplepay/support/boolean.rb", "lib/simplepay/support/currency.rb", "lib/simplepay/support/epoch.rb", "lib/simplepay/support/field.rb", "lib/simplepay/support/interval.rb", "lib/simplepay/support/subscription_period.rb", "script/console", "script/destroy", "script/generate", "simplepay.gemspec", "test/simplepay/helpers/test_notifier.rb", "test/simplepay/services/test_standard.rb", "test/simplepay/services/test_subscription.rb", "test/simplepay/support/test_amount.rb", "test/simplepay/support/test_billing_frequency.rb", "test/simplepay/support/test_boolean.rb", "test/simplepay/support/test_epoch.rb", "test/simplepay/support/test_field.rb", "test/simplepay/support/test_interval.rb", "test/simplepay/support/test_subscription_period.rb", "test/simplepay/test_authentication.rb", "test/simplepay/test_service.rb", "test/test_helper.rb", "test/test_simplepay.rb"]
+  s.files = ["History.txt", "Manifest.txt", "README.rdoc", "Rakefile", "lib/simplepay.rb", "lib/simplepay/authentication.rb", "lib/simplepay/constants.rb", "lib/simplepay/errors.rb", "lib/simplepay/helpers/form_helper.rb", "lib/simplepay/helpers/notification_helper.rb", "lib/simplepay/helpers/rails_helper.rb", "lib/simplepay/rails.rb", "lib/simplepay/service.rb", "lib/simplepay/services/donation.rb", "lib/simplepay/services/marketplace.rb", "lib/simplepay/services/marketplace_policy.rb", "lib/simplepay/services/standard.rb", "lib/simplepay/services/subscription.rb", "lib/simplepay/support.rb", "lib/simplepay/support/amount.rb", "lib/simplepay/support/billing_frequency.rb", "lib/simplepay/support/boolean.rb", "lib/simplepay/support/currency.rb", "lib/simplepay/support/epoch.rb", "lib/simplepay/support/field.rb", "lib/simplepay/support/interval.rb", "lib/simplepay/support/subscription_period.rb", "script/console", "script/destroy", "script/generate", "simplepay.gemspec", "test/simplepay/helpers/test_notifier.rb", "test/simplepay/services/test_donation.rb", "test/simplepay/services/test_marketplace.rb", "test/simplepay/services/test_marketplace_policy.rb", "test/simplepay/services/test_standard.rb", "test/simplepay/services/test_subscription.rb", "test/simplepay/support/test_amount.rb", "test/simplepay/support/test_billing_frequency.rb", "test/simplepay/support/test_boolean.rb", "test/simplepay/support/test_epoch.rb", "test/simplepay/support/test_field.rb", "test/simplepay/support/test_interval.rb", "test/simplepay/support/test_subscription_period.rb", "test/simplepay/test_authentication.rb", "test/simplepay/test_service.rb", "test/test_helper.rb", "test/test_simplepay.rb"]
   s.has_rdoc = true
   s.homepage = %q{http://simplepay.rubyforge.org}
   s.rdoc_options = ["--main", "README.rdoc"]
   s.require_paths = ["lib"]
   s.rubyforge_project = %q{simplepay}
-  s.rubygems_version = %q{1.3.1}
+  s.rubygems_version = %q{1.3.2}
   s.signing_key = %q{/Users/nathan/.gem/gem-private_key.pem}
   s.summary = %q{This gem provides a Rails interface to the Amazon Simple Pay payment service.}
-  s.test_files = ["test/simplepay/helpers/test_notifier.rb", "test/simplepay/services/test_standard.rb", "test/simplepay/services/test_subscription.rb", "test/simplepay/support/test_amount.rb", "test/simplepay/support/test_billing_frequency.rb", "test/simplepay/support/test_boolean.rb", "test/simplepay/support/test_epoch.rb", "test/simplepay/support/test_field.rb", "test/simplepay/support/test_interval.rb", "test/simplepay/support/test_subscription_period.rb", "test/simplepay/test_authentication.rb", "test/simplepay/test_service.rb", "test/test_helper.rb", "test/test_simplepay.rb"]
+  s.test_files = ["test/simplepay/helpers/test_notifier.rb", "test/simplepay/services/test_donation.rb", "test/simplepay/services/test_marketplace.rb", "test/simplepay/services/test_marketplace_policy.rb", "test/simplepay/services/test_standard.rb", "test/simplepay/services/test_subscription.rb", "test/simplepay/support/test_amount.rb", "test/simplepay/support/test_billing_frequency.rb", "test/simplepay/support/test_boolean.rb", "test/simplepay/support/test_epoch.rb", "test/simplepay/support/test_field.rb", "test/simplepay/support/test_interval.rb", "test/simplepay/support/test_subscription_period.rb", "test/simplepay/test_authentication.rb", "test/simplepay/test_service.rb", "test/test_helper.rb", "test/test_simplepay.rb"]
 
   if s.respond_to? :specification_version then
     current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
-    s.specification_version = 2
+    s.specification_version = 3
 
     if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
       s.add_runtime_dependency(%q<activesupport>, [">= 2.0.2"])
-      s.add_development_dependency(%q<newgem>, [">= 1.1.0"])
+      s.add_development_dependency(%q<newgem>, [">= 1.3.0"])
       s.add_development_dependency(%q<hoe>, [">= 1.8.0"])
     else
       s.add_dependency(%q<activesupport>, [">= 2.0.2"])
-      s.add_dependency(%q<newgem>, [">= 1.1.0"])
+      s.add_dependency(%q<newgem>, [">= 1.3.0"])
       s.add_dependency(%q<hoe>, [">= 1.8.0"])
     end
   else
     s.add_dependency(%q<activesupport>, [">= 2.0.2"])
-    s.add_dependency(%q<newgem>, [">= 1.1.0"])
+    s.add_dependency(%q<newgem>, [">= 1.3.0"])
     s.add_dependency(%q<hoe>, [">= 1.8.0"])
   end
 end

data/test/simplepay/services/test_donation.rb

@@ -0,0 +1,85 @@
+require File.dirname(__FILE__) + '/../../test_helper'
+require 'simplepay/services/donation'
+
+class Simplepay::Services::TestDonation < Test::Unit::TestCase
+  
+  def self.model_class; Simplepay::Services::Donation; end
+  
+  context 'Simplepay::Services::Donation' do
+    
+    should_have_service_field :access_key,
+                              :as       => 'accessKey', 
+                              :required => true
+    
+    should_have_service_field :signature,
+                              :as       => 'signature', 
+                              :required => true
+
+    should_have_service_field :account_id,
+                              :as       => 'amazonPaymentsAccountId', 
+                              :required => true
+
+    should_have_service_field :description,
+                              :as       => 'description', 
+                              :required => true
+
+    should_have_service_field :amount,
+                              :as       => 'amount', 
+                              :required => true,
+                              :class    => Simplepay::Support::Amount
+
+    should_have_service_field :recipient_email,
+                              :as       => 'recipientEmail',
+                              :required => false
+
+    should_have_service_field :fixed_marketplace_fee,
+                              :as       => 'fixedMarketplaceFee',
+                              :required => false,
+                              :class    => Simplepay::Support::Amount
+
+    should_have_service_field :variable_marketplace_fee,
+                              :as       => 'variableMarketplaceFee',
+                              :required => false
+
+    should_have_service_field :cobranding_style,
+                              :as       => 'cobrandingStyle', 
+                              :required => true
+
+    should_have_service_field :reference_id,
+                              :as       => 'referenceId', 
+                              :required => false
+
+    should_have_service_field :immediate_return,
+                              :as       => 'immediateReturn', 
+                              :required => false,
+                              :class    => Simplepay::Support::Boolean
+
+    should_have_service_field :collect_shipping_address,
+                              :as       => 'collectShippingAddress', 
+                              :required => false,
+                              :class    => Simplepay::Support::Boolean
+
+    should_have_service_field :process_immediately,
+                              :as       => 'processImmediate', 
+                              :required => false,
+                              :class    => Simplepay::Support::Boolean
+
+    should_have_service_field :return_url,
+                              :as       => 'returnUrl', 
+                              :required => false
+
+    should_have_service_field :abandon_url,
+                              :as       => 'abandonUrl', 
+                              :required => false
+
+    should_have_service_field :ipn_url,
+                              :as       => 'ipnUrl', 
+                              :required => false
+
+    should_have_service_field :donation_widget,
+                              :as       => 'isDonationWidget', 
+                              :required => true
+    
+  end
+  
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: simplepay
 version: !ruby/object:Gem::Version 
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors: 
 - Nathaniel E. Bibler
@@ -30,7 +30,7 @@ cert_chain:
   DXxToz6dXyCgpN1XYMMB+A==
   -----END CERTIFICATE-----
 
-date: 2009-01-06 00:00:00 -05:00
+date: 2009-06-07 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -51,7 +51,7 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 1.1.0
+        version: 1.3.0
     version: 
 - !ruby/object:Gem::Dependency 
   name: hoe
@@ -88,6 +88,7 @@ files:
 - lib/simplepay/helpers/rails_helper.rb
 - lib/simplepay/rails.rb
 - lib/simplepay/service.rb
+- lib/simplepay/services/donation.rb
 - lib/simplepay/services/marketplace.rb
 - lib/simplepay/services/marketplace_policy.rb
 - lib/simplepay/services/standard.rb
@@ -106,6 +107,7 @@ files:
 - script/generate
 - simplepay.gemspec
 - test/simplepay/helpers/test_notifier.rb
+- test/simplepay/services/test_donation.rb
 - test/simplepay/services/test_marketplace.rb
 - test/simplepay/services/test_marketplace_policy.rb
 - test/simplepay/services/test_standard.rb
@@ -123,6 +125,8 @@ files:
 - test/test_simplepay.rb
 has_rdoc: true
 homepage: http://simplepay.rubyforge.org
+licenses: []
+
 post_install_message: 
 rdoc_options: 
 - --main
@@ -144,12 +148,13 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: simplepay
-rubygems_version: 1.3.1
+rubygems_version: 1.3.2
 signing_key: 
-specification_version: 2
+specification_version: 3
 summary: This gem provides a Rails interface to the Amazon Simple Pay payment service.
 test_files: 
 - test/simplepay/helpers/test_notifier.rb
+- test/simplepay/services/test_donation.rb
 - test/simplepay/services/test_marketplace.rb
 - test/simplepay/services/test_marketplace_policy.rb
 - test/simplepay/services/test_standard.rb