pagseguro-oficial 2.2.0 → 2.3.0

data/lib/pagseguro/authorization/response.rb

@@ -0,0 +1,49 @@
+module PagSeguro
+  class Authorization
+    class Response
+      def initialize(response, object)
+        @response = response
+        @object = object
+      end
+
+      def serialize
+        if success?
+          xml = Nokogiri::XML(response.body).css('authorization').first
+          serializer = ResponseSerializer.new(xml).serialize
+          object.update_attributes(serializer)
+        else
+          object.errors.add(response)
+        end
+
+        object
+      end
+
+      def serialize_collection
+        if success?
+          object.authorizations = serialize_authorizations
+        else
+          object.errors.add(response)
+        end
+
+        object
+      end
+
+      def success?
+        (response.success? && response.xml?) ? true : false
+      end
+
+      private
+      # The request response.
+      attr_reader :response
+
+      # The PagSeguro::Authorization or PagSeguro::Authorization::Collection object
+      attr_reader :object
+
+      def serialize_authorizations
+        Nokogiri::XML(response.body).css('authorizations > authorization').map do |node|
+          ResponseSerializer.new(node).serialize
+        end
+      end
+    end
+  end
+end

data/lib/pagseguro/authorization/response_serializer.rb

@@ -0,0 +1,39 @@
+module PagSeguro
+  class Authorization
+    class ResponseSerializer
+
+      def initialize(xml)
+        @xml = xml
+      end
+
+      def serialize
+        {}.tap do |data|
+          serialize_general(data)
+          serialize_permissions(data)
+        end
+      end
+
+      private
+      def serialize_general(data)
+        data[:code] = xml.css("> code").text
+        data[:reference] = xml.css("reference").text
+        data[:created_at] = Time.parse xml.css("creationDate").text
+      end
+
+      def serialize_permissions(data)
+        data[:permissions] = []
+
+        xml.css("permission").each do |node|
+          permission = PagSeguro::Permission.new
+          permission.code = node.css("code").text
+          permission.status = node.css("status").text
+          permission.last_update = node.css("lastUpdate").text
+
+          data[:permissions] << permission
+        end
+      end
+
+      attr_reader :xml
+    end
+  end
+end

data/lib/pagseguro/authorization.rb

@@ -0,0 +1,52 @@
+module PagSeguro
+  class Authorization
+    include Extensions::MassAssignment
+    include Extensions::Credentiable
+
+    # The authorization code
+    attr_accessor :code
+
+    # The authorization creation date
+    attr_accessor :created_at
+
+    # The reference related to the authorization
+    attr_accessor :reference
+
+    # The authorization permissions
+    attr_accessor :permissions
+
+    # Find an authorization by it's notification code
+    def self.find_by_notification_code(code, options = {})
+      request = Request.get("authorizations/notifications/#{code}", "v2", options)
+      authorization = PagSeguro::Authorization.new
+      Response.new(request, authorization).serialize
+
+      authorization
+    end
+
+    # Find an authorization by it's code
+    def self.find_by_code(code, options = {})
+      request = Request.get("authorizations/#{code}", "v2", options)
+      authorization = PagSeguro::Authorization.new
+      Response.new(request, authorization).serialize
+
+      authorization
+    end
+
+    def self.find_by_date(options)
+      request = Request.get("authorizations", "v2", RequestSerializer.new(options).to_params)
+      collection = Collection.new
+      Response.new(request, collection).serialize_collection
+
+      collection
+    end
+
+    def update_attributes(attrs)
+      attrs.map { |name, value| send("#{name}=", value) }
+    end
+
+    def errors
+      @errors ||= Errors.new
+    end
+  end
+end

data/lib/pagseguro/authorization_request/request_serializer.rb

