pagseguro-oficial 2.0.5

data/lib/pagseguro/transaction/serializer.rb

@@ -0,0 +1,115 @@
+module PagSeguro
+  class Transaction
+    class Serializer
+      attr_reader :xml
+
+      def initialize(xml)
+        @xml = xml
+      end
+
+      def serialize
+        {}.tap do |data|
+          serialize_general(data)
+          serialize_amounts(data)
+          serialize_dates(data)
+          serialize_items(data)
+          serialize_sender(data)
+          serialize_shipping(data) if xml.css("shipping").any?
+        end
+      end
+
+      def serialize_general(data)
+        data[:code] = xml.css(">code").text
+        data[:reference] = xml.css("reference").text
+        data[:type_id] = xml.css(">type").text
+        data[:payment_link] = xml.css("paymentLink").text
+        data[:status] = xml.css("status").text
+
+        cancellation_source = xml.css("cancellationSource")
+        data[:cancellation_source] = cancellation_source.text if cancellation_source.any?
+
+        data[:payment_method] = {
+          type_id: xml.css("paymentMethod > type").text,
+          code: xml.css("paymentMethod > code").text
+        }
+      end
+
+      def serialize_dates(data)
+        data[:created_at] = Time.parse(xml.css("date").text)
+
+        updated_at = xml.css("lastEventDate").text
+        data[:updated_at] = Time.parse(updated_at) unless updated_at.empty?
+
+        escrow_end_date = xml.css("escrowEndDate")
+        data[:escrow_end_date] = Time.parse(escrow_end_date.text) if escrow_end_date.any?
+      end
+
+      def serialize_amounts(data)
+        data[:gross_amount] = BigDecimal(xml.css("grossAmount").text)
+        data[:discount_amount] = BigDecimal(xml.css("discountAmount").text)
+        data[:fee_amount] = BigDecimal(xml.css("feeAmount").text)
+        data[:net_amount] = BigDecimal(xml.css("netAmount").text)
+        data[:extra_amount] = BigDecimal(xml.css("extraAmount").text)
+        data[:installments] = xml.css("installmentCount").text.to_i
+      end
+
+      def serialize_items(data)
+        data[:items] = []
+
+        xml.css("items > item").each do |node|
+          item = {}
+          item[:id] = node.css("id").text
+          item[:description] = node.css("description").text
+          item[:quantity] = node.css("quantity").text.to_i
+          item[:amount] = BigDecimal(node.css("amount").text)
+
+          data[:items] << item
+        end
+      end
+
+      def serialize_sender(data)
+        sender = {
+          name: xml.css("sender > name").text,
+          email: xml.css("sender > email").text
+        }
+
+        serialize_phone(sender)
+        data[:sender] = sender
+      end
+
+      def serialize_phone(data)
+        data[:phone] = {
+          area_code: xml.css("sender > phone > areaCode").text,
+          number: xml.css("sender > phone > number").text
+        }
+      end
+
+      def serialize_shipping(data)
+        shipping = {
+          type_id: xml.css("shipping > type").text,
+          cost: BigDecimal(xml.css("shipping > cost").text),
+        }
+
+        serialize_address(shipping)
+        data[:shipping] = shipping
+      end
+
+      def serialize_address(data)
+        data[:address] = {
+          street: address_node.css("> street").text,
+          number: address_node.css("> number").text,
+          complement: address_node.css("> complement").text,
+          district: address_node.css("> district").text,
+          city: address_node.css("> city").text,
+          state: address_node.css("> state").text,
+          country: address_node.css("> country").text,
+          postal_code: address_node.css("> postalCode").text,
+        }
+      end
+
+      def address_node
+        @address_node ||= xml.css("shipping > address")
+      end
+    end
+  end
+end

data/lib/pagseguro/transaction.rb

