pay_with_amazon 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1352bad3d051550f618f54fb20deb352c04bcb1b
-  data.tar.gz: 078b3a6429e4add06edfd3efeb2e5d3bde52cf16
+  metadata.gz: 540fd0fdf13854727e8cf3ee539ea88010295308
+  data.tar.gz: 46c573769d9f978f9c597af943d60d96cccb39c8
 SHA512:
-  metadata.gz: bc9551b058cd013c64647824499ba465dfc8d3af3a53a1953403fa1a641e71920e40d49a4eb2d6283e034323e11add5370897718c0b0c0da14262a06a6bba2e5
-  data.tar.gz: 828e07bb06698e7291098a2998eaa20782628c38d4309cd0a8455134f0b10278628467885fa21df99650d4cdedbdb32870267ef0a08b26b76be5071169265dcb
+  metadata.gz: cc1788370ce2e5a3c9733ce0dec4cdead496af0617cb9fc1766f5944a49522743ae6d04236ce13dae47ffc0cccbc997ab1aa697b7af4104f3017b2bba6ebec4b
+  data.tar.gz: 4ca87d9bc5a23f623d349203c9dcbb01e1e9b2c45f6ef36172401a14176d4fa60656175fa451d6f4bac5da891416f12275c04921fc877c6b7cc293530329a074

data/README.md

@@ -12,7 +12,7 @@ or add the following in your Gemfile:
 gem 'pay_with_amazon'
 ```
 ```
-Bundle Install
+bundle install
 ```
 
 ## Requirements
@@ -149,7 +149,7 @@ response.success
 ### Instant Payment Notification Verification and Parsing
 
 ```ruby
-# This can be placed in your controller for a method
+# This can be placed in your rails controller for a method
 # that is configured to receive a "POST" IPN from Amazon.
 headers = request.headers
 body = request.body.read
