pagseguro-oficial 2.1.1 → 2.2.0

data/lib/pagseguro/holder.rb

@@ -0,0 +1,28 @@
+module PagSeguro
+  class Holder
+    include Extensions::MassAssignment
+    include Extensions::EnsureType
+
+    # Set the name.
+    attr_accessor :name
+
+    # Set the birth date.
+    attr_accessor :birth_date
+
+    # Get document info.
+    attr_reader :document
+
+    # Get the phone.
+    attr_reader :phone
+
+    # Set the document.
+    def document=(document)
+      @document = ensure_type(Document, document)
+    end
+
+    # Set the phone.
+    def phone=(phone)
+      @phone = ensure_type(Phone, phone)
+    end
+  end
+end

data/lib/pagseguro/installment.rb

@@ -20,27 +20,22 @@ module PagSeguro
 
     # Find installment options by a given amount
     # Optional. Credit card brand
-    # Return an Array of PagSeguro::Installment instances
+    # Return a PagSeguro::Installment::Collection instance
     def self.find(amount, card_brand = nil)
-      string = "installments?amount=#{amount}"
-      string += "&cardBrand=#{card_brand}" if card_brand
-      load_from_response Request.get(string, 'v2')
+      request = Request.get("installments", api_version, params(amount: amount, card_brand: card_brand))
+      collection = Collection.new
+      Response.new(request, collection).serialize
+
+      collection
     end
 
-    # Serialize the HTTP response into data.
-    def self.load_from_response(response) # :nodoc:
-      if response.success? and response.xml?
-        Nokogiri::XML(response.body).css("installments > installment").map do |node|
-          load_from_xml(node)
-        end
-      else
-        Response.new Errors.new(response)
-      end
+    private
+    def self.params(options)
+      RequestSerializer.new(options).to_params
     end
 
-    # Serialize the XML object.
-    def self.load_from_xml(xml) # :nodoc:
-      new Serializer.new(xml).serialize
+    def self.api_version
+      'v2'
     end
   end
 end

data/lib/pagseguro/installment/collection.rb

@@ -0,0 +1,25 @@
+module PagSeguro
+  class Installment
+    class Collection
+      extend Forwardable
+
+      def_delegators :@installments, :each, :empty?, :any?
+
+      def installments=(objects)
+        @installments = instantiate_installments(objects)
+      end
+
+      def errors
+        @errors ||= Errors.new
+      end
+
+      private
+      def instantiate_installments(installments)
+        return [] unless installments
+        installments.map do |installment|
+          Installment.new(installment)
+        end
+      end
+    end
+  end
+end

data/lib/pagseguro/installment/request_serializer.rb

@@ -0,0 +1,24 @@
+module PagSeguro
+  class Installment
+    class RequestSerializer
+      # The data that will be serialized.
+      attr_reader :data
+
+      def initialize(data)
+        @data = data
+      end
+
+      def to_params
+        params[:amount] = data[:amount]
+        params[:cardBrand] = data[:card_brand] if data[:card_brand]
+
+        params
+      end
+
+      private
+      def params
+        @params ||= {}
+      end
+    end
+  end
+end

data/lib/pagseguro/installment/response.rb

@@ -1,11 +1,36 @@
 module PagSeguro
   class Installment
     class Response
-      # Set the response errors.
-      attr_reader :errors
+      def initialize(response, collection)
+        @response = response
+        @collection = collection
+      end
+
+      def serialize
+        if success?
+          collection.installments = serialize_installments
+        else
+          collection.errors.add(response)
+        end
+
+        collection
+      end
+
+      def success?
+        response.success? && response.xml?
+      end
+
+      private
+      # The request response.
+      attr_reader :response
+
+      # The PagSeguro::Installment::Collection instance.
+      attr_reader :collection
 
-      def initialize(errors = Errors.new)
-        @errors = errors
+      def serialize_installments
+        Nokogiri::XML(response.body).css("installments > installment").map do |node|
+          ResponseSerializer.new(node).serialize
+        end
       end
     end
   end

data/lib/pagseguro/installment/{serializer.rb → response_serializer.rb}

@@ -1,6 +1,6 @@
 module PagSeguro
   class Installment
-    class Serializer
+    class ResponseSerializer
       # The installment that will be serialized
       attr_reader :xml
 

data/lib/pagseguro/items.rb

@@ -10,6 +10,7 @@ module PagSeguro
       @store = []
     end
 
+    # Adds a new item to item list.
     def <<(item)
       item = ensure_type(Item, item)
 
@@ -20,6 +21,8 @@ module PagSeguro
       end
     end
 
+    # Verify if the item is already included to item list.
+    # Returns boolean.
     def include?(item)
       @store.find {|stored_item| stored_item.id == ensure_type(Item, item).id }
     end

data/lib/pagseguro/online_debit_transaction_request.rb

@@ -0,0 +1,17 @@
+module PagSeguro
+  class OnlineDebitTransactionRequest < TransactionRequest
+    # Get the bank info.
+    attr_reader :bank
+
+    # Get the payment_method.
+    def payment_method
+      "online_debit"
+    end
+
+    # Set the bank.
+    # Required for online debit payment method.
+    def bank=(bank)
+      @bank = ensure_type(Bank, bank)
+    end
+  end
+end

data/lib/pagseguro/payment_method.rb

