pag_seguro 0.4.1 → 0.5.1

data/.gitignore

@@ -6,3 +6,4 @@ coverage/*
 doc/*
 spec/pag_seguro/integration/config_example.yml
 .DS_Store
+.sublime-project

data/Gemfile

@@ -3,8 +3,11 @@ source "http://rubygems.org"
 # Specify your gem's dependencies in PagSeguro.gemspec
 gemspec
 
-# test gems
+# test or development gems
 gem 'rspec'
 gem 'simplecov', require: false
 gem 'guard-rspec'
-gem 'growl'
+gem 'shoulda-matchers'
+gem "factory_girl", "~> 4.0"
+gem 'growl'
+gem 'pry'

data/README.md

@@ -73,7 +73,9 @@ Com exceção do atributo response (que é utilizado para armazenar a resposta e
 
 ### API de Notificação
 
-As notificações de alteração no status da compra no PagSeguro serão enviadas para a URL que tiver configurado na [Notificação de transações](https://pagseguro.uol.com.br/v2/guia-de-integracao/consulta-de-transacoes-por-codigo.html). Obs.: Até o momento o PagSeguro não permite configurar uma url dinâmica para envio das notificação ( e apenas permite uma url por conta ), então provavelemente será necessário que crie uma conta diferente no PagSeguro para cada sistema que desenvolver.
+As notificações de alteração no status da compra no PagSeguro serão enviadas para a URL que tiver configurado na [Notificação de transações](https://pagseguro.uol.com.br/v2/guia-de-integracao/consulta-de-transacoes-por-codigo.html). Se quiser configurar uma url dinâmica para envio das notificação é necessário ativar a página de redirecionamento dinâmico em [Integrações > Página de redirecionamento](https://pagseguro.uol.com.br/integracao/pagina-de-redirecionamento.jhtml), e passar o argumento `redirect_url` para o objeto PagSeguro::Payment:
+
+    PagSeguro::Payment.new(email, token, id: invoice.id, redirect_url: "http://lojamodelo.com.br/checkout")
 
 O código da notificação é enviado pelo PagSeguro através do parâmentro `notificationCode` em uma requisição do tipo POST. Segue um exemplo de uso da notificação em uma aplicação rails (este exemplo supõe a existência de um `resources :notifications` em suas rotas, e um modelo `Invoice` responsável pelos pagamentos):
 
@@ -108,15 +110,28 @@ Para este exemplo, o url configurada na [Notificação de transações](https://
 
 ### Consulta de Transações
 
-Para realizar a consulta de uma transação é preciso obter o código da transação. Este código é enviado nas Notificações de Transações do PagSeguro (de forma assíncrona), através do método `notification.transaction_id` ou de forma síncrona assim que o usuário retorna à loja após ter concluído a compra.
+Há duas maneiras de se realizar a consulta das transações, a primeira delas buscando o código de uma transação, e outra buscando por todas as transações em um determinado período
 
-Para buscar informações da transação de forma síncrona, é necessário que acesse sua conta no PagSeguro, e clique em [Integrações > Página de redirecionamento](https://pagseguro.uol.com.br/integracao/pagina-de-redirecionamento.jhtml) e ative o redirecionamento com o código da transação, definindo o nome do parâmetro que será enviado para sua aplicação (e.g.: http://lojamodelo.com.br/checkout?transaction_id=E884542-81B3-4419-9A75-BCC6FB495EF1 ). O redirecionamento para esta página é executado através de uma requisição GET.
+#### Consulta de Transações por Período
 
-Caso queira utilizar uma URL dinâmica de retorno, é necessário ativar a página de redirecionamento dinâmico em [Integrações > Página de redirecionamento](https://pagseguro.uol.com.br/integracao/pagina-de-redirecionamento.jhtml), e passar o argumento `redirect_url` para o objeto PagSeguro::Payment:
+Você pode consultar as transações por uma data através do método `PagSeguro::Query::find`, informando seu email, token, e algumas opções adicionais:
 
-    PagSeguro::Payment.new(email, token, id: invoice.id, redirect_url: "http://lojamodelo.com.br/checkout")
+    transactions = PagSeguro::Query.find(email, token, initial_date: 30.days.ago, final_date: Time.now)
+
+    transactions.each do |transaction|
+      puts "id: #{transaction.id}, transaction_id: #{transaction.transaction_id}"
+      ...
+    end
+
+Além das opções acima, você pode enviar também as opções `:page` (que pelo padrão é a primeira) e `:max_page_results` (que por padrão é 50). Obviamente a data final precisa ser maior que a inicial, não podem haver mais de 30 dias de diferença entre as duas, e a data inicial precisa estar dentro dos últimos 6 meses.
+
+#### Consulta de Transação por código
 
-Você pode consultar as informações da transação através do `PagSeguro::Query`, que possui os mesmos attributos e métodos que `PagSeguro::Notification` para consulta da transação:
+O código das transações são enviadas nas Notificações de Transações do PagSeguro (de forma assíncrona), e podem ser obtidas através do método `notification.transaction_id`, e também podem ser obtidas de forma síncrona assim que o usuário retorna à loja após ter concluído a compra. Este código também pode ser encontrado através da busca de transações por período.
+
+Para buscar informações da transação de forma síncrona, é necessário que acesse sua conta no PagSeguro, e clique em [Integrações > Página de redirecionamento](https://pagseguro.uol.com.br/integracao/pagina-de-redirecionamento.jhtml) e ative o redirecionamento com o código da transação, definindo o nome do parâmetro que será enviado para sua aplicação (e.g.: http://lojamodelo.com.br/checkout?transaction_id=E884542-81B3-4419-9A75-BCC6FB495EF1 ). O redirecionamento para esta página é executado através de uma requisição GET.
+
+Você pode consultar as informações da transação instanciando a classe `PagSeguro::Query`, que possui os mesmos attributos e métodos que uma notificação:
 
     query = PagSeguro::Query.new(email, token, "E884542-81B3-4419-9A75-BCC6FB495EF1")
 
@@ -124,6 +139,54 @@ Você pode consultar as informações da transação através do `PagSeguro::Que
       # ...
     end
 
+### Pagamento Recorrente
+
+**Primeiro de tudo vale ressaltar que a API de pagamento recorrente não está documentada oficialmente pelo pagseguro, apesar de ter sido lançada em dezembro de 2012. Esta funcionalidade foi criada com base em um post em um [blog](http://sounoob.com.br/requisicao-de-pagamento-do-pagseguro-com-assinatura-associada-usando-php/) e em tentativa e erro. Use por sua conta e risco.**
+
+É possível enviar a requisição de uma pagamento recorrente juntamente com o pedido de compra (e por enquanto não é possível enviar um pedido de assinatura sem enviar adicionar nenhum ítem ao pagamento). Para usá-la, basta adicionar um `pre_approval` a um pagamento:
+    
+    # suponho que uma variavel payment (do tipo PagSeguro::Payment) já foi instanciada, e que o payment.items não está vazio
+    payment.pre_approval = PagSeguro::PreApproval.new
+
+    # obrigatório. Recebe uma string (de até 100 caracteres) e representa o nome da sua assinatura
+    payment.pre_approval.name = "nome da minha assinatura"
+
+    # obrigatório. Recebe uma data e representa a data em que sua assinatura termina. Não pode ser maior do que a data de início (ou hoje) em mais de 744 dias (pouco menos de 3 anos)
+    payment.pre_approval.pre_approval.final_date = Date.new(2014, 6, 12)
+
+    # obrigatório. Valor máximo da assinatura por período/cobrança. Recebe uma string (formatada como "%.2f"), um float ou um BigDecimal
+    payment.pre_approval.max_amount_per_period = '200.00'
+
+    # obrigatório. Valor máximo total da assinatura. Recebe uma string (formatada como "%.2f"), um float ou um BigDecimal
+    payment.pre_approval.max_total_amount = '1000.00'
+
+    # obrigatório. Representa a periodicidade da cobraça. Recebe uma string ou símbolo e pode ser: weekly, monthly, bimonthly, trimonthly, semiannually, ou yearly
+    payment.pre_approval.period = :monthly
+
+    # obrigatório no caso de pagamentos de periodicidade monthly, bimonthly ou trimonthly. Recebe um número (dia do mês) de 1 à 28
+    payment.pre_approval.day_of_month = 10
+
+    # obrigatório no caso de pagamentos de periodicidade weekly. Recebe uma string ou símbolo representando o dia na semana, e pode ser monday, tuesday, wednesday, thursday, friday, saturday ou sunday
+    payment.pre_approval.day_of_week = :friday
+
+    # obrigatório no caso de pagamentos de periodicidade yearly. Recebe uma string representando o dia do mês e o mês do ano no formato 'MM-dd'. Para facilitar use a classe DayOfYear que gera a string no formato correto.
+    payment.pre_approval.day_of_year = PagSeguro::DayOfYear.new(day: 10, month: 4)
+
+    # estranhamente é opcional! Valor de cada cobrança. Recebe uma string (no formato "%.2f"), um float ou um BigDecimal
+    payment.pre_approval.amount_per_payment = '200.00'
+
+    # opcional. Recebe uma string (de até 255 caracteres) e representa os detalhes da assinatura
+    payment.pre_approval.details = "detalhes da assinatura"
+
+    # opcional. Recebe uma data de quando a assinatura passa a valer. Não pode ser maior do que 2 anos da data atual, e precisa ser inferior a data de final_date (que pode ser maior em até 744 dias da data de início)
+    payment.pre_approval.initial_date = Date.new(2014, 3, 12)
+
+    # opcional. Recebe uma string que supostamente deveria levar às condições da sua assinatura
+    payment.pre_approval.reviewURL = "http://seuproduto.com/assinatura"
+
+    # Por fim gere a URL do pagseguro da mesma forma como nas compras/pagamentos normais.
+    redirect_to_url = payment.checkout_payment_url
+
 ## Validações
 
 Os modelos utilizados nesta gem utilizam as validações do ActiveModel (semelhantes às presentes em ActiveRecord/Rails) e incluem diversas validações, permitindo que se verifique a validade (utilizando object.valid?) dos dados antes de enviá-los ao PagSeguro. A gem não bloqueia o envio das informações caso os dados estejam inválidos, deixando este passo a cargo da sua aplicação, mas levanta erros caso o pag seguro retorne algum erro relativo às informações enviadas.
@@ -152,3 +215,5 @@ Desenvolvida por [Stefano Diem Benatti](mailto:stefano@heavenstudio.com.br)
 Rafael Castilho (<http://github.com/castilhor>)
 
 Rafael Ivan Garcia (https://github.com/rafaelivan)
+
+efmiglioranza (https://github.com/efmiglioranza)

data/lib/pag_seguro/checkout.xml.haml

@@ -8,7 +8,7 @@
     %redirectURL= payment.redirect_url
   - if payment.max_uses.present?
     %maxUses= payment.max_uses
-  - if payment. max_age.present?
+  - if payment.max_age.present?
     %maxAge= payment.max_age
 
   %currency BRL
@@ -39,10 +39,7 @@
 
   - if shipping.present?
     %shipping
-      - if !shipping.type.zero?
-        %type= shipping.type
-      - else
-        %type 3
+      %type= shipping.type
       - if shipping.cost.present?
         %cost= shipping.cost
       %address
@@ -61,3 +58,25 @@
           %number= shipping.number
         - if shipping.complement.present?
           %complement= shipping.complement
+
+  - if pre_approval.present?
+    %preApproval
+      %name= pre_approval.name
+      %finalDate= pre_approval.final_date.iso8601
+      %maxAmountPerPeriod= pre_approval.max_amount_per_period
+      %maxTotalAmount= pre_approval.max_total_amount
+      %period= pre_approval.period
+      - if pre_approval.weekly?
+        %dayOfWeek= pre_approval.day_of_week
+      - if pre_approval.monthly?
+        %dayOfMonth= pre_approval.day_of_month
+      - if pre_approval.yearly?
+        %dayOfYear= pre_approval.day_of_year
+      - if pre_approval.details.present?
+        %details= pre_approval.details
+      - if pre_approval.amount_per_payment.present?
+        %amountPerPayment= pre_approval.amount_per_payment
+      - if pre_approval.initial_date.present?
+        %initialDate= pre_approval.initial_date.iso8601
+      - if pre_approval.review_URL.present?
+        %reviewURL= pre_approval.review_URL

data/lib/pag_seguro/convert_field_to_digit.rb

@@ -0,0 +1,15 @@
+module PagSeguro
+  module ConvertFieldToDigit
+    def attr_reader_as_digit(*fields)
+      fields.each do |field|
+        define_method(field) do
+          begin
+            "%.2f" % instance_variable_get("@#{field}")
+          rescue ArgumentError, TypeError
+            instance_variable_get("@#{field}")
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pag_seguro/day_of_year.rb

@@ -0,0 +1,35 @@
+module PagSeguro
+  module Error
+    class InvalidDayOfYear < Exception
+      def initialize(date_of_year)
+        super("DateOfYear should be a valid date: (month: #{date_of_year.month}, day: #{date_of_year.day})")
+      end
+    end
+  end
+
+  class DayOfYear
+    include Comparable
+    attr_accessor :day, :month
+
+    def initialize(options = {})
+      @day = options[:day]
+      @month = options[:month]
+    end
+
+    def to_s
+      raise Error::InvalidDayOfYear.new(self) unless valid?
+      "#{"%02d" % @month}-#{"%02d" % @day}"
+    end
+
+    def valid?
+      # very simple date validation, just to smoke test possible errors of switching day with month
+      @day < 31 && @month < 12
+    end
+
+    def <=>(other_day_of_the_year)
+      return 1  if @month > other_day_of_the_year.month
+      return -1 if @month < other_day_of_the_year.month
+      @day <=> other_day_of_the_year.day
+    end
+  end
+end

data/lib/pag_seguro/item.rb

@@ -1,14 +1,17 @@
 module PagSeguro
   class Item
     include ActiveModel::Validations
+    extend PagSeguro::ConvertFieldToDigit
     
     attr_accessor :id, :description, :amount, :quantity, :shipping_cost, :weight
+    attr_reader_as_digit :amount, :shipping_cost
         
-    validates_presence_of :id, :description, :amount, :quantity
-    validates_format_of :amount, with: /^\d+\.\d{2}$/, message: " must be a decimal and have 2 digits after the dot"
-    validates_format_of :shipping_cost, with: /^\d+\.\d{2}$/, message: " must be a decimal and have 2 digits after the dot"
-    validates_format_of :weight, with: /^\d+$/, message: " must be an integer"
-    validate :quantity_amount
+    validates :id, presence: true
+    validates :description, presence: true
+    validates :amount, pagseguro_decimal: true, presence: true
+    validates :shipping_cost, pagseguro_decimal: true
+    validates :weight, numericality: { only_integer: true, greater_than: 0, allow_blank: true }
+    validates :quantity, presence: true, numericality: { only_integer: true, greater_than: 0, less_than: 1000 }
     
     def initialize(attributes = {})
       @id = attributes[:id]
@@ -22,10 +25,5 @@ module PagSeguro
     def description
       @description.present? && @description.size > 100 ? @description[0..99] : @description
     end
-    
-    protected
-      def quantity_amount
-        errors.add(:quantity, " must be a number between 1 and 999") if @quantity.present? && (@quantity == "0" || @quantity.to_s !~ /^\d{1,3}$/)
-      end
-    end
+  end
 end

data/lib/pag_seguro/notification.rb

@@ -10,7 +10,7 @@ module PagSeguro
       
     private
       def transaction_data(email, token, notification_code)
-        super(RestClient.get("#{PAGSEGURO_TRANSACTIONS_URL}/notifications/#{notification_code}?email=#{email}&token=#{token}"))
+        super RestClient.get "#{PAGSEGURO_TRANSACTIONS_URL}/notifications/#{notification_code}", params: {email: email, token: token}
       end
   end
 end

data/lib/pag_seguro/payment.rb

@@ -1,13 +1,16 @@
 module PagSeguro
   class Payment
     include ActiveModel::Validations
-        
-    attr_accessor :id, :email, :token, :items, :sender, :shipping, :extra_amount, :redirect_url, :max_uses, :max_age, :response
+    extend PagSeguro::ConvertFieldToDigit
+
+    attr_accessor :id, :email, :token, :items, :sender, :shipping, :extra_amount,
+      :redirect_url, :max_uses, :max_age, :response, :pre_approval
+    attr_reader_as_digit :extra_amount
     
     validates_presence_of :email, :token
-    validates_format_of :extra_amount, with: /^\d+\.\d{2}$/, message: " must be a decimal and have 2 digits after the dot", allow_blank: true
+    validates :extra_amount, pagseguro_decimal: true
     validates_format_of :redirect_url, with: URI::regexp(%w(http https)), message: " must give a correct url for redirection", allow_blank: true
-    validate :max_uses_number, :max_age_number
+    validate :max_uses_number, :max_age_number, :valid_pre_approval, :valid_items
     
     def initialize(email = nil, token = nil, options = {})
       @email        = email unless email.nil?
@@ -20,6 +23,7 @@ module PagSeguro
       @redirect_url = options[:redirect_url]
       @max_uses     = options[:max_uses]
       @max_age      = options[:max_age]
+      @pre_approval = options[:pre_approval]
     end
     
     def self.checkout_payment_url(code)
@@ -28,7 +32,7 @@ module PagSeguro
     
     def checkout_xml
       xml_content = File.open( File.dirname(__FILE__) + "/checkout.xml.haml" ).read
-      Haml::Engine.new(xml_content).render(nil, items: @items, payment: self, sender: @sender, shipping: @shipping)
+      Haml::Engine.new(xml_content).render(nil, items: @items, payment: self, sender: @sender, shipping: @shipping, pre_approval: @pre_approval)
     end
     
     def checkout_url_with_params
@@ -40,12 +44,12 @@ module PagSeguro
     end
     
     def code
-      @response ||= parse_checkout_response
+      response || parse_checkout_response
       parse_code
     end
     
     def date
-      @response ||= parse_checkout_response
+      response || parse_checkout_response
       parse_date
     end
     
@@ -61,30 +65,33 @@ module PagSeguro
       def max_age_number
         errors.add(:max_age, " must be an integer grater or equal to 30") if @max_age.present? && @max_age.to_i < 30
       end
+
+      def valid_pre_approval
+        errors.add(:pre_approval, " must be valid") if pre_approval && !pre_approval.valid?
+      end
+
+      def valid_items
+        errors.add(:items, " must be all valid") if items.blank? || !items.all?(&:valid?)
+      end
             
       def send_checkout
         RestClient.post(checkout_url_with_params, checkout_xml, content_type: "application/xml"){|resp, request, result| resp }
       end
       
       def parse_checkout_response
-        response = send_checkout
-        if response.code == 200
-          response.body
-        elsif response.code == 401
-          raise Errors::Unauthorized
-        elsif response.code == 400
-          raise Errors::InvalidData.new(response.body)
-        else
-          raise Errors::UnknownError.new(response)
-        end
+        res = send_checkout
+        raise Errors::Unauthorized if res.code == 401
+        raise Errors::InvalidData.new(res.body) if res.code == 400
+        raise Errors::UnknownError.new(res) if res.code != 200
+        @response = res.body
       end
       
       def parse_date
-        DateTime.iso8601( Nokogiri::XML(@response.body).css("checkout date").first.content )
+        DateTime.iso8601( Nokogiri::XML(response.body).css("checkout date").first.content )
       end
       
       def parse_code
-        Nokogiri::XML(@response.body).css("checkout code").first.content
+        Nokogiri::XML(response.body).css("checkout code").first.content
       end
   end
 end

data/lib/pag_seguro/pre_approval.rb

@@ -0,0 +1,84 @@
+module PagSeguro
+  class PreApproval
+    include ActiveModel::Validations
+    extend PagSeguro::ConvertFieldToDigit
+
+    PERIOD_TYPES = %w(weekly monthly bimonthly trimonthly semiannually yearly)
+    DAYS_OF_WEEK = %w(monday tuesday wednesday thursday friday saturday sunday)
+    DATE_RANGE = 17856.hours
+
+    attr_accessor :name, :details, :amount_per_payment, :period, :day_of_week, :day_of_month,
+      :day_of_year, :initial_date, :final_date, :max_amount_per_period, :max_total_amount, :review_URL
+    attr_reader_as_digit :amount_per_payment, :max_amount_per_period, :max_total_amount
+
+    validates_presence_of :name, :period, :final_date, :max_total_amount, :max_amount_per_period
+    validates_inclusion_of :period, in: PERIOD_TYPES
+    validates_inclusion_of :day_of_week, in: DAYS_OF_WEEK, if: :weekly?
+    validates_inclusion_of :day_of_month, in: (1..28), if: :monthly?
+    validates_presence_of :day_of_year, if: :yearly?
+    validates_format_of :day_of_year, with: /^\d{2}-\d{2}$/, if: :yearly?
+    validate :initial_date_range, :final_date_range
+    validates :max_amount_per_period, pagseguro_decimal: true
+    validates :max_total_amount, pagseguro_decimal: true
+
+    def initialize(options = {})
+      @name = options[:name]
+      @details = options[:details]
+      @amount_per_payment = options[:amount_per_payment]
+      @period = options[:period]
+      @day_of_week = options[:day_of_week]
+      @day_of_month = options[:day_of_month]
+      @day_of_year = options[:day_of_year]
+      @initial_date = options[:initial_date]
+      @final_date = options[:final_date]
+      @max_amount_per_period = options[:max_amount_per_period]
+      @max_total_amount = options[:max_total_amount]
+      @review_URL = options[:review_URL]
+    end
+
+    def period
+      @period.to_s.downcase
+    end
+
+    def day_of_week
+      @day_of_week.to_s.downcase
+    end
+
+    def day_of_year
+      @day_of_year.to_s
+    end
+
+    def initial_date
+      @initial_date.to_datetime if @initial_date.present?
+    end
+
+    def final_date
+      @final_date.to_datetime if @final_date.present?
+    end
+
+    def weekly?
+      period == 'weekly'
+    end
+
+    def monthly?
+      %w(monthly bimonthly trimonthly).include? period
+    end
+
+    def yearly?
+      period == 'yearly'
+    end
+
+    protected
+      def initial_date_range
+        return unless initial_date
+        errors.add(:initial_date) if initial_date < Time.now - 5.minutes
+        errors.add(:initial_date) if initial_date > DATE_RANGE.from_now
+      end
+
+      def final_date_range
+        return unless final_date
+        errors.add(:final_date) if final_date < (initial_date || Time.now) - 5.minutes
+        errors.add(:final_date) if final_date > (initial_date || Time.now) + DATE_RANGE
+      end
+  end
+end

data/lib/pag_seguro/query.rb

@@ -8,9 +8,35 @@ module PagSeguro
       @data = transaction_data(email, token, transaction_code)
     end
       
+    def self.find(email, token, options={})
+      url = Transaction::PAGSEGURO_TRANSACTIONS_URL
+      transactions_data = Nokogiri::XML(RestClient.get url, params: search_params(email, token, options))
+      transactions_data.css("transaction").map{|transaction_xml| Transaction.new(transaction_xml) }
+    end
+
+    def self.search_params(email, token, options={})
+      params = {email: email, token: token}
+      params[:initialDate], params[:finalDate] = parse_dates(options)
+      params[:page]                            = options[:page] if options[:page]
+      params[:maxPageResults]                  = options[:max_page_results] if options[:max_page_results]
+      params
+    end
+
+    def self.parse_dates(options={})
+      initial_date = (options[:initial_date] || Time.now - 1.day).to_time
+      final_date   = (options[:final_date] || initial_date + 1.day).to_time
+
+      raise "Invalid initial date. Must be bigger than 6 months ago" if initial_date < 6.months.ago
+      raise "Invalid end date. Must be less than today" if final_date > Date.today.end_of_day
+      raise "Invalid end date. Must be bigger than initial date" if final_date < initial_date
+      raise "Invalid end date. Must not differ from initial date in more than 30 days" if (final_date.to_date - initial_date.to_date) > 30
+
+      return initial_date.to_time.iso8601, final_date.to_time.iso8601
+    end
+ 
     private
       def transaction_data(email, token, transaction_code)
-        super(RestClient.get("#{PAGSEGURO_TRANSACTIONS_URL}/#{transaction_code}?email=#{email}&token=#{token}"))
+        super RestClient.get "#{PAGSEGURO_TRANSACTIONS_URL}/#{transaction_code}", params: {email: email, token: token}
       end
   end
 end

data/lib/pag_seguro/sender.rb

@@ -27,11 +27,11 @@ module PagSeguro
     end
     
     def phone_ddd
-      @phone_ddd if @phone_ddd =~ /^\d{2}$/
+      @phone_ddd if @phone_ddd.to_s =~ /^\d{2}$/
     end
     
     def phone_number
-      @phone_number if @phone_number =~/^\d{8,9}$/
+      @phone_number if @phone_number.to_s =~/^\d{8,9}$/
     end
   end
 end

data/lib/pag_seguro/shipping.rb

@@ -6,12 +6,12 @@ module PagSeguro
     SEDEX = 2
     UNIDENTIFIED = 3
     
-    validates_format_of :postal_code, with: /^\d{8}$/, message: " must be an integer with 8 digits", allow_blank: true
+    validates :postal_code, numericality: true, length: {is: 8}
     
     attr_accessor :type, :state, :city, :postal_code, :district, :street, :number, :complement, :cost
     
     def initialize(attributes = {})
-      @type = attributes[:type]
+      @type = attributes[:type] || UNIDENTIFIED
       @state = attributes[:state]
       @city = attributes[:city]
       @postal_code = attributes[:postal_code]

data/lib/pag_seguro/transaction.rb

@@ -170,7 +170,7 @@ module PagSeguro
   
     protected
       def transaction_data(transaction_xml)
-        Nokogiri::XML(transaction_xml)
+        transaction_xml.instance_of?(Nokogiri::XML::Element) ? transaction_xml : Nokogiri::XML(transaction_xml)
       end
 
       def parse_item(data, attribute)

data/lib/pag_seguro/version.rb

@@ -1,3 +1,3 @@
 module PagSeguro
-  VERSION = "0.4.1"
+  VERSION = "0.5.1"
 end

data/lib/pag_seguro.rb

@@ -1,12 +1,18 @@
 $: << File.expand_path(File.dirname(__FILE__) + "/../lib/pag_seguro")
 
-require 'date'
+require "date"
+require "bigdecimal"
 
 # Third party gems
 require "active_model"
 require "nokogiri"
 require "haml"
 require "rest-client"
+require "active_support"
+require "active_support/time"
+
+require "pagseguro_decimal_validator"
+require "convert_field_to_digit"
 
 # PagSeguro classes
 require "item"
@@ -14,6 +20,8 @@ require "payment"
 require "payment_method"
 require "sender"
 require "shipping"
+require "day_of_year"
+require "pre_approval"
 require "transaction"
 require "notification"
 require "query"

data/lib/pagseguro_decimal_validator.rb

@@ -0,0 +1,9 @@
+class PagseguroDecimalValidator < ActiveModel::EachValidator
+  def validate_each(object, attribute, value)
+    object.errors.add(attribute, error_message) unless value.nil? || value =~ /^\d+\.\d{2}$/
+  end
+
+  def error_message
+    " must be a decimal and have 2 digits after the dot"
+  end
+end

data/pag_seguro.gemspec

@@ -19,6 +19,7 @@ Gem::Specification.new do |s|
   s.has_rdoc      = false
   
   s.add_dependency('activemodel')
+  s.add_dependency('activesupport')
   s.add_dependency('haml', '!= 3.1.5')
   s.add_dependency('nokogiri')
   s.add_dependency('rest-client', '~> 1.6.7')