@@ -0,0 +1,30 @@
+module PagSeguro
+  class AuthorizationRequest
+    class RequestSerializer
+      attr_reader :authorization_request
+
+      def initialize(authorization_request)
+        @authorization_request = authorization_request
+      end
+
+      def to_params
+        params[:credentials] = authorization_request.credentials if authorization_request.credentials
+        params[:notificationURL] = authorization_request.notification_url
+        params[:redirectURL] = authorization_request.redirect_url
+        params[:permissions] = serialize_permissions(authorization_request.permissions)
+        params[:reference] = authorization_request.reference if authorization_request.reference
+
+        params
+      end
+
+      private
+      def params
+        @params ||= {}
+      end
+
+      def serialize_permissions(permissions)
+        permissions.map { |value| PagSeguro::AuthorizationRequest::PERMISSIONS[value] }.join(',')
+      end
+    end
+  end
+end

data/lib/pagseguro/authorization_request/response.rb

@@ -0,0 +1,26 @@
+module PagSeguro
+  class AuthorizationRequest
+    class Response
+      def initialize(response)
+        @response = response
+      end
+
+      def serialize
+        if response.success? && response.xml?
+          xml = Nokogiri::XML(response.body).css('authorizationRequest').first
+          ResponseSerializer.new(xml).serialize
+        else
+          { errors: Errors.new(response) }
+        end
+      end
+
+      def success?
+        (response.success? && response.xml?) ? true : false
+      end
+
+      private
+      # The request response.
+      attr_reader :response
+    end
+  end
+end

data/lib/pagseguro/authorization_request/response_serializer.rb

@@ -0,0 +1,18 @@
+module PagSeguro
+  class AuthorizationRequest
+    class ResponseSerializer
+      attr_reader :xml
+
+      def initialize(xml)
+        @xml = xml
+      end
+
+      def serialize
+        {}.tap do |data|
+          data[:code] = xml.css("> code").text
+          data[:date] = Time.parse xml.css("date").text
+        end
+      end
+    end
+  end
+end

data/lib/pagseguro/authorization_request.rb

@@ -0,0 +1,72 @@
+module PagSeguro
+  class AuthorizationRequest
+    include Extensions::MassAssignment
+    include Extensions::Credentiable
+
+    # The permissions given to the application
+    # Defaults to all permissions
+    attr_accessor :permissions
+
+    # The seller reference (optional)
+    attr_accessor :reference
+
+    # The url which PagSeguro can send notifications
+    attr_accessor :notification_url
+
+    # The url which the application is going to be redirected after the proccess
+    attr_accessor :redirect_url
+
+    # The code used to confirm the authorization
+    attr_reader :code
+
+    # The date of authorization creation
+    attr_reader :date
+
+    # Errors object.
+    attr_writer :errors
+
+    PERMISSIONS = {
+      checkouts: 'CREATE_CHECKOUTS',
+      notifications: 'RECEIVE_TRANSACTION_NOTIFICATIONS',
+      searches: 'SEARCH_TRANSACTIONS',
+      pre_approvals: 'MANAGE_PAYMENT_PRE_APPROVALS',
+      payments: 'DIRECT_PAYMENT',
+      refunds: 'REFUND_TRANSACTIONS',
+      cancels: 'CANCEL_TRANSACTIONS'
+    }
+
+    # Post and create an Authorization.
+    # Return Boolean.
+    def create
+      request = Request.post('authorizations/request', 'v2', params)
+      response = Response.new(request)
+      update_attributes(response.serialize)
+
+      response.success?
+    end
+
+    # URL to confirm authorization after create one.
+    def url
+      PagSeguro.site_url("v2/authorization/request.jhtml?code=#{code}") if code
+    end
+
+    def errors
+      @errors ||= Errors.new
+    end
+
+    private
+    attr_writer :code, :date
+
+    def before_initialize
+      self.permissions = PERMISSIONS.keys
+    end
+
+    def params
+      RequestSerializer.new(self).to_params
+    end
+
+    def update_attributes(attrs)
+      attrs.each { |method, value| send("#{method}=", value) }
+    end
+  end
+end

