pagseguro-sdk 2.6.2

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/person.rb

@@ -0,0 +1,40 @@
+module PagSeguro
+  class Person
+    include Extensions::MassAssignment
+    include Extensions::EnsureType
+
+    # Set the account name.
+    attr_accessor :name
+
+    # Set the account birth_date.
+    # Pattern: aaaa-MM-dd
+    attr_accessor :birth_date
+
+    # Set the account address.
+    attr_reader :address
+
+    def address=(address)
+      @address = ensure_type(Address, address)
+    end
+
+    def documents
+      @documents ||= Documents.new
+    end
+
+    def documents=(_documents=[])
+      _documents.each do |document|
+        documents << ensure_type(Document, document)
+      end
+    end
+
+    def phones
+      @phones ||= Phones.new
+    end
+
+    def phones=(_phones=[])
+      _phones.each do |phone|
+        phones << ensure_type(Phone, phone)
+      end
+    end
+  end
+end

data/lib/pagseguro/phone.rb

@@ -0,0 +1,20 @@
+module PagSeguro
+  class Phone
+    include Extensions::MassAssignment
+
+    # Set the type phone
+    # Must be HOME, MOBILE or BUSINESS
+    attr_accessor :type
+
+    # Set the area code.
+    attr_accessor :area_code
+
+    # Set the phone number.
+    # Must have 7-9 numbers.
+    attr_accessor :number
+
+    def ==(other)
+      [type, area_code, number] == [other.type, other.area_code, other.number]
+    end
+  end
+end

data/lib/pagseguro/phones.rb

@@ -0,0 +1,5 @@
+module PagSeguro
+  class Phones
+    include Extensions::CollectionObject
+  end
+end

data/lib/pagseguro/receiver.rb

@@ -0,0 +1,20 @@
+module PagSeguro
+  class Receiver
+    include Extensions::MassAssignment
+    include Extensions::EnsureType
+
+    # Set receiver's email.
+    attr_accessor :email
+
+    # Set receiver's public_key.
+    attr_accessor :public_key
+
+    # Get receiver split.
+    attr_reader :split
+
+    # Set receiver split.
+    def split=(split)
+      @split = ensure_type(ReceiverSplit, split)
+    end
+  end
+end

data/lib/pagseguro/receiver_split.rb

@@ -0,0 +1,15 @@
+module PagSeguro
+  class ReceiverSplit
+    include Extensions::MassAssignment
+    include Extensions::EnsureType
+
+    # Set amount.
+    attr_accessor :amount
+
+    # Set rate percent.
+    attr_accessor :rate_percent
+
+    # Set fee percent.
+    attr_accessor :fee_percent
+  end
+end

data/lib/pagseguro/request.rb