@@ -0,0 +1,167 @@
+module PagSeguro
+  class Transaction
+    include Extensions::MassAssignment
+    include Extensions::EnsureType
+
+    # When the payment request was created.
+    attr_accessor :created_at
+
+    # The transaction code.
+    attr_accessor :code
+
+    # The reference code identifies the order you placed on the payment request.
+    # It's used by the store and can be something like the order id.
+    attr_accessor :reference
+
+    # The transaction type.
+    attr_accessor :type_id
+
+    # The last notification's update.
+    attr_accessor :updated_at
+
+    # The transaction status.
+    attr_reader :status
+
+    # The payment method.
+    attr_reader :payment_method
+
+    # The boleto payment url.
+    attr_accessor :payment_link
+
+    # The gross amount.
+    attr_accessor :gross_amount
+
+    # The discount amount.
+    attr_accessor :discount_amount
+
+    # The PagSeguro fee amount.
+    attr_accessor :fee_amount
+
+    # The net amount.
+    attr_accessor :net_amount
+
+    # Set the extra amount applied to the transaction's total.
+    # It's considered as an extra charge when positive, or a discount if
+    # negative.
+    attr_accessor :extra_amount
+
+    # The installment count.
+    attr_accessor :installments
+
+    # The payer information (who is sending money).
+    attr_reader :sender
+
+    # The shipping information.
+    attr_reader :shipping
+
+    # The cancellation source.
+    attr_accessor :cancellation_source
+
+    # The escrow end date.
+    attr_accessor :escrow_end_date
+
+    # Set the transaction errors.
+    attr_reader :errors
+    
+    # Find a transaction by its transactionCode
+    # Return a PagSeguro::Transaction instance
+    def self.find_by_code(code)
+      load_from_response Request.get("transactions/#{code}")
+    end
+
+    # Find a transaction by its notificationCode.
+    # Return a PagSeguro::Transaction instance.
+    def self.find_by_notification_code(code)
+      load_from_response Request.get("transactions/notifications/#{code}")
+    end
+
+    # Search transactions within a date range.
+    # Return a PagSeguro::Report instance.
+    #
+    # Options:
+    #
+    # # +starts_at+: the starting date. Defaults to the last 24-hours.
+    # # +ends_at+: the ending date.
+    # # +page+: the current page.
+    # # +per_page+: the result limit.
+    #
+    def self.find_by_date(options = {}, page = 0)
+      options = {
+        starts_at: Time.now - 86400,
+        ends_at: Time.now,
+        per_page: 50
+      }.merge(options)
+
+      Report.new(Transaction, "transactions", options, page)
+    end
+
+    # Get abandoned transactions.
+    # Return a PagSeguro::Report instance.
+    #
+    # Options:
+    #
+    # # +starts_at+: the starting date. Defaults to the last 24-hours.
+    # # +ends_at+: the ending date. Defaults to 15 minutes ago. **Attention:** you have to set it this to <tt>Time.now - 15 minutes</tt>, otherwise the "finalDate must be lower than allowed limit" error will be returned.
+    # # +page+: the current page.
+    # # +per_page+: the result limit.
+    #
+    def self.find_abandoned(options = {}, page = 0)
+      options = {
+        starts_at: Time.now - 86400,
+        ends_at: Time.now - 900,
+        per_page: 50
+      }.merge(options)
+
+      Report.new(Transaction, "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
+
+    # Serialize the XML object.
+    def self.load_from_xml(xml) # :nodoc:
+      new Serializer.new(xml).serialize
+    end
+
+    # Normalize the sender object.
+    def sender=(sender)
+      @sender = ensure_type(Sender, sender)
+    end
+
+    # Normalize the shipping object.
+    def shipping=(shipping)
+      @shipping = ensure_type(Shipping, shipping)
+    end
+
+    # Hold the transaction's items.
+    def items
+      @items ||= Items.new
+    end
+
+    # Normalize the items list.
+    def items=(_items)
+      _items.each {|item| items << item }
+    end
+
+    # Normalize the payment method.
+    def payment_method=(payment_method)
+      @payment_method = ensure_type(PaymentMethod, payment_method)
+    end
+
+    # Normalize the payment status.
+    def status=(status)
+      @status = ensure_type(PaymentStatus, status)
+    end
+
+    private
+    def after_initialize
+      @errors = Errors.new
+    end
+  end
+end

data/lib/pagseguro/version.rb

@@ -0,0 +1,3 @@
+module PagSeguro
+  VERSION = "2.0.5"
+end

data/lib/pagseguro-oficial.rb

@@ -0,0 +1 @@
+require "pagseguro"

data/lib/pagseguro.rb

@@ -0,0 +1,94 @@
+require "bigdecimal"
+require "forwardable"
+require "time"
+
+require "nokogiri"
+require "aitch"
+require "i18n"
+
+require "pagseguro/version"
+require "pagseguro/errors"
+require "pagseguro/exceptions"
+require "pagseguro/extensions/mass_assignment"
+require "pagseguro/extensions/ensure_type"
+require "pagseguro/address"
+require "pagseguro/shipping"
+require "pagseguro/phone"
+require "pagseguro/item"
+require "pagseguro/items"
+require "pagseguro/payment_method"
+require "pagseguro/payment_request"
+require "pagseguro/payment_request/serializer"
+require "pagseguro/payment_request/response"
+require "pagseguro/payment_status"
+require "pagseguro/request"
+require "pagseguro/report"
+require "pagseguro/sender"
+require "pagseguro/notification"
+require "pagseguro/transaction"
+require "pagseguro/transaction/response"
+require "pagseguro/transaction/serializer"
+
+I18n.load_path += Dir[File.expand_path("../../locales/*.yml", __FILE__)]
+
+module PagSeguro
+  class << self
+    # Primary e-mail associated with this account.
+    attr_accessor :email
+
+    # The e-mail that will be displayed when sender is redirected
+    # to PagSeguro.
+    attr_accessor :receiver_email
+
+    # The API token associated with this account.
+    attr_accessor :token
+
+    # The encoding that will be used.
+    attr_accessor :encoding
+
+    # The PagSeguro environment.
+    # Only +production+ for now.
+    attr_accessor :environment
+  end
+
+  self.encoding = "UTF-8"
+  self.environment = :production
+
+  # Register endpoints by environment.
+  def self.uris
+    @uris ||= {
+      production: {
+        api: "https://ws.pagseguro.uol.com.br/v2",
+        site: "https://pagseguro.uol.com.br/v2"
+      }
+    }
+  end
+
+  # Return the root uri based on its type.
+  # Current types are <tt>:api</tt> or <tt>:site</tt>
+  def self.root_uri(type)
+    root = uris.fetch(environment.to_sym) { raise InvalidEnvironmentError }
+    root[type.to_sym]
+  end
+
+  # Set the global configuration.
+  #
+  #   PagSeguro.configure do |config|
+  #     config.email = "john@example.com"
+  #     config.token = "abc"
+  #   end
+  #
+  def self.configure(&block)
+    yield self
+  end
+
+  # The API endpoint.
+  def self.api_url(path)
+    File.join(root_uri(:api), path)
+  end
+
+  # The site url.
+  def self.site_url(path)
+    File.join(root_uri(:site), path)
+  end
+end

data/locales/pt-BR.yml

@@ -0,0 +1,115 @@
+pt-BR:
+  pagseguro:
+    errors:
+      unauthorized: "Não autorizado."
+      "10001": "O parâmetro email deve ser informado."
+      "10002": "O parâmetro token deve ser informado."
+      "10003": "O valor informado no parâmetro email é inválido."
+      "11001": "O parâmetro receiverEmail deve ser informado."
+      "11002": "O tamanho do valor informado no parâmetro receiverEmail é inválido."
+      "11003": "O valor informado no parâmetro receiverEmail é inválido."
+      "11004": "O parâmetro currency deve ser informado."
+      "11005": "O valor informado no parâmetro currency é inválido."
+      "11006": "O tamanho do valor informado no parâmetro redirectURL é inválido."
+      "11007": "O valor informado no parâmetro redirectURL é inválido."
+      "11008": "O tamanho do valor informado no parâmetro reference é inválido."
+      "11009": "O tamanho do valor informado no parâmetro senderEmail é inválido."
+      "11010": "O valor informado no parâmetro senderEmail é inválido."
+      "11011": "O tamanho do valor informado no parâmetro senderName é inválido."
+      "11012": "O valor informado no parâmetro senderName é inválido."
+      "11013": "O valor informado no parâmetro senderAreaCode é inválido."
+      "11014": "O valor informado no parâmetro senderPhone é inválido."
+      "11015": "O parâmetro shippingType deve ser informado."
+      "11016": "O tipo definido no parâmetro shippingType é inválido."
+      "11017": "O valor informado no parâmetro shippingPostalCode é inválido."
+      "11018": "O tamanho do valor informado no parâmetro shippingAddressStreet é inválido."
+      "11019": "O tamanho do valor informado no parâmetro shippingAddressNumber é inválido."
+      "11020": "O tamanho do valor informado no parâmetro shippingAddressComplement é inválido."
+      "11021": "O tamanho do valor informado no parâmetro shippingAddressDistrict é inválido."
+      "11022": "O tamanho do valor informado no parâmetro shippingAddressCity é inválido."
+      "11023": "O formato do valor informado no parâmetro shippingAddressState é inválido."
+      "11024": "O valor informado no parâmetro itemQuantity é inválido."
+      "11025": "O parâmetro itemId deve ser informado."
+      "11026": "O parâmetro itemQuantity deve ser informado."
+      "11027": "O valor informado no parâmetro itemQuantity é inválido."
+      "11028": "O parâmetro itemAmount deve ser informado."
+      "11029": "O formato do valor informado no parâmetro itemAmount é inválido."
+      "11030": "O valor informado no parâmetro itemAmount é inválido."
+      "11031": "O formato do valor informado no parâmetro itemShippingCost é inválido."
+      "11032": "O valor informado no parâmetro itemShippingCost é inválido."
+      "11033": "O parâmetro itemDescription deve ser informado."
+      "11034": "O tamanho do valor informado no parâmetro itemDescription é inválido."
+      "11035": "O valor informado no parâmetro itemWeight é inválido."
+      "11036": "O formato do valor informado no parâmetro extraAmount é inválido."
+      "11037": "O valor informado no parâmetro extraAmount é inválido."
+      "11038": "Valor não autorizado para receiverEmail."
+      "11039": "A estrutura do xml está incorreta."
+      "11040": "O formato do valor informado no parâmetro maxAge é inválido."
+      "11041": "O valor informado no parâmetro maxAge é inválido."
+      "11042": "O formato do valor informado no parâmetro maxUses é inválido."
+      "11043": "O valor informado no parâmetro maxUses é inválido."
+      "11044": "O parâmetro initialDate deve ser informado."
+      "11045": "O valor informado no parâmetro initialDate deve ser inferior ou igual a data atual."
+      "11046": "O valor informado no parâmetro initialDate não pode ser anterior a 180 dias contados da data atual."
+      "11047": "O valor informado no parâmetro initialDate deve ser menor ou igual ao valor informado no parâmetro finalDate."
+      "11048": "O intervalo entre os parâmetros initialDate e finalDate deve ser inferior ou igual a 30 dias."
+      "11049": "O valor informado no parâmetro finalDate deve ser inferior ou igual a data atual."
+      "11050": "O valor informado no parâmetro initialDate é inválido. O formato correto é yyyy-MM-ddTHH:mm."
+      "11051": "O valor informado no parâmetro finalDate é inválido. O formato correto é yyyy-MM-ddTHH:mm."
+      "11052": "O valor informado no parâmetro page é inválido. Utilize um inteiro maior que 0."
+      "11053": "O valor informado no parâmetro maxPageResults deve ser entre 1 e 1000."
+      "11105": "O valor total do checkout é inválido."
+      "11111": "O valor informado no parâmetro shippingCost é inválido."
+      "11112": "O formato do valor informado no parâmetro shippingCost é inválido."
+      "11164": "O valor informado no parâmetro senderCPF é inválido."
+      "13001": "O código de notificação informado é inválido."
+      "13002": "O código da transação deve ser informado."
+      "13003": "O código de transação informado é inválido."
+      "13004": "O parâmetro initialDate deve ser informado"
+      "13005": "O valor informado no parâmetro initialDate deve ser inferior ou igual a data atual."
+      "13006": "O valor informado no parâmetro initialDate não pode ser anterior a 180 dias contados da data atual."
+      "13007": "O valor informado no parâmetro initialDate deve ser menor ou igual ao valor informado no parâmetro finalDate."
+      "13008": "O intervalo entre os parâmetros initialDate e finalDate deve ser inferior ou igual a 30 dias."
+      "13009": "O valor informado no parâmetro finalDate deve ser inferior ou igual a data atual."
+      "13010": "O valor informado no parâmetro initialDate é inválido. O formato correto é yyyy-MM-ddTHH:mm."
+      "13011": "O valor informado no parâmetro finalDate é inválido. O formato correto é yyyy-MM-ddTHH:mm."
+      "13012": "O valor informado no parâmetro initialDate deve ser inferior a."
+      "13013": "O valor informado no parâmetro page é inválido. Utilize um inteiro maior que 0."
+      "13014": "O valor informado no parâmetro maxPageResults deve ser entre 1 e 1000."
+      "13015": "Transação não encontrada."
+      "13020": "O valor informado no parâmetro page é superior a quantidade de páginas retornadas."
+      "13021": "Esta consulta não pode ser realizada pois o status da transação requisitada é inválido."
+
+    payment_methods:
+      "101": "Cartão de crédito Visa"
+      "102": "Cartão de crédito MasterCard"
+      "103": "Cartão de crédito American Express"
+      "104": "Cartão de crédito Diners"
+      "105": "Cartão de crédito Hipercard"
+      "106": "Cartão de crédito Aura"
+      "107": "Cartão de crédito Elo"
+      "108": "Cartão de crédito PLENOCard"
+      "109": "Cartão de crédito PersonalCard"
+      "110": "Cartão de crédito JCB"
+      "111": "Cartão de crédito Discover"
+      "112": "Cartão de crédito BrasilCard"
+      "113": "Cartão de crédito FORTBRASIL"
+      "114": "Cartão de crédito CARDBAN"
+      "115": "Cartão de crédito VALECARD"
+      "116": "Cartão de crédito Cabal"
+      "117": "Cartão de crédito Mais!"
+      "118": "Cartão de crédito Avista"
+      "119": "Cartão de crédito GRANDCARD"
+      "120": "Cartão de crédito SOROCRED"
+      "201": "Boleto Bradesco"
+      "202": "Boleto Santander"
+      "301": "Débito online Bradesco"
+      "302": "Débito online Itaú"
+      "303": "Débito online Unibanco"
+      "304": "Débito online Banco do Brasil"
+      "305": "Débito online Banco Real"
+      "306": "Débito online Banrisul"
+      "307": "Débito online HSBC"
+      "401": "Saldo PagSeguro"
+      "501": "Oi Paggo"
+      "701": "Depósito em conta Banco do Brasil"