@@ -4,6 +4,7 @@ module PagSeguro
     include Extensions::MassAssignment
 
     TYPES = {
+      ""  => :not_set,
       "1" => :credit_card,
       "2" => :boleto,
       "3" => :online_transfer,

data/lib/pagseguro/payment_releases.rb

@@ -10,12 +10,15 @@ module PagSeguro
       @payments = []
     end
 
+    # Adds payment to payment list.
     def <<(payment)
       payment = ensure_type(PaymentRelease, payment)
 
       @payments << payment unless @payments.include? payment
     end
 
+    # Verify if a payment is already included to payment list.
+    # Returns Boolean.
     def include?(payment)
       self.find do |included_payment|
         included_payment.installment == ensure_type(PaymentRelease, payment).installment

data/lib/pagseguro/sender.rb

@@ -18,6 +18,10 @@ module PagSeguro
     # Set the CPF document.
     attr_accessor :cpf
 
+    # 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)

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

@@ -102,8 +102,7 @@ module PagSeguro
     # # +reference+: the transaction reference code
     #
     def self.find_by_reference(reference)
-      options = { reference: reference }
-      SearchByReference.new("transactions", options)
+      SearchByReference.new("transactions", { reference: reference })
     end
 
     # Get abandoned transactions.
@@ -137,7 +136,7 @@ module PagSeguro
 
     # Send a get request to v3 API version, with the path given
     def self.send_request(path)
-      Request.get(path, 'v3')
+      Request.get(path, api_version)
     end
 
     # Serialize the XML object.
@@ -191,6 +190,10 @@ module PagSeguro
     end
 
     private
+    def self.api_version
+      'v3'
+    end
+
     def after_initialize
       @errors = Errors.new
     end

data/lib/pagseguro/transaction/response.rb

@@ -1,7 +1,7 @@
 module PagSeguro
   class Transaction
     class Response
-      # Set the response errors.
+      # The response errors.
       attr_reader :errors
 
       def initialize(errors = Errors.new)

data/lib/pagseguro/transaction_installment.rb

@@ -0,0 +1,11 @@
+module PagSeguro
+  class TransactionInstallment
+    include Extensions::MassAssignment
+
+    # Set the installments value.
+    attr_accessor :value
+
+    # Set the installments quantity.
+    attr_accessor :quantity
+  end
+end

data/lib/pagseguro/transaction_request.rb

@@ -0,0 +1,143 @@
+module PagSeguro
+  class TransactionRequest
+    include Extensions::MassAssignment
+    include Extensions::EnsureType
+
+    # Set the payment currency.
+    # Defaults to BRL.
+    attr_accessor :currency
+
+    # Get the payment sender.
+    attr_reader :sender
+
+    # Get the shipping info.
+    attr_reader :shipping
+
+    # Set the extra amount to be applied to the transaction's total.
+    # This value can be used to add an extra charge to the transaction
+    # or provide a discount, if negative.
+    attr_accessor :extra_amount
+
+    # Set the reference code.
+    # Optional. You can use the reference code to store an identifier so you can
+    # associate the PagSeguro transaction to a transaction in your system.
+    # Tipically this is the order id.
+    attr_accessor :reference
+
+    # Determines for which url PagSeguro will send the order related
+    # notifications codes.
+    # Optional. Any change happens in the transaction status, a new notification
+    # request will be send to this url. You can use that for update the related
+    # order.
+    attr_accessor :notification_url
+
+    # Set the payment mode.
+    attr_accessor :payment_mode
+
+    # The extra parameters for payment request.
+    attr_accessor :extra_params
+
+    # The transaction code returned from api.
+    attr_reader :code
+
+    # The transaction type returned from api.
+    attr_reader :type_id
+
+    # The payment link returned from api.
+    attr_reader :payment_link
+
+    # The transaction status returned from api.
+    attr_reader :status
+
+    # The payment method returned from api.
+    attr_reader :payment_method
+
+    # The gross amount returned from api.
+    attr_reader :gross_amount
+
+    # The discount amount returned from api.
+    attr_reader :discount_amount
+
+    # The net amount returned from api.
+    attr_reader :net_amount
+
+    # The installments number returned from api.
+    attr_reader :installment_count
+
+    # The created at date returned from api
+    attr_reader :created_at
+
+    # The updated at date returned from api
+    attr_reader :updated_at
+
+    attr_writer :errors
+
+    # Products/items in this payment request.
+    def items
+      @items ||= Items.new
+    end
+
+    def errors
+      @errors ||= Errors.new
+    end
+
+    # Subclasses must implement payment_method
+    def payment_method
+      raise NotImplementedError.new("'#payment_method' must be implemented in specific class")
+    end
+
+    # Set the payment sender.
+    def sender=(sender)
+      @sender = ensure_type(Sender, sender)
+    end
+
+    # Set the shipping info.
+    def shipping=(shipping)
+      @shipping = ensure_type(Shipping, shipping)
+    end
+
+    # Calls the PagSeguro web service and create this request for payment.
+    # Return boolean.
+    def create
+      request = Request.post("transactions", api_version, params)
+      response = Response.new(request, self)
+      response.serialize
+
+      response.success?
+    end
+
+    def update_attributes(attrs)
+      attrs.map { |name, value| send("#{name}=", value) }
+    end
+
+    private
+    attr_writer :code, :type_id, :payment_link, :status, :payment_method,
+      :gross_amount, :discount_amount, :net_amount, :installment_count,
+      :created_at, :updated_at
+
+    def before_initialize
+      self.currency = "BRL"
+      self.extra_params = []
+    end
+
+    def params
+      RequestSerializer.new(self).to_params
+    end
+
+    # Used to set response items from api.
+    def items=(items)
+      @items = Items.new
+      items.map { |item| @items << item }
+    end
+
+    # Used to set the payment method from api.
+    def payment_method=(payment_method)
+      @payment_method = ensure_type(PaymentMethod, payment_method)
+    end
+
+    private
+    def api_version
+      'v2'
+    end
+  end
+end