@@ -0,0 +1,170 @@
+module PagSeguro
+  module Request
+    extend self
+    extend Forwardable
+
+    # Delegates the <tt>:config</tt> and <tt>:configure</tt> methods
+    # to the <tt>:request</tt> method, which returns a Aitch::Namespace instance.
+    def_delegators :request, :config, :configure
+
+    # Perform a GET request.
+    #
+    # # +path+: the path that will be requested. Must be something like <tt>"transactions/code/739D69-79C052C05280-55542D9FBB33-CAB2B1"</tt>.
+    # # +api_version+: the current PagSeguro API version of the requested service
+    # # +data+: the data that will be sent as query string. Must be a Hash.
+    # # +headers+: any additional header that will be sent through the request.
+    #
+    def get(path, api_version, data = {}, headers = {})
+      execute :get, path, api_version, data, headers
+    end
+
+    def get_with_auth_on_url(path, api_version, credentials)
+      request.public_send(
+        :get,
+        PagSeguro.api_url("#{api_version}/#{path}?#{credentials_to_params(credentials)}")
+      )
+    end
+
+    def get_without_api_version(path, data={}, headers={})
+      request.get(path, extended_data(data), headers)
+    end
+
+    # Perform a POST request.
+    #
+    # # +path+: the path that will be requested. Must be something like <tt>"checkout"</tt>.
+    # # +api_version+: the current PagSeguro API version of the requested service
+    # # +data+: the data that will be sent as body data. Must be a Hash.
+    # # +headers+: any additional header that will be sent through the request.
+    #
+    def post(path, api_version, data = {}, headers = {})
+      execute :post, path, api_version, data, headers
+    end
+
+    # Perform a POST request, sending XML data.
+    #
+    # # +path+: the path that will be requested. Must be something like <tt>"checkout"</tt>.
+    # # +api_version+: the current PagSeguro API version of the requested service
+    # # +credentials+: the credentials like ApplicationCredentials or AccountCredentials.
+    # # +data+: the data that will be sent as body data. Must be a XML.
+    #
+    def post_xml(path, api_version, credentials, data = '', options={})
+      credentials_params = credentials_to_params(credentials)
+      url_path = [api_version, path].reject(&:nil?).join('/')
+
+      request.post do
+        url PagSeguro.api_url("#{url_path}?#{credentials_params}")
+        headers "Content-Type" => "application/xml; charset=#{PagSeguro.encoding}"
+        headers.merge!(options[:headers]) if options[:headers]
+        body data
+      end
+    end
+
+    # Perform a PUT request, sending XML data.
+    #
+    # # +path+: the path that will be requested. Must be something like <tt>"checkout"</tt>.
+    # # +credentials+: the credentials like ApplicationCredentials or AccountCredentials.
+    # # +data+: the data that will be sent as body data. Must be a XML.
+    #
+    def put_xml(path, credentials, data)
+      full_url = PagSeguro.api_url("#{path}?#{credentials_to_params(credentials)}")
+
+      request.put do
+        url full_url
+        headers "Content-Type" => "application/xml; charset=#{PagSeguro.encoding}",
+                "Accept" => "application/vnd.pagseguro.com.br.v1+xml;charset=ISO-8859-1"
+        body data
+      end
+    end
+
+    # Perform the specified HTTP request. It will include the API credentials,
+    # api_version, encoding and additional headers.
+    def execute(request_method, path, api_version, data, headers) # :nodoc:
+      request.public_send(
+        request_method,
+        PagSeguro.api_url("#{api_version}/#{path}"),
+        extended_data(data),
+        extended_headers(request_method, headers)
+      )
+    end
+
+    private
+    def request
+      @request ||= Aitch::Namespace.new
+      @request.configure do |config|
+        config.timeout = 50 
+      end
+      @request
+    end
+
+    def extended_data(data)
+      if data[:credentials]
+        data.merge!(credentials_object(data))
+      else
+        data.merge!(global_credentials(data))
+      end
+      data.merge!({ charset: PagSeguro.encoding })
+      data.delete_if { |_, value| value.nil? }
+    end
+
+    def extended_headers(request_method, headers)
+      headers.merge __send__("headers_for_#{request_method}")
+    end
+
+    def headers_for_post
+      {
+        "Accept-Charset" => PagSeguro.encoding,
+        "Content-Type" => "application/x-www-form-urlencoded; charset=#{PagSeguro.encoding}"
+      }
+    end
+
+    def headers_for_get
+      {
+        "Accept-Charset" => PagSeguro.encoding
+      }
+    end
+
+    def credentials_to_params(credentials)
+      credentials_object(credentials: credentials)
+        .delete_if { |_, value| value.nil? }
+        .map { |key, value| "#{key}=#{value}" }
+        .join('&')
+    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|
+    config.default_headers = {
+      "lib-description"             => "ruby:#{PagSeguro::VERSION}",
+      "language-engine-description" => "ruby:#{RUBY_VERSION}"
+    }
+  end
+end

data/lib/pagseguro/sender.rb

@@ -0,0 +1,53 @@
+module PagSeguro
+  class Sender
+    include Extensions::MassAssignment
+    include Extensions::EnsureType
+
+    # Get the sender phone.
+    attr_reader :phone
+
+    # Get the sender document
+    attr_reader :document
+
+    # Get the sender address
+    attr_reader :address
+
+    # Set the sender name.
+    attr_accessor :name
+
+    # Set the sender e-mail.
+    attr_accessor :email
+
+    # Set the sender ip
+    attr_accessor :ip
+
+    # Set sender hash.
+    # It's used to identify the sender.
+    attr_accessor :hash
+
+    # Set the sender phone.
+    def phone=(phone)
+      @phone = ensure_type(Phone, phone)
+    end
+
+    def documents
+      @documents ||= Documents.new
+    end
+
+    def documents=(_documents=[])
+      _documents.each do |document|
+        documents << document
+      end
+    end
+
+    # Set the sender document.
+    def document=(document)
+      documents << ensure_type(Document, document)
+    end
+
+    # Set the sender address.
+    def address=(address)
+      @address = ensure_type(Address, address)
+    end
+  end
+end