@@ -179,3 +179,246 @@ ipn.notification_data
 ipn.message_timestamp
 
 ```
+
+### One Time Transaction API Flow
+
+```ruby
+require 'pay_with_amazon'
+
+# Your Login and Pay with Amazon keys are
+# available in your Seller Central account
+merchant_id = 'YOUR_MERCHANT_ID'
+access_key = 'YOUR_ACCESS_KEY'
+secret_key = 'YOUR_SECRET_KEY'
+
+client = PayWithAmazon::Client.new(
+  merchant_id,
+  access_key,
+  secret_key,
+  sandbox: true
+)
+
+# These values are grabbed from the Login and Pay
+# with Amazon Address and Wallet widgets
+amazon_order_reference_id = 'AMAZON_ORDER_REFERENCE_ID'
+address_consent_token = 'ADDRESS_CONSENT_TOKEN'
+
+# To get the buyers full address if shipping/tax
+# calculations are needed you can use the following
+# API call to obtain the order reference details.
+client.get_order_reference_details(
+  amazon_order_reference_id,
+  address_consent_token: address_consent_token
+)
+
+# Set the amount for the transaction.
+amount = '10.00'
+
+# Make the SetOrderReferenceDetails API call to
+# configure the Amazon Order Reference Id.
+# There are additional optional parameters that
+# are not used below.
+client.set_order_reference_details(
+  amazon_order_reference_id,
+  amount,
+  currency_code: 'USD', # Default: USD
+  seller_note: 'Your Seller Note',
+  seller_order_id: 'Your Seller Order Id',
+  store_name: 'Your Store Name'
+)
+
+# Make the ConfirmOrderReference API call to
+# confirm the details set in the API call
+# above.
+client.confirm_order_reference(amazon_order_reference_id)
+
+# Set a unique id for your current authorization
+# of this payment.
+authorization_reference_id = 'Your Unique Id'
+
+# Make the Authorize API call to authorize the
+# transaction. You can also capture the amount
+# in this API call or make the Capture API call
+# separately. There are additional optional
+# parameters not used below.
+response = client.authorize(
+  amazon_order_reference_id,
+  authorization_reference_id,
+  amount,
+  currency_code: 'USD', # Default: USD
+  seller_authorization_note: 'Your Authorization Note',
+  transaction_timeout: 0, # Set to 0 for synchronous mode
+  capture_now: true # Set this to true if you want to capture the amount in the same API call
+)
+
+# You will need the Amazon Authorization Id from the
+# Authorize API response if you decide to make the
+# Capture API call separately.
+amazon_authorization_id = response.get_element('AuthorizeResponse/AuthorizeResult/AuthorizationDetails','AmazonAuthorizationId')
+
+# Set a unique id for your current capture of
+# this payment.
+capture_reference_id = 'Your Unique Id'
+
+# Make the Capture API call if you did not set the
+# 'capture_now' parameter to 'true'. There are
+# additional optional parameters that are not used
+# below.
+client.capture(
+  amazon_authorization_id,
+  capture_reference_id,
+  amount,
+  currency_code: 'USD', # Default: USD
+  seller_capture_note: 'Your Capture Note'
+)
+
+# Close the order reference once your one time
+# transaction is complete.
+client.close_order_reference(amazon_order_reference_id)
+
+```
+
+### Subscriptions API Flow
+
+```ruby
+require 'pay_with_amazon'
+
+# Your Login and Pay with Amazon keys are
+# available in your Seller Central account
+merchant_id = 'YOUR_MERCHANT_ID'
+access_key = 'YOUR_ACCESS_KEY'
+secret_key = 'YOUR_SECRET_KEY'
+
+client = PayWithAmazon::Client.new(
+  merchant_id,
+  access_key,
+  secret_key,
+  sandbox: true
+)
+
+# These values are grabbed from the Login and Pay
+# with Amazon Address and Wallet widgets
+amazon_billing_agreement_id = 'AMAZON_BILLING_AGREEMENT_ID'
+address_consent_token = 'ADDRESS_CONSENT_TOKEN'
+
+# To get the buyers full address, if shipping/tax
+# calculations are needed, you can use the following
+# API call to obtain the billing agreement details.
+client.get_billing_agreement_details(
+  amazon_billing_agreement_id,
+  address_consent_token: address_consent_token
+)
+
+# Next you will need to set the various details
+# for this subscription with the following API call.
+# There are additional optional parameters that
+# are not used below.
+client.set_billing_agreement_details(
+  amazon_billing_agreement_id,
+  seller_note: 'Your Seller Note',
+  seller_billing_agreement_id: 'Your Transaction Id',
+  store_name: 'Your Store Name',
+  custom_information: 'Additional Information'
+)
+
+# Make the ConfirmBillingAgreement API call to confirm
+# the Amazon Billing Agreement Id with the details set above.
+# Be sure that everything is set correctly above before
+# confirming.
+client.confirm_billing_agreement(amazon_billing_agreement_id)
+
+# The following API call is not needed at this point, but
+# can be used in the future when you need to validate that
+# the payment method is still valid with the associated billing
+# agreement id.
+client.validate_billing_agreement(amazon_billing_agreement_id)
+
+# Set the amount for your first authorization.
+amount = '10.00'
+
+# Set a unique authorization reference id for your
+# first transaction on the billing agreement.
+authorization_reference_id = 'Your Unique Id'
+
+# Now you can authorize your first transaction on the
+# billing agreement id. Every month you can make the
+# same API call to continue charging your buyer
+# with the 'capture_now' parameter set to true. You can
+# also make the Capture API call separately. There are
+# additional optional parameters that are not used
+# below.
+response = client.authorize_on_billing_agreement(
+  amazon_billing_agreement_id,
+  authorization_reference_id,
+  amount,
+  currency_code: 'USD', # Default: USD
+  seller_authorization_note: 'Your Authorization Note',
+  transaction_timeout: 0, # Set to 0 for synchronous mode
+  capture_now: true, # Set this to true if you want to capture the amount in the same API call
+  seller_note: 'Your Seller Note',
+  seller_order_id: 'Your Order Id',
+  store_name: 'Your Store Name',
+  custom_information: 'Additional Information'
+)
+
+# You will need the Amazon Authorization Id from the
+# AuthorizeOnBillingAgreement API response if you decide
+# to make the Capture API call separately.
+amazon_authorization_id = response.get_element('AuthorizeOnBillingAgreementResponse/AuthorizeOnBillingAgreementResult/AuthorizationDetails','AmazonAuthorizationId')
+
+# Set a unique id for your current capture of
+# this transaction.
+capture_reference_id = 'Your Unique Id'
+
+# Make the Capture API call if you did not set the
+# 'capture_now' parameter to 'true'. There are
+# additional optional parameters that are not used
+# below.
+client.capture(
+  amazon_authorization_id,
+  capture_reference_id,
+  amount,
+  currency_code: 'USD', # Default: USD
+  seller_capture_note: 'Your Capture Note'
+)
+
+# The following API call should not be made until you
+# are ready to terminate the billing agreement.
+client.close_billing_agreement(
+  amazon_billing_agreement_id,
+  closure_reason: 'Reason For Closing'
+)
+
+```
+
+### Get Login Profile API
+
+This API call allows you to obtain user profile information
+once a user has logged into your application using
+their Amazon credentials.
+
+```ruby
+require 'pay_with_amazon'
+
+# Your client id is located in your Seller
+# Central account.
+client_id = 'Your Client Id'
+
+login = PayWithAmazon::Login.new(
+  client_id,
+  region: :na, # Default: :na
+  sandbox: true # Default: false
+)
+
+# The access token is available in the return URL
+# parameters after a user has logged in.
+access_token = 'User Access Token'
+
+# Make the 'get_login_profile' api call.
+profile = login.get_login_profile(access_token)
+
+name = profile['name']
+email = profile['email']
+user_id = profile['user_id']
+
+```

data/lib/pay_with_amazon.rb

@@ -1,4 +1,7 @@
 require 'pay_with_amazon/client'
+require 'pay_with_amazon/client_helper'
 require 'pay_with_amazon/ipn_handler'
+require 'pay_with_amazon/login'
+require 'pay_with_amazon/request'
 require 'pay_with_amazon/response'
 require 'pay_with_amazon/version'

data/lib/pay_with_amazon/client.rb

@@ -1,8 +1,3 @@
-require 'uri'
-require 'net/http'
-require 'net/https'
-require 'base64'
-require 'openssl'
 require 'time'
 
 module PayWithAmazon
@@ -14,8 +9,6 @@ module PayWithAmazon
   # uses the standard Ruby library and is not dependant on Rails.
   class Client
 
-    MAX_RETRIES = 4
-
     attr_reader(
       :merchant_id,
       :access_key,
@@ -36,7 +29,7 @@ module PayWithAmazon
       :proxy_pass)
 
     # API keys are located at:
-    # @see htps://sellercentral.amazon.com
+    # @see https://sellercentral.amazon.com
     # @param merchant_id [String]
     # @param access_key [String]
     # @param secret_key [String]
@@ -44,7 +37,7 @@ module PayWithAmazon
     # @optional currency_code [Symbol] Default: :usd
     # @optional region [Symbol] Default: :na
     # @optional platform_id [String] Default: nil
-    # @optional throttle [Boolean]
+    # @optional throttle [Boolean] Default: true
     # @optional application_name [String]
     # @optional application_version [String]
     # @optional proxy_addr [String]
@@ -95,8 +88,7 @@ module PayWithAmazon
       @default_hash['PlatformId'] = @platform_id if @platform_id
     end
 
-    # Returns the operational status of the Off-Amazon Payments API section
-    # The GetServiceStatus operation returns the operational status of the Off-Amazon Payments API
+    # The GetServiceStatus operation returns the operational status of the Amazon Payments API
     # section of Amazon Marketplace Web Service (Amazon MWS). Status values are GREEN, GREEN_I, YELLOW, and RED.
     # @see http://docs.developer.amazonservices.com/en_US/off_amazon_payments/OffAmazonPayments_GetServiceStatus.html
     def get_service_status
@@ -306,7 +298,7 @@ module PayWithAmazon
             custom_information: nil,
             seller_order_id: nil,
             store_name: nil,
-            inherit_shipping_adderess: nil,
+            inherit_shipping_address: nil,
             merchant_id: @merchant_id,
             mws_auth_token: nil)
 
@@ -329,7 +321,7 @@ module PayWithAmazon
         'SellerOrderAttributes.CustomInformation' => custom_information,
         'SellerOrderAttributes.SellerOrderId' => seller_order_id,
         'SellerOrderAttributes.StoreName' => store_name,
-        'InheritShippingAddress' => inherit_shipping_adderess,
+        'InheritShippingAddress' => inherit_shipping_address,
         'MWSAuthToken' => mws_auth_token
       }
 
@@ -496,6 +488,7 @@ module PayWithAmazon
     # @optional transaction_timeout [Integer]
     # @optional capture_now [Boolean]
     # @optional soft_descriptor [String]
+    # @optional provider_credit_details [Array of Hash]
     # @optional merchant_id [String]
     # @optional mws_auth_token [String]
     def authorize(
@@ -507,6 +500,7 @@ module PayWithAmazon
             transaction_timeout: nil,
             capture_now: nil,
             soft_descriptor: nil,
+            provider_credit_details: nil,
             merchant_id: @merchant_id,
             mws_auth_token: nil)
 
@@ -527,6 +521,8 @@ module PayWithAmazon
         'MWSAuthToken' => mws_auth_token
       }
 
+      optional.merge!(set_provider_credit_details(provider_credit_details)) if provider_credit_details
+
       operation(parameters, optional)
     end
 
@@ -562,6 +558,7 @@ module PayWithAmazon
     # @optional currency_code [String]
     # @optional seller_capture_note [String]
     # @optional soft_descriptor [String]
+    # @optional provider_credit_details [Array of Hash]
     # @optional merchant_id [String]
     # @optional mws_auth_token [String]
     def capture(
@@ -571,6 +568,7 @@ module PayWithAmazon
             currency_code: @currency_code,
             seller_capture_note: nil,
             soft_descriptor: nil,
+            provider_credit_details: nil,
             merchant_id: @merchant_id,
             mws_auth_token: nil)
 
@@ -589,6 +587,8 @@ module PayWithAmazon
         'MWSAuthToken' => mws_auth_token
       }
 
+      optional.merge!(set_provider_credit_details(provider_credit_details)) if provider_credit_details
+
       operation(parameters, optional)
     end
 
@@ -624,6 +624,7 @@ module PayWithAmazon
     # @optional currency_code [String]
     # @optional seller_refund_note [String]
     # @optional soft_descriptor [String]
+    # @optional provider_credit_reversal_details [Array of Hash]
     # @optional merchant_id [String]
     # @optional mws_auth_token [String]
     def refund(
@@ -633,6 +634,7 @@ module PayWithAmazon
             currency_code: @currency_code,
             seller_refund_note: nil,
             soft_descriptor: nil,
+            provider_credit_reversal_details: nil,
             merchant_id: @merchant_id,
             mws_auth_token: nil)
 
@@ -651,6 +653,8 @@ module PayWithAmazon
         'MWSAuthToken' => mws_auth_token
       }
 
+      optional.merge!(set_provider_credit_reversal_details(provider_credit_reversal_details)) if provider_credit_reversal_details
+
       operation(parameters, optional)
     end
 
@@ -731,6 +735,81 @@ module PayWithAmazon
       operation(parameters, optional)
     end
 
+    # @param amazon_provider_credit_id [String]
+    # @optional merchant_id [String]
+    # @optional mws_auth_token [String]
+    def get_provider_credit_details(
+            amazon_provider_credit_id,
+            merchant_id: @merchant_id,
+            mws_auth_token: nil)
+
+        parameters = {
+          'Action' => 'GetProviderCreditDetails',
+          'SellerId' => merchant_id,
+          'AmazonProviderCreditId' => amazon_provider_credit_id
+        }
+
+        optional = {
+          'MWSAuthToken' => mws_auth_token
+        }
+
+        operation(parameters, optional)
+    end
+
+    # @param amazon_provider_credit_reversal_id [String]
+    # @optional merchant_id [String]
+    # @optional mws_auth_token [String]
+    def get_provider_credit_reversal_details(
+            amazon_provider_credit_reversal_id,
+            merchant_id: @merchant_id,
+            mws_auth_token: nil)
+
+        parameters = {
+          'Action' => 'GetProviderCreditReversalDetails',
+          'SellerId' => merchant_id,
+          'AmazonProviderCreditReversalId' => amazon_provider_credit_reversal_id
+        }
+
+        optional = {
+          'MWSAuthToken' => mws_auth_token
+        }
+
+        operation(parameters, optional)
+    end
+
+    # @param amazon_provider_credit_id [String]
+    # @param credit_reversal_reference_id [String]
+    # @param amount [String]
+    # @optional currency_code [String]
+    # @optional credit_reversal_note [String]
+    # @optional merchant_id [String]
+    # @optional mws_auth_token [String]
+    def reverse_provider_credit(
+            amazon_provider_credit_id,
+            credit_reversal_reference_id,
+            amount,
+            currency_code: @currency_code,
+            credit_reversal_note: nil,
+            merchant_id: @merchant_id,
+            mws_auth_token: nil)
+
+      parameters = {
+        'Action' => 'ReverseProviderCredit',
+        'SellerId' => merchant_id,
+        'AmazonProviderCreditId' => amazon_provider_credit_id,
+        'CreditReversalReferenceId' => credit_reversal_reference_id,
+        'CreditReversalAmount.Amount' => amount,
+        'CreditReversalAmount.CurrencyCode' => currency_code
+      }
+
+      optional = {
+        'CreditReversalNote' => credit_reversal_note,
+        'MWSAuthToken' => mws_auth_token
+      }
+
+      operation(parameters, optional)
+    end
+
     private
 
     def region_hash
@@ -744,61 +823,51 @@ module PayWithAmazon
       }
     end
 
-    # This method combines the required and optional
-    # parameters to generate the post url, sign the post body,
-    # and send the post request.
-    def operation(parameters, optional)
-      optional.map { |k, v| parameters[k] = v unless v.nil? }
-      parameters = @default_hash.merge(parameters)
-      post_url = parameters.sort.map { |k, v| "#{k}=#{ custom_escape(v) }" }.join("&")
-      post_body = ["POST", "#{@mws_endpoint}", "/#{@sandbox_str}/#{PayWithAmazon::API_VERSION}", post_url].join("\n")
-      post_url += "&Signature=" + sign(post_body)
-      send_request(@mws_endpoint, @sandbox_str, post_url)
-    end
+    # This method builds the provider credit details hash
+    # that will be combined with either the authorize or capture
+    # API call.
+    def set_provider_credit_details(provider_credit_details)
+      member_details = {}
+      provider_credit_details.each_with_index { |val, index|
+        member = index + 1
+        member_details["ProviderCreditList.member.#{member}.ProviderId"] = val[:provider_id]
+        member_details["ProviderCreditList.member.#{member}.CreditAmount.Amount"] = val[:amount]
+        member_details["ProviderCreditList.member.#{member}.CreditAmount.CurrencyCode"] = val[:currency_code]
+      }
 
-    # This method signs the post body request that is being sent
-    # using the secret key provided.
-    def sign(post_body)
-      custom_escape(Base64.strict_encode64(OpenSSL::HMAC.digest(OpenSSL::Digest::SHA256.new, @secret_key, post_body)))
+      return member_details
     end
 
-    # This method performs the post to the MWS end point.
-    # It will retry three times after the initial post if
-    # the status code comes back as either 500 or 503.
-    def send_request(mws_endpoint, sandbox_str, post_url)
-      uri = URI("https://#{mws_endpoint}/#{sandbox_str}/#{PayWithAmazon::API_VERSION}")
-      https = Net::HTTP.new(uri.host, uri.port, @proxy_addr, @proxy_port, @proxy_user, @proxy_pass)
-      https.use_ssl = true
-      https.verify_mode = OpenSSL::SSL::VERIFY_PEER
-      user_agent = {"User-Agent" => "Language=Ruby; ApplicationLibraryVersion=#{PayWithAmazon::VERSION}; Platform=#{RUBY_PLATFORM}; MWSClientVersion=#{PayWithAmazon::API_VERSION}; ApplicationName=#{@application_name}; ApplicationVersion=#{@application_version}"}
-      tries = 0
-      begin
-        response = https.post(uri.path, post_url, user_agent)
-        if @throttle.eql?(true)
-          if response.code.eql?('500')
-            raise 'InternalServerError'
-          elsif response.code.eql?('503')
-            raise 'ServiceUnavailable or RequestThrottled'
-          end
-        end
-        PayWithAmazon::Response.new(response)
-      rescue => error
-        tries += 1
-        sleep(get_seconds_for_try_count(tries))
-        retry if tries < MAX_RETRIES
-        raise error.message
-      end
-    end
+    # This method builds the provider credit reversal
+    # details hash that will be combined with the refund
+    # API call.
+    def set_provider_credit_reversal_details(provider_credit_reversal_details)
+      member_details = {}
+      provider_credit_reversal_details.each_with_index { |val, index|
+        member = index + 1
+        member_details["ProviderCreditReversalList.member.#{member}.ProviderId"] = val[:provider_id]
+        member_details["ProviderCreditReversalList.member.#{member}.CreditReversalAmount.Amount"] = val[:amount]
+        member_details["ProviderCreditReversalList.member.#{member}.CreditReversalAmount.CurrencyCode"] = val[:currency_code]
+      }
 
-    def get_seconds_for_try_count(try_count)
-      seconds = { 1=>1, 2=>4, 3=>10, 4=>0 }
-      seconds[try_count]
+      return member_details
     end
 
-    def custom_escape(val)
-      val.to_s.gsub(/([^\w.~-]+)/) do
-        "%" + $1.unpack("H2" * $1.bytesize).join("%").upcase
-      end
+    def operation(parameters, optional)
+      PayWithAmazon::Request.new(
+          parameters,
+          optional,
+          @default_hash,
+          @mws_endpoint,
+          @sandbox_str,
+          @secret_key,
+          @proxy_addr,
+          @proxy_port,
+          @proxy_user,
+          @proxy_pass,
+          @throttle,
+          @application_name,
+          @application_version).send_post
     end
 
   end

data/lib/pay_with_amazon/client_helper.rb

@@ -0,0 +1,193 @@
+module PayWithAmazon
+
+  # This will extend the client class to add additional
+  # helper methods that combine core API calls.
+  class Client
+
+    # This method combines multiple API calls to perform
+    # a complete transaction with minimum requirements.
+    # @param amazon_reference_id [String]
+    # @param authorization_reference_id [String]
+    # @param charge_amount [String]
+    # @optional charge_currency_code [String]
+    # @optional charge_note [String]
+    # @optional charge_order [String]
+    # @optional store_name [String]
+    # @optional custom_information [String]
+    # @optional soft_descriptor [String]
+    # @optional platform_id [String]
+    # @optional merchant_id [String]
+    # @optional mws_auth_token [String]
+    def charge(
+            amazon_reference_id,
+            authorization_reference_id,
+            charge_amount,
+            charge_currency_code: @currency_code,
+            charge_note: nil,
+            charge_order_id: nil,
+            store_name: nil,
+            custom_information: nil,
+            soft_descriptor: nil,
+            platform_id: nil,
+            merchant_id: @merchant_id,
+            mws_auth_token: nil)
+
+      if is_order_reference?(amazon_reference_id)
+        response = call_order_reference_api(
+                       amazon_reference_id,
+                       authorization_reference_id,
+                       charge_amount,
+                       charge_currency_code,
+                       charge_note,
+                       charge_order_id,
+                       store_name,
+                       custom_information,
+                       soft_descriptor,
+                       platform_id,
+                       merchant_id,
+                       mws_auth_token)
+        return response
+      end
+
+      if is_billing_agreement?(amazon_reference_id)
+        response = call_billing_agreement_api(
+                       amazon_reference_id,
+                       authorization_reference_id,
+                       charge_amount,
+                       charge_currency_code,
+                       charge_note,
+                       charge_order_id,
+                       store_name,
+                       custom_information,
+                       soft_descriptor,
+                       platform_id,
+                       merchant_id,
+                       mws_auth_token)
+        return response
+      end
+    end
+
+    private
+
+    def call_order_reference_api(
+            amazon_reference_id,
+            authorization_reference_id,
+            charge_amount,
+            charge_currency_code,
+            charge_note,
+            charge_order_id,
+            store_name,
+            custom_information,
+            soft_descriptor,
+            platform_id,
+            merchant_id,
+            mws_auth_token)
+
+      response = set_order_reference_details(
+        amazon_reference_id,
+        charge_amount,
+        currency_code: charge_currency_code,
+        platform_id: platform_id,
+        seller_note: charge_note,
+        seller_order_id: charge_order_id,
+        store_name: store_name,
+        custom_information: custom_information,
+        merchant_id: merchant_id,
+        mws_auth_token: mws_auth_token)
+      if response.success
+        response = confirm_order_reference(
+          amazon_reference_id,
+          merchant_id: merchant_id,
+          mws_auth_token: mws_auth_token)
+        if response.success
+          response = authorize(
+            amazon_reference_id,
+            authorization_reference_id,
+            charge_amount,
+            currency_code: charge_currency_code,
+            seller_authorization_note: charge_note,
+            transaction_timeout: 0,
+            capture_now: true,
+            soft_descriptor: soft_descriptor,
+            merchant_id: merchant_id,
+            mws_auth_token: mws_auth_token)
+          return response
+        else
+          return response
+        end
+      else
+        return response
+      end
+    end
+
+    def call_billing_agreement_api(
+            amazon_reference_id,
+            authorization_reference_id,
+            charge_amount,
+            charge_currency_code,
+            charge_note,
+            charge_order_id,
+            store_name,
+            custom_information,
+            soft_descriptor,
+            platform_id,
+            merchant_id,
+            mws_auth_token)
+
+      response = get_billing_agreement_details(
+        amazon_reference_id,
+        merchant_id: merchant_id,
+        mws_auth_token: mws_auth_token)
+      if response.get_element('GetBillingAgreementDetailsResponse/GetBillingAgreementDetailsResult/BillingAgreementDetails/BillingAgreementStatus','State').eql?('Draft')
+        response = set_billing_agreement_details(
+          amazon_reference_id,
+          platform_id: platform_id,
+          seller_note: charge_note,
+          seller_billing_agreement_id: charge_order_id,
+          store_name: store_name,
+          custom_information: custom_information,
+          merchant_id: merchant_id,
+          mws_auth_token: mws_auth_token)
+        if response.success
+          response = confirm_billing_agreement(
+            amazon_reference_id,
+            merchant_id: merchant_id,
+            mws_auth_token: mws_auth_token)
+          if response.success.eql?(false)
+            return response
+          end
+        end
+      end
+
+      response = authorize_on_billing_agreement(
+        amazon_reference_id,
+        authorization_reference_id,
+        charge_amount,
+        currency_code: charge_currency_code,
+        seller_authorization_note: charge_note,
+        transaction_timeout: 0,
+        capture_now: true,
+        soft_descriptor: soft_descriptor,
+        seller_note: charge_note,
+        platform_id: platform_id,
+        seller_order_id: charge_order_id,
+        store_name: store_name,
+        custom_information: custom_information,
+        inherit_shipping_address: true,
+        merchant_id: merchant_id,
+        mws_auth_token: mws_auth_token)
+      return response
+    end
+
+
+    def is_order_reference?(amazon_reference_id)
+      amazon_reference_id.start_with?('S','P')
+    end
+
+    def is_billing_agreement?(amazon_reference_id)
+      amazon_reference_id.start_with?('C','B')
+    end
+
+  end
+
+end

data/lib/pay_with_amazon/ipn_handler.rb

@@ -31,10 +31,7 @@ module PayWithAmazon
     attr_reader(:headers, :body)
     attr_accessor(:proxy_addr, :proxy_port, :proxy_user, :proxy_pass)
 
-    # To initialize this class you will be required to
-    # pass in the request header and body. The body can be
-    # passed in parsed by json or without.
-    # @param header [request.headers]
+    # @param headers [request.headers]
     # @param body [request.body.read]
     # @optional proxy_addr [String]
     # @optional proxy_port [String]
@@ -58,7 +55,7 @@ module PayWithAmazon
     end
 
     # This method will authenticate the ipn message sent from Amazon.
-    # It will return true if everything is verified. It will display an
+    # It will return true if everything is verified. It will raise an
     # error message if verification fails.
     def authentic?
       begin

data/lib/pay_with_amazon/login.rb

@@ -0,0 +1,75 @@
+require 'uri'
+require 'net/http'
+require 'net/https'
+require 'json'
+require 'openssl'
+
+module PayWithAmazon
+
+  # Login with Amazon API
+  #
+  # This class allows you to obtain user profile
+  # information once a user has logged into your
+  # application using their Amazon credentials.
+  class Login
+
+    attr_reader(:region)
+
+    attr_accessor(:client_id, :sandbox)
+
+    # @param client_id [String]
+    # @optional region [Symbol] Default: :na
+    # @optional sandbox [Boolean] Default: false
+    def initialize(client_id, region: :na, sandbox: false)
+      @client_id = client_id
+      @region = region
+      @endpoint = region_hash[@region]
+      @sandbox = sandbox
+      @sandbox_str = @sandbox ? "api.sandbox" : "api"
+    end
+
+    # This method will validate the access token and
+    # return the user's profile information.
+    # @param access_token [String]
+    def get_login_profile(access_token)
+      decoded_access_token = URI.decode(access_token)
+      encoded_access_token = URI.encode(decoded_access_token)
+      uri = URI("https://#{@sandbox_str}.#{@endpoint}/auth/o2/tokeninfo?access_token=#{encoded_access_token}")
+      req = Net::HTTP::Get.new(uri.request_uri)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = true
+      http.verify_mode = OpenSSL::SSL::VERIFY_PEER
+      response = http.request(req)
+      decode = JSON.parse(response.body)
+
+      if decode['aud'] != @client_id
+        raise "Invalid Access Token"
+      end
+
+      uri = URI.parse("https://#{@sandbox_str}.#{@endpoint}/user/profile")
+      req = Net::HTTP::Get.new(uri.request_uri)
+      req['Authorization'] = "bearer " + decoded_access_token
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = true
+      http.verify_mode = OpenSSL::SSL::VERIFY_PEER
+      response = http.request(req)
+      decoded_login_profile = JSON.parse(response.body)
+      return decoded_login_profile
+    end
+
+    private
+
+    def region_hash
+      {
+        :jp => 'amazon.co.jp',
+        :uk => 'amazon.co.uk',
+        :de => 'amazon.de',
+        :eu => 'amazon.co.uk',
+        :us => 'amazon.com',
+        :na => 'amazon.com'
+      }
+    end
+
+  end
+
+end

data/lib/pay_with_amazon/request.rb

@@ -0,0 +1,112 @@
+require 'uri'
+require 'net/http'
+require 'net/https'
+require 'base64'
+require 'openssl'
+
+module PayWithAmazon
+
+  # This class creates the request to send to the
+  # specified MWS endpoint.
+  class Request
+
+    MAX_RETRIES = 3
+
+    def initialize(
+            parameters,
+            optional,
+            default_hash,
+            mws_endpoint,
+            sandbox_str,
+            secret_key,
+            proxy_addr,
+            proxy_port,
+            proxy_user,
+            proxy_pass,
+            throttle,
+            application_name,
+            application_version)
+
+      @parameters = parameters
+      @optional = optional
+      @default_hash = default_hash
+      @mws_endpoint = mws_endpoint
+      @sandbox_str = sandbox_str
+      @secret_key = secret_key
+      @proxy_addr = proxy_addr
+      @proxy_port = proxy_port
+      @proxy_user = proxy_user
+      @proxy_pass = proxy_pass
+      @throttle = throttle
+      @application_name = application_name
+      @application_version = application_version
+    end
+
+    # This method sends the post request.
+    def send_post
+      post_url = build_post_url
+      post(@mws_endpoint, @sandbox_str, post_url)
+    end
+
+    private
+
+    # This method combines the required and optional
+    # parameters to sign the post body and generate
+    # the post url.
+    def build_post_url
+      @optional.map { |k, v| @parameters[k] = v unless v.nil? }
+      @parameters = @default_hash.merge(@parameters)
+      post_url = @parameters.sort.map { |k, v| "#{k}=#{ custom_escape(v) }" }.join("&")
+      post_body = ["POST", "#{@mws_endpoint}", "/#{@sandbox_str}/#{PayWithAmazon::API_VERSION}", post_url].join("\n")
+      post_url += "&Signature=" + sign(post_body)
+      return post_url
+    end
+
+    # This method signs the post body that is being sent
+    # using the secret key provided.
+    def sign(post_body)
+      custom_escape(Base64.strict_encode64(OpenSSL::HMAC.digest(OpenSSL::Digest::SHA256.new, @secret_key, post_body)))
+    end
+
+    # This method performs the post to the MWS endpoint.
+    # It will retry three times after the initial post if
+    # the status code comes back as either 500 or 503.
+    def post(mws_endpoint, sandbox_str, post_url)
+      uri = URI("https://#{mws_endpoint}/#{sandbox_str}/#{PayWithAmazon::API_VERSION}")
+      https = Net::HTTP.new(uri.host, uri.port, @proxy_addr, @proxy_port, @proxy_user, @proxy_pass)
+      https.use_ssl = true
+      https.verify_mode = OpenSSL::SSL::VERIFY_PEER
+      user_agent = {"User-Agent" => "Language=Ruby; ApplicationLibraryVersion=#{PayWithAmazon::VERSION}; Platform=#{RUBY_PLATFORM}; MWSClientVersion=#{PayWithAmazon::API_VERSION}; ApplicationName=#{@application_name}; ApplicationVersion=#{@application_version}"}
+      tries = 0
+      begin
+        response = https.post(uri.path, post_url, user_agent)
+        if @throttle.eql?(true)
+          if response.code.eql?('500')
+            raise 'InternalServerError'
+          elsif response.code.eql?('503')
+            raise 'ServiceUnavailable or RequestThrottled'
+          end
+        end
+        PayWithAmazon::Response.new(response)
+      rescue => error
+        tries += 1
+        sleep(get_seconds_for_try_count(tries))
+        retry if tries <= MAX_RETRIES
+        raise error.message
+      end
+    end
+
+    def get_seconds_for_try_count(try_count)
+      seconds = { 1=>1, 2=>4, 3=>10, 4=>0 }
+      seconds[try_count]
+    end
+
+    def custom_escape(val)
+      val.to_s.gsub(/([^\w.~-]+)/) do
+        "%" + $1.unpack("H2" * $1.bytesize).join("%").upcase
+      end
+    end
+
+  end
+
+end

data/lib/pay_with_amazon/response.rb

@@ -5,7 +5,6 @@ module PayWithAmazon
   # This class provides helpers to parse the response
   class Response
 
-     # @param response [String]
      def initialize(response)
        @response = response
      end

data/lib/pay_with_amazon/version.rb

@@ -1,4 +1,4 @@
 module PayWithAmazon
-  VERSION = "1.0.0"
+  VERSION = "1.1.0"
   API_VERSION = "2013-01-01"
 end

metadata

@@ -1,17 +1,17 @@
 --- !ruby/object:Gem::Specification
 name: pay_with_amazon
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Amazon Payments
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-04-07 00:00:00.000000000 Z
+date: 2015-05-11 00:00:00.000000000 Z
 dependencies: []
-description: Login and Pay with Amazon Ruby SDK
-email: 
+description: Amazon Payments - Login and Pay with Amazon Ruby SDK
+email: pay-with-amazon-sdk@amazon.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -21,7 +21,10 @@ files:
 - README.md
 - lib/pay_with_amazon.rb
 - lib/pay_with_amazon/client.rb
+- lib/pay_with_amazon/client_helper.rb
 - lib/pay_with_amazon/ipn_handler.rb
+- lib/pay_with_amazon/login.rb
+- lib/pay_with_amazon/request.rb
 - lib/pay_with_amazon/response.rb
 - lib/pay_with_amazon/version.rb
 homepage: https://github.com/amzn/login-and-pay-with-amazon-sdk-ruby
@@ -47,6 +50,6 @@ rubyforge_project:
 rubygems_version: 2.4.5
 signing_key: 
 specification_version: 4
-summary: Login and Pay with Amazon Ruby SDK
+summary: Amazon Payments - Login and Pay with Amazon Ruby SDK
 test_files: []
 has_rdoc: