pagseguro-oficial 2.0.5

data/Rakefile

@@ -0,0 +1,5 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+task default: "spec"

data/examples/abandoned_transactions.rb

@@ -0,0 +1,26 @@
+require_relative "boot"
+require "active_support/all"
+
+report = PagSeguro::Transaction.find_abandoned(
+  starts_at: 30.days.ago,
+  size: 1
+)
+
+while report.next_page?
+  report.next_page!
+  puts "=> Fetching page #{report.page}"
+
+  abort "=> Errors: #{report.errors.join("\n")}" unless report.valid?
+
+  puts "=> Report was created at: #{report.created_at}"
+  puts
+
+  report.transactions.each do |transaction|
+    puts "=> Abandoned transaction"
+    puts "   created at: #{transaction.created_at}"
+    puts "   code: #{transaction.code}"
+    puts "   type_id: #{transaction.type_id}"
+    puts "   gross amount: #{transaction.gross_amount}"
+    puts
+  end
+end

data/examples/boot.rb

@@ -0,0 +1,9 @@
+$:.unshift File.expand_path("../../lib", __FILE__)
+require "pagseguro"
+
+I18n.locale = "pt-BR"
+
+PagSeguro.configure do |config|
+  config.token = ENV.fetch("PAGSEGURO_TOKEN")
+  config.email = ENV.fetch("PAGSEGURO_EMAIL")
+end

data/examples/invalid_transaction_by_notification_code.rb

@@ -0,0 +1,9 @@
+require_relative "boot"
+
+transaction = PagSeguro::Transaction.find_by_notification_code("Invalid")
+
+if transaction.errors.any?
+  puts transaction.errors.join("\n")
+else
+  puts transaction
+end

data/examples/payment_request.rb

