simplepay 0.2.0 → 0.2.1

data/History.txt

@@ -1,3 +1,7 @@
+== 0.2.1 2009-01-06
+
+* Maintenance release for missing files.
+
 == 0.2.0 2009-01-03
 
 * Added Marketplace Service support [Nick Plante (zapnap)]

data/Manifest.txt

@@ -11,6 +11,8 @@ lib/simplepay/helpers/notification_helper.rb
 lib/simplepay/helpers/rails_helper.rb
 lib/simplepay/rails.rb
 lib/simplepay/service.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
@@ -27,6 +29,8 @@ script/destroy
 script/generate
 simplepay.gemspec
 test/simplepay/helpers/test_notifier.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

data/lib/simplepay.rb

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

data/lib/simplepay/services/marketplace.rb

@@ -0,0 +1,86 @@
+module Simplepay
+  module Services
+  
+    ##
+    # The Amazon Simple Pay Marketplace service is used to facilitate payments for others.
+    # Use it to charge a commission fee for brokering the exchange between buyers and sellers.
+    #
+    # Note that sellers must accept your marketplace fee policy before the payment buttons
+    # for their products can be generated. This can be accomplished using the +MarketplacePolicy+
+    # service with the form helper (see examples).
+    # 
+    # === Simple Pay Marketplace Fields
+    # 
+    # ==== Required Fields
+    # 
+    # The following attributes are required when creating a Simple Pay 
+    # Marketplace form (in addition to those listed in +Simplepay::Service+):
+    # 
+    # amount:: The dollar value you'd like to collect.
+    # description:: A summary of the reason for the payment, this is displayed to your customer during checkout.
+    # recipient_email:: The e-mail address of the seller (important and must be correct).
+    # fixed_marketplace_fee:: The fixed marketplace fee to add to each transaction.
+    # variable_marketplace_fee:: The variable percentage fee to add to each transaction.
+    # 
+    # ==== Optional Fields
+    # 
+    # abandon_url:: The fully-qualified URL to send your custom if they cancel during payment.
+    # cobranding_style:: Defines the type of cobranding to use during the checkout process.
+    # collect_shipping_address:: Tells Amazon whether or not to ask for shipping address and contact information.
+    # 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.
+    # 
+    # === 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(:standard, {
+    #       :amount                   => 34.95,
+    #       :description              => "Mutual profit!",
+    #       :recipient_email          => 'seller@gmail.com',
+    #       :fixed_marketplace_fee    => 10.00,
+    #       :variable_marketplace_fee => 5
+    #     }) %>
+    # 
+    class Marketplace < 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 :fixed_marketplace_fee,    :class  => Support::Amount
+      required_field :variable_marketplace_fee
+      required_field :cobranding_style,         :value  => 'logo'
+      required_field :recipient_email
+      
+      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
+      
+      # These fields are not currently utilized by the service
+      field :donation_widget,               :as     => :is_donation_widget,
+                                            :value  => '0'
+      
+    end
+    
+  end
+end

data/lib/simplepay/services/marketplace_policy.rb

@@ -0,0 +1,57 @@
+module Simplepay
+  module Services
+  
+    ##
+    # The Amazon Simple Pay Marketplace Policy service is used to allow sellers to acknowledge marketplace policy fees.
+    # Only once a set policy has been agreed to will marketplace transactions be able to proceed.
+    #
+    # === Simple Pay Marketplace Policy Fields
+    # 
+    # ==== Required Fields
+    # 
+    # The following attributes are required when creating a Simple Pay Marketplace policy fee acceptance form
+    # (in addition to those listed in +Simplepay::Service+):
+    # 
+    # max_fixed_fee:: The maximum fixed fee that will be appended to transactions.
+    # max_variable_fee:: The maximum variable fee (%) that will be calculated and added to transactions.
+    # return_url:: Fully-qualified URL for where to send they buyer following payment.
+    # reference_id:: A custom string used to identify this transaction, it will be returned with return data.
+    #
+    # === Example
+    # 
+    #     (in your view, using the form helper)
+    #
+    #     <%= simplepay_form_for(:marketplace_policy, {
+    #       :max_fixed_fee => 10.00,
+    #       :max_variable_fee => 5,
+    #       :return_url => 'http://yourservice.com',
+    #       :reference_id => '123456789'
+    #     }) %>
+    #
+    class MarketplacePolicy < Service
+      
+      # Fully-qualified URL for the production endpoint for the service.
+      ENDPOINT_URL  = 'https://authorize.payments.amazon.com/cobranded-ui/actions/start'
+
+      # Fully-qualified URL for the sandbox (test) endpoint for the service.
+      SANDBOX_URL   = 'https://authorize.payments-sandbox.amazon.com/cobranded-ui/actions/start'
+
+      required_field :access_key, :as => :caller_key
+      required_field :signature,  :as => :aws_signature
+      required_field :account_id, :as => :caller_account_id
+      
+      required_field :max_fixed_fee
+      required_field :max_variable_fee
+      required_field :return_url
+
+      required_field :reference_id,          :as => :caller_reference
+      required_field :collect_email_address, :value => 'True'
+      required_field :pipeline_name,         :value => 'Recipient'
+
+      # These fields are not currently utilized by the service
+      required_field :recipient_pays_fee,    :value => 'True'
+      
+    end
+    
+  end
+end

data/simplepay.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |s|
   s.name = %q{simplepay}
-  s.version = "0.2.0"
+  s.version = "0.2.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Nathaniel E. Bibler"]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: simplepay
 version: !ruby/object:Gem::Version 
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors: 
 - Nathaniel E. Bibler
@@ -30,7 +30,7 @@ cert_chain:
   DXxToz6dXyCgpN1XYMMB+A==
   -----END CERTIFICATE-----
 
-date: 2009-01-03 00:00:00 -05:00
+date: 2009-01-06 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -88,6 +88,8 @@ files:
 - lib/simplepay/helpers/rails_helper.rb
 - lib/simplepay/rails.rb
 - lib/simplepay/service.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
@@ -104,6 +106,8 @@ files:
 - script/generate
 - simplepay.gemspec
 - test/simplepay/helpers/test_notifier.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