data/lib/pagseguro/config.rb

@@ -10,5 +10,25 @@ module PagSeguro
 
     # The API token associated with this account.
     attr_accessor :token
+
+    # The application id
+    attr_accessor :app_id
+
+    # A token related to the application that is making the requests
+    attr_accessor :app_key
+
+    # The PagSeguro environment.
+    # +production+ or +sandbox+.
+    # Defaults to +production+.
+    attr_accessor :environment
+
+    # The encoding that will be used.
+    # Defaults to +UTF-8+.
+    attr_accessor :encoding
+
+    def initialize
+      @environment = :production
+      @encoding = "UTF-8"
+    end
   end
 end

data/lib/pagseguro/errors.rb

@@ -21,6 +21,7 @@ module PagSeguro
     private
     def process(response)
       @messages << error_message(:unauthorized, "Unauthorized") if response.unauthorized?
+      @messages << error_message(:not_found, "Not found") if response.not_found?
 
       response.data.css("errors > error").each do |error|
         @messages << error_message(error.css("code").text, error.css("message").text)

data/lib/pagseguro/extensions/credentiable.rb

@@ -0,0 +1,17 @@
+module PagSeguro
+  module Extensions
+    module Credentiable
+      # Get the credential object value
+      attr_reader :credentials
+
+      # Set a credential object
+      def credentials=(credentials)
+        if credentials.kind_of?(ApplicationCredentials) || credentials.kind_of?(AccountCredentials)
+          @credentials = credentials
+        else
+         raise 'Invalid credentials object'
+       end
+      end
+    end
+  end
+end

data/lib/pagseguro/installment.rb

@@ -20,9 +20,10 @@ module PagSeguro
 
     # Find installment options by a given amount
     # Optional. Credit card brand
+
     # Return a PagSeguro::Installment::Collection instance
-    def self.find(amount, card_brand = nil)
-      request = Request.get("installments", api_version, params(amount: amount, card_brand: card_brand))
+    def self.find(amount, card_brand, options = {})
+      request = Request.get("installments", api_version, options.merge(params(amount: amount, card_brand: card_brand)))
       collection = Collection.new
       Response.new(request, collection).serialize
 
@@ -30,6 +31,7 @@ module PagSeguro
     end
 
     private
+
     def self.params(options)
       RequestSerializer.new(options).to_params
     end

data/lib/pagseguro/notification/authorization.rb

@@ -0,0 +1,15 @@
+module PagSeguro
+  class Notification
+    class Authorization < PagSeguro::Notification
+      # Detect if the notification is from an authorization.
+      def authorization?
+        type == "applicationAuthorization"
+      end
+
+      # Fetch the authorization by its notificationCode.
+      def authorization
+        Authorization.find_by_notification_code(code)
+      end
+    end
+  end
+end

data/lib/pagseguro/notification/transaction.rb

@@ -0,0 +1,15 @@
+module PagSeguro
+  class Notification
+    class Transaction < PagSeguro::Notification
+      # Detect if the notification is from a transaction.
+      def transaction?
+        type == "transaction"
+      end
+
+      # Fetch the transaction by its notificationCode.
+      def transaction
+        Transaction.find_by_notification_code(code)
+      end
+    end
+  end
+end

data/lib/pagseguro/notification.rb

@@ -7,15 +7,5 @@ module PagSeguro
 
     # The notification type sent by PagSeguro.
     attr_accessor :type
-
-    # Detect if the notification is from a transaction.
-    def transaction?
-      type == "transaction"
-    end
-
-    # Fetch the transaction by its notificationCode.
-    def transaction
-      Transaction.find_by_notification_code(code)
-    end
   end
 end

data/lib/pagseguro/payment_request/serializer.rb

@@ -9,6 +9,7 @@ module PagSeguro
       end
 
       def to_params
+        params[:credentials] = payment_request.credentials if payment_request.credentials
         params[:receiverEmail] = PagSeguro.receiver_email
         params[:currency] = payment_request.currency
         params[:reference] = payment_request.reference

data/lib/pagseguro/payment_request.rb

@@ -2,6 +2,7 @@ module PagSeguro
   class PaymentRequest
     include Extensions::MassAssignment
     include Extensions::EnsureType
+    include Extensions::Credentiable
 
     # Set the payment currency.
     # Defaults to BRL.
@@ -51,12 +52,6 @@ module PagSeguro
     # complete the payment.
     attr_accessor :abandon_url
 
-    # The email that identifies the request. Defaults to PagSeguro.email
-    attr_accessor :email
-
-    # The token that identifies the request. Defaults to PagSeguro.token
-    attr_accessor :token
-
     # The extra parameters for payment request
     attr_accessor :extra_params
 
@@ -77,10 +72,7 @@ module PagSeguro
 
     # Calls the PagSeguro web service and register this request for payment.
     def register
-      params = Serializer.new(self).to_params.merge({
-        email: email,
-        token: token
-      })
+      params = Serializer.new(self).to_params
       Response.new Request.post("checkout", api_version, params)
     end
 
@@ -88,11 +80,8 @@ module PagSeguro
     def before_initialize
       self.extra_params = []
       self.currency = "BRL"
-      self.email    = PagSeguro.email
-      self.token    = PagSeguro.token
     end
 
-    # The default PagSeguro API version
     def api_version
       'v2'
     end

data/lib/pagseguro/permission.rb

@@ -0,0 +1,13 @@
+module PagSeguro
+  class Permission
+    include Extensions::MassAssignment
+    # The permission code
+    attr_accessor :code
+
+    # The permission status
+    attr_accessor :status
+
+    # The time when the permission was last updated
+    attr_accessor :last_update
+  end
+end

data/lib/pagseguro/request.rb

@@ -46,11 +46,13 @@ module PagSeguro
     end
 
     def extended_data(data)
-      data.merge(
-        email: data[:email] || PagSeguro.email,
-        token: data[:token] || PagSeguro.token,
-        charset: PagSeguro.encoding
-      )
+      if data[:credentials]
+        data.merge!(credentials_object(data))
+      else
+        data.merge!(global_credentials(data))
+      end
+      data.merge!({ charset: PagSeguro.encoding })
+      data.delete_if { |key, value| value.nil? }
     end
 
     def extended_headers(request_method, headers)
@@ -69,6 +71,36 @@ module PagSeguro
         "Accept-Charset" => PagSeguro.encoding
       }
     end
+
+    def credentials_object(data)
+      credentials = data.delete(:credentials)
+      if credentials.respond_to? :app_id
+        {
+          appId: credentials.app_id,
+          appKey: credentials.app_key,
+          authorizationCode: credentials.authorization_code
+        }
+      else
+        {
+          email: credentials.email,
+          token: credentials.token
+        }
+      end
+    end
+
+    def global_credentials(data)
+      if PagSeguro.app_id && PagSeguro.app_key
+        {
+          appId: PagSeguro.app_id,
+          appKey: PagSeguro.app_key
+        }
+      else
+        {
+          email: data[:email] || PagSeguro.email,
+          token: data[:token] || PagSeguro.token
+        }
+      end
+    end
   end
 
   Request.configure do |config|

data/lib/pagseguro/transaction/search/search_abandoned.rb

@@ -7,7 +7,8 @@ module PagSeguro
           initialDate: options[:starts_at].xmlschema,
           finalDate: options[:ends_at].xmlschema,
           page: page,
-          maxPageResults: options.fetch(:per_page, 50)
+          maxPageResults: options.fetch(:per_page, 50),
+          credentials: options[:credentials]
         })
       @errors = Errors.new(@response)
     end