@@ -0,0 +1,49 @@
+# -*- encoding : utf-8 -*- 
+require_relative "boot"
+
+payment = PagSeguro::PaymentRequest.new
+payment.abandon_url = "http://dev.simplesideias.com.br/?abandoned"
+payment.notification_url = "http://dev.simplesideias.com.br/?notification"
+payment.redirect_url = "http://dev.simplesideias.com.br/?redirect"
+
+payment.items << {
+  id: 1234,
+  description: %[Televisão 19" Sony],
+  amount: 459.50,
+  weight: 0
+}
+
+payment.reference = "REF1234"
+payment.sender = {
+  name: "Nando Vieira",
+  email: "fnando.vieira@gmail.com",
+  cpf: "21639716866",
+  phone: {
+    area_code: 11,
+    number: "12345678"
+  }
+}
+
+payment.shipping = {
+  type_name: "sedex",
+  address: {
+    street: "R. Vergueiro",
+    number: 1421,
+    complement: "Sala 213",
+    city: "São Paulo",
+    state: "SP",
+    district: "Vila Mariana"
+  }
+}
+
+puts "=> REQUEST"
+puts PagSeguro::PaymentRequest::Serializer.new(payment).to_params
+
+response = payment.register
+
+puts
+puts "=> RESPONSE"
+puts response.url
+puts response.code
+puts response.created_at
+puts response.errors.to_a

data/examples/transaction_by_notification_code.rb

@@ -0,0 +1,5 @@
+require_relative "boot"
+
+transaction = PagSeguro::Transaction.find_by_notification_code("739D69-79C052C05280-55542D9FBB33-4AB2D0")
+
+puts transaction

data/examples/transactions_by_date.rb

@@ -0,0 +1,23 @@
+require_relative "boot"
+require "active_support/all"
+
+report = PagSeguro::Transaction.find_by_date(starts_at: 29.days.ago, per_page: 1)
+
+while report.next_page?
+  report.next_page!
+  puts "== Page #{report.page}"
+  abort "=> Errors: #{report.errors.join("\n")}" unless report.valid?
+  puts "Report created on #{report.created_at}"
+  puts
+
+  report.transactions.each do |transaction|
+    puts "=> Transaction"
+    puts "   created_at: #{transaction.created_at}"
+    puts "   code: #{transaction.code}"
+    puts "   cancellation_source: #{transaction.cancellation_source}"
+    puts "   payment method: #{transaction.payment_method.type}"
+    puts "   gross amount: #{transaction.gross_amount}"
+    puts "   updated at: #{transaction.updated_at}"
+    puts
+  end
+end

data/lib/pagseguro/address.rb

@@ -0,0 +1,40 @@
+module PagSeguro
+  # Set the shipping address information.
+  class Address
+    include Extensions::MassAssignment
+
+    # Set the street name.
+    attr_accessor :street
+
+    # Set the house/building number.
+    attr_accessor :number
+
+    # Set the address complement.
+    # Can be the apartment, suite number or any other qualifier after
+    # the street/number pair.
+    attr_accessor :complement
+
+    # Set the district.
+    # Can be the district, county or neighborhood, if applicable.
+    attr_accessor :district
+
+    # Set the city name.
+    attr_accessor :city
+
+    # Set the state or province.
+    attr_accessor :state
+
+    # Set the postal code.
+    # Must contain 8 numbers.
+    attr_accessor :postal_code
+
+    # Set the country code.
+    # Defaults to +BRA+.
+    attr_accessor :country
+
+    private
+    def before_initialize
+      self.country = "BRA"
+    end
+  end
+end

data/lib/pagseguro/errors.rb

@@ -0,0 +1,28 @@
+module PagSeguro
+  class Errors
+    extend Forwardable
+    include Enumerable
+
+    def_delegators :@messages, :each, :empty?, :any?, :join, :include?
+
+    def initialize(response = nil)
+      @response = response
+      @messages = []
+
+      process_response if response
+    end
+
+    private
+    def process_response
+      @messages << error_message(:unauthorized, "Unauthorized") if @response.unauthorized?
+
+      @response.data.css("errors > error").each do |error|
+        @messages << error_message(error.css("code").text, error.css("message").text)
+      end if @response.bad_request?
+    end
+
+    def error_message(code, message)
+      I18n.t(code, scope: "pagseguro.errors", default: message)
+    end
+  end
+end

data/lib/pagseguro/exceptions.rb

@@ -0,0 +1,3 @@
+module PagSeguro
+  InvalidEnvironmentError = Class.new(StandardError)
+end

data/lib/pagseguro/extensions/ensure_type.rb

@@ -0,0 +1,9 @@
+module PagSeguro
+  module Extensions
+    module EnsureType
+      def ensure_type(klass, options = {})
+        options.kind_of?(klass) ? options : klass.new(options)
+      end
+    end
+  end
+end

data/lib/pagseguro/extensions/mass_assignment.rb

@@ -0,0 +1,11 @@
+module PagSeguro
+  module Extensions
+    module MassAssignment
+      def initialize(options = {})
+        before_initialize if respond_to?(:before_initialize, true)
+        options.each {|name, value| public_send("#{name}=", value) }
+        after_initialize if respond_to?(:after_initialize, true)
+      end
+    end
+  end
+end

data/lib/pagseguro/item.rb

@@ -0,0 +1,30 @@
+module PagSeguro
+  class Item
+    include Extensions::MassAssignment
+
+    # Set the product identifier, such as SKU.
+    attr_accessor :id
+
+    # Set the product description.
+    attr_accessor :description
+
+    # Set the quantity.
+    # Defaults to 1.
+    attr_accessor :quantity
+
+    # Set the amount per unit.
+    attr_accessor :amount
+
+    # Set the weight per unit, in grams.
+    attr_accessor :weight
+
+    # Set the shipping cost per unit.
+    attr_accessor :shipping_cost
+
+    private
+    def before_initialize
+      self.quantity = 1
+      self.weight = 0
+    end
+  end
+end

data/lib/pagseguro/items.rb

@@ -0,0 +1,27 @@
+module PagSeguro
+  class Items
+    extend Forwardable
+    include Enumerable
+    include Extensions::EnsureType
+
+    def_delegators :@store, :size, :clear, :empty?, :any?, :each
+
+    def initialize
+      @store = []
+    end
+
+    def <<(item)
+      item = ensure_type(Item, item)
+
+      if include?(item)
+        item.quantity += 1
+      else
+        @store << item
+      end
+    end
+
+    def include?(item)
+      @store.find {|stored_item| stored_item.id == ensure_type(Item, item).id }
+    end
+  end
+end

data/lib/pagseguro/notification.rb

@@ -0,0 +1,21 @@
+module PagSeguro
+  class Notification
+    include PagSeguro::Extensions::MassAssignment
+
+    # The notification code sent by PagSeguro.
+    attr_accessor :code
+
+    # 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_method.rb

@@ -0,0 +1,38 @@
+# -*- encoding: utf-8 -*-
+module PagSeguro
+  class PaymentMethod
+    include Extensions::MassAssignment
+
+    TYPES = {
+      "1" => :credit_card,
+      "2" => :boleto,
+      "3" => :online_transfer,
+      "4" => :balance,
+      "5" => :oi_paggo,
+      "7" => :direct_deposit
+    }.freeze
+
+    # The payment method code.
+    attr_accessor :code
+
+    # The payment method type.
+    attr_accessor :type_id
+
+    # Define shortcuts dynamically.
+    TYPES.each do |id, type|
+      define_method "#{type}?" do
+        type_id.to_s == id
+      end
+    end
+
+    # Return the type in a readable manner.
+    def type
+      TYPES.fetch(type_id.to_s) { raise "PagSeguro::PaymentMethod#type_id isn't mapped" }
+    end
+
+    # Return the payment method's description.
+    def description
+      I18n.t(code, scope: "pagseguro.payment_methods")
+    end
+  end
+end

data/lib/pagseguro/payment_request/response.rb

@@ -0,0 +1,30 @@
+module PagSeguro
+  class PaymentRequest
+    class Response
+      extend Forwardable
+
+      def_delegators :response, :success?
+      attr_reader :response
+
+      def initialize(response)
+        @response = response
+      end
+
+      def errors
+        @errors ||= Errors.new(response)
+      end
+
+      def url
+        PagSeguro.site_url("checkout/payment.html?code=#{code}") if code
+      end
+
+      def code
+        @code ||= response.data.css("checkout > code").text if success?
+      end
+
+      def created_at
+        @created_at ||= Time.parse(response.data.css("checkout > date").text) if success?
+      end
+    end
+  end
+end

data/lib/pagseguro/payment_request/serializer.rb

@@ -0,0 +1,91 @@
+module PagSeguro
+  class PaymentRequest
+    class Serializer
+      # The payment request that will be serialized.
+      attr_reader :payment_request
+
+      def initialize(payment_request)
+        @payment_request = payment_request
+      end
+
+      def to_params
+        params[:receiverEmail] = PagSeguro.receiver_email
+        params[:currency] = payment_request.currency
+        params[:reference] = payment_request.reference
+        params[:extraAmount] = to_amount(payment_request.extra_amount)
+        params[:redirectURL] = payment_request.redirect_url
+        params[:notificationURL] = payment_request.notification_url
+        params[:abandonURL] = payment_request.abandon_url
+        params[:maxUses] = payment_request.max_uses
+        params[:maxAge] = payment_request.max_age
+        payment_request.items.each.with_index(1) do |item, index|
+          serialize_item(item, index)
+        end
+
+        serialize_sender(payment_request.sender)
+        serialize_shipping(payment_request.shipping)
+
+        params.delete_if {|key, value| value.nil? }
+
+        params
+      end
+
+      private
+      def params
+        @params ||= {}
+      end
+
+      def serialize_item(item, index)
+        params["itemId#{index}"] = item.id
+        params["itemDescription#{index}"] = item.description
+        params["itemAmount#{index}"] = to_amount(item.amount)
+        params["itemQuantity#{index}"] = item.quantity
+        params["itemShippingCost#{index}"] = to_amount(item.shipping_cost)
+        params["itemWeight#{index}"] = item.weight if item.weight
+      end
+
+      def serialize_sender(sender)
+        return unless sender
+
+        params[:senderEmail] =  sender.email
+        params[:senderName] = sender.name
+        params[:senderCPF] = sender.cpf
+
+        serialize_phone(sender.phone)
+      end
+
+      def serialize_phone(phone)
+        return unless phone
+
+        params[:senderAreaCode] = phone.area_code
+        params[:senderPhone] = phone.number
+      end
+
+      def serialize_shipping(shipping)
+        return unless shipping
+
+        params[:shippingType] = shipping.type_id
+        params[:shippingCost] = to_amount(shipping.cost)
+
+        serialize_address(shipping.address)
+      end
+
+      def serialize_address(address)
+        return unless address
+
+        params[:shippingAddressCountry] = address.country
+        params[:shippingAddressState] = address.state
+        params[:shippingAddressCity] = address.city
+        params[:shippingAddressPostalCode] = address.postal_code
+        params[:shippingAddressDistrict] = address.district
+        params[:shippingAddressStreet] = address.street
+        params[:shippingAddressNumber] = address.number
+        params[:shippingAddressComplement] = address.complement
+      end
+
+      def to_amount(amount)
+        "%.2f" % BigDecimal(amount.to_s).round(2).to_s("F") if amount
+      end
+    end
+  end
+end