pagseguro-oficial 2.5.0 → 2.6.0

data/examples/split_payment/create_transaction_using_credit_card.rb

@@ -0,0 +1,152 @@
+require_relative "../boot"
+
+# Create Transaction Using Credit Card
+#
+# You need to set your AccountCredentials (EMAIL, TOKEN) in the application config
+#
+# P.S: See the boot file example for more details.
+
+app_id = 'APP_ID'
+app_key = 'APP_KEY'
+
+payment = PagSeguro::CreditCardTransactionRequest.new
+payment.notification_url = "http://www.lojateste.com.br/notification"
+payment.payment_mode = "default"
+payment.credentials = PagSeguro::ApplicationCredentials.new(app_id, app_key)
+
+payment.items << {
+  id: 1234,
+  description: %[Televisão 19" Sony],
+  amount: 100.0,
+  weight: 0
+}
+
+payment.reference = "REF1234-credit-card"
+payment.sender = {
+  hash: "9aff5821b4a6f5a1dc9e15d3a3b02ac666a1629fcb90e2bbf6b7da661b344094",
+  name: "Joao Comprador",
+  email: "EMAIL_FROM@sandbox.pagseguro.com.br",
+  document: { type: "CPF", value: "75073461100" },
+  phone: {
+    area_code: 11,
+    number: "12345678"
+  }
+}
+
+payment.shipping = {
+  type_name: "sedex",
+  address: {
+    street: "Av. Brig. Faria Lima",
+    number: "1384",
+    complement: "5º andar",
+    city: "São Paulo",
+    state: "SP",
+    district: "Jardim Paulistano",
+    postal_code: "01452002"
+  }
+}
+
+payment.receivers = [
+  {
+    public_key: 'PUBLIC_KEY',
+    split: {
+      amount: 20.0,
+      rate_percent: 50.0,
+      fee_percent: 50.0
+    }
+  }
+]
+
+payment.billing_address = {
+  street: "Av. Brig. Faria Lima",
+  number: "1384",
+  complement: "5º andar",
+  city: "São Paulo",
+  state: "SP",
+  district: "Jardim Paulistano",
+  postal_code: "01452002"
+}
+
+payment.credit_card_token = "CREDIT_CARD_TOKEN"
+payment.holder = {
+  name: "João Comprador",
+  birth_date: "07/05/1981",
+  document: {
+    type: "CPF",
+    value: "00000000191"
+  },
+  phone: {
+    area_code: 11,
+    number: "123456789"
+  }
+}
+
+payment.installment = {
+  value: 100.0,
+  quantity: 1
+}
+
+# Add extras params to request
+# payment.extra_params << { paramName: 'paramValue' }
+# payment.extra_params << { senderBirthDate: '07/05/1981' }
+
+# Edit the lines above.
+
+puts "=> REQUEST"
+puts PagSeguro::TransactionRequest::RequestSerializer.new(payment).to_params
+puts
+
+payment.create
+
+if payment.errors.any?
+  puts "=> ERRORS"
+  puts payment.errors.join("\n")
+else
+  puts "=> Transaction"
+  puts "  code: #{payment.code}"
+  puts "  reference: #{payment.reference}"
+  puts "  type: #{payment.type_id}"
+  puts "  payment link: #{payment.payment_link}"
+  puts "  status: #{payment.status}"
+  puts "  payment method type: #{payment.payment_method}"
+  puts "  created at: #{payment.created_at}"
+  puts "  updated at: #{payment.updated_at}"
+  puts "  gross amount: #{payment.gross_amount.to_f}"
+  puts "  discount amount: #{payment.discount_amount.to_f}"
+  puts "  net amount: #{payment.net_amount.to_f}"
+  puts "  extra amount: #{payment.extra_amount.to_f}"
+  puts "  installment count: #{payment.installment_count}"
+
+  puts "    => Items"
+  puts "      items count: #{payment.items.size}"
+  payment.items.each do |item|
+    puts "      item id: #{item.id}"
+    puts "      description: #{item.description}"
+    puts "      quantity: #{item.quantity}"
+    puts "      amount: #{item.amount.to_f}"
+  end
+
+  puts "    => Receivers"
+  puts "      receivers count: #{payment.receivers.size}"
+  payment.receivers.each do |receiver|
+    puts "      email: #{receiver.email}"
+    puts "      amount: #{receiver.split.amount}"
+  end
+
+  puts "    => Sender"
+  puts "      name: #{payment.sender.name}"
+  puts "      email: #{payment.sender.email}"
+  puts "      phone: (#{payment.sender.phone.area_code}) #{payment.sender.phone.number}"
+  puts "      document: #{payment.sender.document}: #{payment.sender.document}"
+
+  puts "    => Shipping"
+  puts "      street: #{payment.shipping.address.street}, #{payment.shipping.address.number}"
+  puts "      complement: #{payment.shipping.address.complement}"
+  puts "      postal code: #{payment.shipping.address.postal_code}"
+  puts "      district: #{payment.shipping.address.district}"
+  puts "      city: #{payment.shipping.address.city}"
+  puts "      state: #{payment.shipping.address.state}"
+  puts "      country: #{payment.shipping.address.country}"
+  puts "      type: #{payment.shipping.type_name}"
+  puts "      cost: #{payment.shipping.cost}"
+end

data/lib/pagseguro.rb

@@ -47,6 +47,10 @@ require "pagseguro/item"
 require "pagseguro/items"
 require "pagseguro/bank"
 require "pagseguro/holder"
+require "pagseguro/manual_subscription_charger"
+require "pagseguro/manual_subscription_charger/request_serializer"
+require "pagseguro/manual_subscription_charger/response"
+require "pagseguro/manual_subscription_charger/response_serializer"
 require "pagseguro/payment_method"
 require "pagseguro/payment_release"
 require "pagseguro/payment_releases"
@@ -66,15 +70,25 @@ require "pagseguro/sender"
 require "pagseguro/session"
 require "pagseguro/session/response"
 require "pagseguro/session/response_serializer"
+require "pagseguro/subscription_discount"
+require "pagseguro/subscription_discount/request_serializer"
+require "pagseguro/subscription_discount/response"
 require "pagseguro/notification"
 require "pagseguro/notification/authorization"
 require "pagseguro/notification/transaction"
+require "pagseguro/subscription_canceller"
+require "pagseguro/subscription_canceller/response"
+require "pagseguro/subscription_plan"
+require "pagseguro/subscription_plan/request_serializer"
+require "pagseguro/subscription_plan/response"
+require "pagseguro/subscription_plan/response_serializer"
+require "pagseguro/subscription_retry"
+require "pagseguro/subscription_retry/response"
 require "pagseguro/transaction"
 require "pagseguro/transaction_status"
 require "pagseguro/transaction/response"
 require "pagseguro/transaction/serializer"
 require "pagseguro/transaction/collection"
-require "pagseguro/transaction/status_collection"
 require "pagseguro/transaction_cancellation"
 require "pagseguro/transaction_cancellation/request_serializer"
 require "pagseguro/transaction_cancellation/response"
@@ -91,6 +105,24 @@ require "pagseguro/transaction_request/request_serializer"
 require "pagseguro/boleto_transaction_request"
 require "pagseguro/online_debit_transaction_request"
 require "pagseguro/credit_card_transaction_request"
+require "pagseguro/subscription_payment_method"
+require "pagseguro/subscription"
+require "pagseguro/subscription/request_serializer"
+require "pagseguro/subscription/response_serializer"
+require "pagseguro/subscription/response"
+require "pagseguro/subscription/subscription_search"
+require "pagseguro/subscription_change_payment"
+require "pagseguro/subscription_change_payment/request_serializer"
+require "pagseguro/subscription_change_payment/response"
+require "pagseguro/subscription_change_status/request_serializer"
+require "pagseguro/subscription_change_status/response"
+require "pagseguro/subscription_change_status"
+require "pagseguro/subscription_transaction"
+require "pagseguro/subscription_transactions"
+require "pagseguro/subscription_payment_order"
+require "pagseguro/subscription_payment_order/response_serializer"
+require "pagseguro/subscription_payment_order/response"
+require "pagseguro/subscription_search_payment_orders"
 
 I18n.load_path += Dir[File.expand_path("../../locales/*.yml", __FILE__)]
 

data/lib/pagseguro/credit_card_transaction_request.rb

@@ -15,7 +15,7 @@ module PagSeguro
 
     # Get the payment_method.
     def payment_method
-      "credit_card"
+      "creditCard"
     end
 
     # Set the installment.

data/lib/pagseguro/document.rb

@@ -11,5 +11,13 @@ module PagSeguro
     def ==(other)
       [type, value] == [other.type, other.value]
     end
+
+    def cpf?
+      type == 'CPF'
+    end
+
+    def cnpj?
+      type == 'CNPJ'
+    end
   end
 end

data/lib/pagseguro/holder.rb

@@ -15,6 +15,9 @@ module PagSeguro
     # Get the phone.
     attr_reader :phone
 
+    # Get the billing address
+    attr_reader :billing_address
+
     # Set the document.
     def document=(document)
       @document = ensure_type(Document, document)
@@ -24,5 +27,10 @@ module PagSeguro
     def phone=(phone)
       @phone = ensure_type(Phone, phone)
     end
+
+    # Set the billing address
+    def billing_address=(billing_address)
+      @billing_address = ensure_type(Address, billing_address)
+    end
   end
 end

data/lib/pagseguro/manual_subscription_charger.rb

@@ -0,0 +1,59 @@
+module PagSeguro
+  class ManualSubscriptionCharger
+    include Extensions::Credentiable
+    include Extensions::EnsureType
+    include Extensions::MassAssignment
+
+    API_VERSION = :v2
+
+    # Set reference
+    attr_accessor :reference
+
+    # Set subscription code of a manual subscription
+    attr_accessor :subscription_code
+
+    # Set transaction code, it is within the response
+    attr_accessor :transaction_code
+
+    # Set items
+    attr_reader :items
+
+    # Set errors
+    def errors
+      @errors ||= Errors.new
+    end
+
+    def items=(items=[])
+      @items = items.map do |item|
+                 ensure_type(Item, item)
+               end
+    end
+
+    # Update all attributes
+    def update_attributes(attrs)
+      attrs.each { |name, value| send("#{name}=", value) }
+    end
+
+    def create
+      request = Request.post_xml('pre-approvals/payment', API_VERSION, credentials, xml_params)
+
+      Response.new(request, self).serialize
+
+      self
+    end
+
+    private
+
+    def xml_params
+      RequestSerializer.new(self).to_xml_params
+    end
+
+    def before_initialize
+      @items ||= Items.new
+    end
+
+    def after_initialize
+      @errors = Errors.new
+    end
+  end
+end

data/lib/pagseguro/manual_subscription_charger/request_serializer.rb

@@ -0,0 +1,50 @@
+module PagSeguro
+  class ManualSubscriptionCharger
+    class RequestSerializer
+      attr_reader :object
+
+      def initialize(object)
+        @object = object
+      end
+
+      def to_xml_params
+        xml_builder.to_xml(
+          save_with:
+          Nokogiri::XML::Node::SaveOptions::NO_EMPTY_TAGS |
+          Nokogiri::XML::Node::SaveOptions::FORMAT
+        )
+      end
+
+      private
+
+      def to_amount(amount = 0.0)
+        "%.2f" % BigDecimal(amount.to_s).round(2).to_s("F")
+      end
+
+      def xml_serialize_items(xml, items = [])
+        return if items.empty?
+
+        xml.send(:items) do
+          items.each do |item|
+            xml.send(:item) do
+              xml.send(:id, item.id)
+              xml.send(:description, item.description)
+              xml.send(:quantity, item.quantity)
+              xml.send(:amount, to_amount(item.amount))
+            end
+          end
+        end
+      end
+
+      def xml_builder
+        Nokogiri::XML::Builder.new(encoding: PagSeguro.encoding) do |xml|
+          xml.send(:payment) {
+            xml.send(:reference, object.reference)
+            xml.send(:preApprovalCode, object.subscription_code)
+            xml_serialize_items(xml, object.items)
+          }
+        end
+      end
+    end
+  end
+end

data/lib/pagseguro/manual_subscription_charger/response.rb

@@ -0,0 +1,36 @@
+module PagSeguro
+  class ManualSubscriptionCharger
+    class Response
+      # The http response.
+      attr_reader :response
+
+      # Set the boject that will receive errors or updates
+      attr_reader :object
+
+      def initialize(response, object)
+        @response = response
+        @object = object
+      end
+
+      def serialize
+        if success?
+          object.update_attributes(ResponseSerializer.new(xml).serialize)
+        else
+          object.errors.add response
+        end
+
+        object
+      end
+
+      def success?
+        response.success? && response.xml?
+      end
+
+      private
+
+      def xml
+        Nokogiri::XML(response.body)
+      end
+    end
+  end
+end

data/lib/pagseguro/manual_subscription_charger/response_serializer.rb

@@ -0,0 +1,17 @@
+module PagSeguro
+  class ManualSubscriptionCharger
+    class ResponseSerializer
+      attr_reader :xml
+
+      def initialize(xml)
+        @xml = xml
+      end
+
+      def serialize
+        {}.tap do |data|
+          data[:transaction_code] = xml.css('result > transactionCode').text
+        end
+      end
+    end
+  end
+end

data/lib/pagseguro/payment_request/request_serializer.rb

@@ -68,11 +68,20 @@ module PagSeguro
 
         data[:senderEmail] =  sender.email
         data[:senderName] = sender.name
-        data[:senderCPF] = sender.cpf
 
+        serialize_documents(data, sender.documents)
         serialize_phone(data, sender.phone)
       end
 
+      def serialize_documents(data, documents)
+        return if documents.empty?
+
+        documents.each do |document|
+          data[:senderCPF] = document.value if document.cpf?
+          data[:senderCNPJ] = document.value if document.cnpj?
+        end
+      end
+
       def serialize_phone(data, phone)
         return unless phone
 
@@ -143,6 +152,19 @@ module PagSeguro
         }
       end
 
+      def xml_serialize_documents(xml, documents)
+        return if documents.empty?
+
+        xml.send(:documents) {
+          documents.each do |document|
+            xml.send(:document) {
+              xml.send(:type, document.type)
+              xml.send(:value, document.value)
+            }
+          end
+        }
+      end
+
       def xml_serialize_sender(xml, sender)
         return unless sender
 
@@ -155,6 +177,8 @@ module PagSeguro
               xml.send(:number, sender.phone.number)
             }
           end
+
+          xml_serialize_documents(xml, sender.documents)
         }
       end