data/lib/pagseguro/transaction/search/search_by_date.rb

@@ -7,7 +7,8 @@ module PagSeguro
           initialDate: options[:starts_at].xmlschema,
           finalDate: options[:ends_at].xmlschema,
           page: page,
-          maxPageResults: options.fetch(:per_page, 50)
+          maxPageResults: options.fetch(:per_page, 50),
+          credentials: options[:credentials]
         })
       @errors = Errors.new(@response)
     end

data/lib/pagseguro/transaction/search/search_by_reference.rb

@@ -5,6 +5,7 @@ module PagSeguro
       @response = Request.get(@path, api_version,
         {
           reference: options[:reference],
+          credentials: options[:credentials]
         })
       @errors = Errors.new(@response)
     end

data/lib/pagseguro/transaction.rb

@@ -2,6 +2,7 @@ module PagSeguro
   class Transaction
     include Extensions::MassAssignment
     include Extensions::EnsureType
+    include Extensions::Credentiable
 
     # When the payment request was created.
     attr_accessor :created_at
@@ -65,14 +66,14 @@ module PagSeguro
 
     # Find a transaction by its transactionCode
     # Return a PagSeguro::Transaction instance
-    def self.find_by_code(code)
-      load_from_response send_request("transactions/#{code}")
+    def self.find_by_code(code, options = {})
+      load_from_response send_request("transactions/#{code}", options)
     end
 
     # Find a transaction by its notificationCode.
     # Return a PagSeguro::Transaction instance.
-    def self.find_by_notification_code(code)
-      load_from_response send_request("transactions/notifications/#{code}")
+    def self.find_by_notification_code(code, options = {})
+      load_from_response send_request("transactions/notifications/#{code}", options)
     end
 
     # Search transactions within a date range.
@@ -101,8 +102,8 @@ module PagSeguro
     #
     # # +reference+: the transaction reference code
     #
-    def self.find_by_reference(reference)
-      SearchByReference.new("transactions", { reference: reference })
+    def self.find_by_reference(reference, options = {})
+      SearchByReference.new("transactions", { reference: reference }.merge(options))
     end
 
     # Get abandoned transactions.
@@ -125,25 +126,6 @@ module PagSeguro
       SearchAbandoned.new("transactions/abandoned", options, page)
     end
 
-    # Serialize the HTTP response into data.
-    def self.load_from_response(response) # :nodoc:
-      if response.success? and response.xml?
-        load_from_xml Nokogiri::XML(response.body).css("transaction").first
-      else
-        Response.new Errors.new(response)
-      end
-    end
-
-    # Send a get request to v3 API version, with the path given
-    def self.send_request(path)
-      Request.get(path, api_version)
-    end
-
-    # Serialize the XML object.
-    def self.load_from_xml(xml) # :nodoc:
-      new Serializer.new(xml).serialize
-    end
-
     # Normalize creditor fees object
     def creditor_fees=(creditor_fees)
       @creditor_fees = ensure_type(CreditorFee, creditor_fees)
@@ -197,5 +179,25 @@ module PagSeguro
     def after_initialize
       @errors = Errors.new
     end
+
+    #
+    # Serialize the HTTP response into data.
+    def self.load_from_response(response) # :nodoc:
+      if response.success? and response.xml?
+        load_from_xml Nokogiri::XML(response.body).css("transaction").first
+      else
+        Response.new Errors.new(response)
+      end
+    end
+
+    # Send a get request to v3 API version, with the path given
+    def self.send_request(path, options)
+      Request.get(path, 'v3', options)
+    end
+
+    # Serialize the XML object.
+    def self.load_from_xml(xml) # :nodoc:
+      new Serializer.new(xml).serialize
+    end
   end
 end

data/lib/pagseguro/version.rb

@@ -1,3 +1,3 @@
 module PagSeguro
-  VERSION = "2.2.0"
+  VERSION = "2.3.0"
 end