data/lib/pagseguro/session.rb

@@ -0,0 +1,34 @@
+module PagSeguro
+  class Session
+    include Extensions::MassAssignment
+
+    # The session id.
+    attr_accessor :id
+
+    # The PageSeguro::Errors object.
+    attr_writer :errors
+
+    def errors
+      @errors ||= Errors.new
+    end
+
+    # Create a payment session.
+    # Return a PagSeguro::Session instance.
+    def self.create
+      response = Request.post("sessions", api_version)
+      session = Session.new
+      response = Response.new(response, session).serialize
+
+      session
+    end
+
+    def update_attributes(attrs)
+      attrs.map { |name, value| send("#{name}=", value) }
+    end
+
+    private
+    def self.api_version
+      'v2'
+    end
+  end
+end

data/lib/pagseguro/session/response.rb

@@ -0,0 +1,32 @@
+module PagSeguro
+  class Session
+    class Response
+      def initialize(response, session)
+        @response = response
+        @session = session
+      end
+
+      def serialize
+        if success?
+          xml = Nokogiri::XML(response.body).css("session").first
+          session.update_attributes(ResponseSerializer.new(xml).serialize)
+        else
+          session.errors.add(response)
+        end
+
+        session
+      end
+
+      def success?
+        response.success? && response.xml?
+      end
+
+      private
+      # The request response.
+      attr_reader :response
+
+      # The Session instance.
+      attr_reader :session
+    end
+  end
+end

data/lib/pagseguro/session/response_serializer.rb

@@ -0,0 +1,18 @@
+module PagSeguro
+  class Session
+    class ResponseSerializer
+      # The session that will be serialized
+      attr_reader :xml
+
+      def initialize(xml)
+        @xml = xml
+      end
+
+      def serialize
+        {}.tap do |data|
+          data[:id] = xml.css("id").text
+        end
+      end
+    end
+  end
+end

data/lib/pagseguro/shipping.rb

@@ -0,0 +1,57 @@
+module PagSeguro
+  class Shipping
+    # Set the available shipping type.
+    TYPE = {
+      pac: 1,
+      sedex: 2,
+      not_specified: 3
+    }
+
+    # Define the error class for invalid type assignment.
+    InvalidShippingTypeError = Class.new(StandardError)
+
+    include Extensions::MassAssignment
+    include Extensions::EnsureType
+
+    # Define the shipping type id.
+    attr_reader :type_id
+
+    # Get the shipping type name.
+    attr_reader :type_name
+
+    # Get the address object.
+    attr_reader :address
+
+    # Set the shipping cost.
+    attr_accessor :cost
+
+    # Set the shipping address info.
+    def address=(address)
+      @address = ensure_type(Address, address)
+    end
+
+    # Set the shipping type.
+    # It raises the PagSeguro::Shipping::InvalidShippingTypeError exception
+    # when trying to assign an invalid type name.
+    def type_name=(type_name)
+      type_name = type_name.to_sym
+      @type_id = TYPE.fetch(type_name) {
+        raise InvalidShippingTypeError, "invalid #{type_name.inspect} type name"
+      }
+      @type_name = type_name
+    end
+
+    # Set the shipping type id.
+    # It raises the PagSeguro::Shipping::InvalidShippingTypeError exception
+    # when trying to assign an invalid type id.
+    def type_id=(id)
+      type_id = id.to_i
+
+      raise InvalidShippingTypeError,
+        "invalid #{id.inspect} type id" unless TYPE.value?(type_id)
+
+      @type_id = type_id
+      @type_name = TYPE.key(type_id)
+    end
+  end
+end