pagseguro-oficial 2.4.0 → 2.5.0

data/examples/{transaction/transaction_cancellation.rb → request_transaction_cancellation.rb}

@@ -1,6 +1,6 @@
-require_relative "../boot"
+require_relative "boot"
 
-# Transaction cancellation
+# Request Transaction Cancellation
 #
 #   You need:
 #     - give TRANSACTION CODE to TransactionCancellation#transaction_code

data/examples/{authorization/authorization.rb → split_payment/create_authorization.rb}

@@ -1,6 +1,6 @@
 require_relative "../boot"
 
-# Authorization
+# Create Authorization
 #
 #   You need to give:
 #     - notification_url
@@ -8,7 +8,7 @@ require_relative "../boot"
 #     - permissions defaults to all permissions
 #     - applications credentials (APP_ID, APP_KEY)
 #
-#   You can pass this parameters to PagSeguro::AuthorizationRequest#new
+#   You can pass these parameters to PagSeguro::AuthorizationRequest#new
 #
 # PS: For more details look the class PagSeguro::AuthorizationRequest
 
@@ -16,9 +16,10 @@ credentials = PagSeguro::ApplicationCredentials.new('APP_ID', 'APP_KEY')
 
 options = {
   credentials: credentials, # Unnecessary if you set in application config
-  permissions: [:searches, :notifications],
+  permissions: [:checkouts],
   notification_url: 'http://example.com/',
-  redirect_url: 'http://example.com/'
+  redirect_url: 'http://example.com/',
+  reference: 'REF4321' # optional
 }
 
 authorization_request = PagSeguro::AuthorizationRequest.new(options)

data/examples/split_payment/create_payment_request.rb

@@ -0,0 +1,71 @@
+require_relative "../boot"
+
+# Create Split Payment.
+#
+# You need to set your ApplicationCredentials (EMAIL, TOKEN) in the application
+# config.
+#
+# P.S: See the boot file example for more details.
+
+payment = PagSeguro::PaymentRequest.new
+payment.abandon_url = "http://example.com/?abandoned"
+payment.notification_url = "http://example.com/?notification"
+payment.redirect_url = "http://example.com/?redirect"
+
+# If you don't want to use the application config, you can give your credentials
+# object to payment request.
+
+payment.credentials = PagSeguro::ApplicationCredentials.new('APP_ID', 'APP_KEY')
+
+payment.items << {
+  id: 1234,
+  description: %[Televisão 19" Sony],
+  quantity: 1,
+  amount: 459.50,
+  shipping_cost: 0.0,
+  weight: 0
+}
+
+payment.primary_receiver = 'primary.receiver@example.com'
+
+payment.receivers = [
+  {
+    email: 'other.receiver@example.com',
+    split: { amount: '400.00', },
+  }
+]
+
+payment.reference = "REF1234"
+payment.sender = {
+  name: "Sender One",
+  email: "sender@example.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::RequestSerializer.new(payment).to_xml_params
+
+response = payment.register
+
+puts
+puts "=> RESPONSE"
+puts response.url
+puts response.code
+puts response.created_at
+puts response.errors.to_a

data/lib/pagseguro.rb

@@ -9,6 +9,7 @@ require "i18n"
 require "pagseguro/extensions/mass_assignment"
 require "pagseguro/extensions/ensure_type"
 require "pagseguro/extensions/credentiable"
+require "pagseguro/extensions/collection_object"
 
 require "pagseguro/version"
 require "pagseguro/config"
@@ -29,8 +30,14 @@ require "pagseguro/errors"
 require "pagseguro/exceptions"
 require "pagseguro/address"
 require "pagseguro/document"
+require "pagseguro/documents"
 require "pagseguro/shipping"
 require "pagseguro/phone"
+require "pagseguro/phones"
+require "pagseguro/person"
+require "pagseguro/partner"
+require "pagseguro/company"
+require "pagseguro/account"
 require "pagseguro/installment"
 require "pagseguro/installment/collection"
 require "pagseguro/installment/response"
@@ -40,21 +47,21 @@ require "pagseguro/item"
 require "pagseguro/items"
 require "pagseguro/bank"
 require "pagseguro/holder"
-require "pagseguro/document"
 require "pagseguro/payment_method"
 require "pagseguro/payment_release"
 require "pagseguro/payment_releases"
 require "pagseguro/payment_request"
-require "pagseguro/payment_request/serializer"
+require "pagseguro/payment_request/request_serializer"
 require "pagseguro/payment_request/response"
 require "pagseguro/payment_status"
 require "pagseguro/permission"
 require "pagseguro/request"
-require "pagseguro/refund"
-require "pagseguro/refund/request_serializer"
-require "pagseguro/refund/response"
-require "pagseguro/refund/response_serializer"
-require "pagseguro/refund/serializer"
+require "pagseguro/transaction_refund"
+require "pagseguro/transaction_refund/request_serializer"
+require "pagseguro/transaction_refund/response"
+require "pagseguro/transaction_refund/response_serializer"
+require "pagseguro/receiver"
+require "pagseguro/receiver_split"
 require "pagseguro/sender"
 require "pagseguro/session"
 require "pagseguro/session/response"
@@ -72,7 +79,6 @@ require "pagseguro/transaction_cancellation"
 require "pagseguro/transaction_cancellation/request_serializer"
 require "pagseguro/transaction_cancellation/response"
 require "pagseguro/transaction_cancellation/response_serializer"
-require "pagseguro/transaction_cancellation/serializer"
 require "pagseguro/transaction/search"
 require "pagseguro/transaction/search/search_by_date"
 require "pagseguro/transaction/search/search_by_reference"

data/lib/pagseguro/account.rb

@@ -0,0 +1,29 @@
+module PagSeguro
+  class Account
+    include Extensions::MassAssignment
+    include Extensions::EnsureType
+
+    # Set the account e-mail.
+    attr_accessor :email
+
+    # Set the account type.
+    # Must be PERSONAL, SELLER or COMPANY.
+    attr_accessor :type
+
+    # Get the person account.
+    attr_reader :person
+
+    # Get the company account.
+    attr_reader :company
+
+    def person=(person)
+      return if company
+      @person = ensure_type(Person, person)
+    end
+
+    def company=(company)
+      return if person
+      @company = ensure_type(Company, company)
+    end
+  end
+end

data/lib/pagseguro/authorization.rb

@@ -17,7 +17,7 @@ module PagSeguro
 
     # Find an authorization by it's notification code
     def self.find_by_notification_code(code, options = {})
-      request = Request.get("authorizations/notifications/#{code}", "v2", options)
+      request = Request.get("authorizations/notifications/#{code}", api_version, options)
       authorization = PagSeguro::Authorization.new
       Response.new(request, authorization).serialize
 
@@ -26,15 +26,15 @@ module PagSeguro
 
     # Find an authorization by it's code
     def self.find_by_code(code, options = {})
-      request = Request.get("authorizations/#{code}", "v2", options)
+      request = Request.get("authorizations/#{code}", api_version, options)
       authorization = PagSeguro::Authorization.new
       Response.new(request, authorization).serialize
 
       authorization
     end
 
-    def self.find_by_date(options)
-      request = Request.get("authorizations", "v2", RequestSerializer.new(options).to_params)
+    def self.find_by(options)
+      request = Request.get("authorizations", api_version, RequestSerializer.new(options).to_params)
       collection = Collection.new
       Response.new(request, collection).serialize_collection
 
@@ -48,5 +48,11 @@ module PagSeguro
     def errors
       @errors ||= Errors.new
     end
+
+    private
+
+    def self.api_version
+      'v2'
+    end
   end
 end

data/lib/pagseguro/authorization/collection.rb

@@ -3,9 +3,11 @@ module PagSeguro
     class Collection
       extend Forwardable
 
+      attr_writer :authorizations
+
       def_delegators :@authorizations, :each, :empty?, :any?
 
-      def initialize(options)
+      def initialize(options = {})
         @errors = options[:errors] if options[:errors]
         @authorizations = instantiate_authorizations(options[:authorizations])
       end

data/lib/pagseguro/authorization/request_serializer.rb

@@ -3,15 +3,15 @@ module PagSeguro
     class RequestSerializer
       attr_reader :authorization
 
-      def initialize(authorization)
-        @authorization = authorization
+      def initialize(options)
+        @options = options
       end
 
       def to_params
-        params[:credentials] = authorization.credentials if authorization.respond_to? :credentials
-        params[:initialDate] = authorization.initial_date if authorization.respond_to? :initial_date
-        params[:finalDate]   = authorization.final_date if authorization.respond_to? :final_date
-
+        params[:credentials] = @options[:credentials] if @options[:credentials]
+        params[:reference]   = @options[:reference] if @options[:reference]
+        params[:initialDate] = @options[:initial_date].xmlschema if @options[:initial_date]
+        params[:finalDate]   = @options[:final_date].xmlschema if @options[:final_date]
         params
       end
 

data/lib/pagseguro/authorization/response.rb

@@ -29,7 +29,7 @@ module PagSeguro
       end
 
       def success?
-        (response.success? && response.xml?) ? true : false
+        response.success? && response.xml?
       end
 
       private
@@ -41,7 +41,7 @@ module PagSeguro
 
       def serialize_authorizations
         Nokogiri::XML(response.body).css('authorizations > authorization').map do |node|
-          ResponseSerializer.new(node).serialize
+          Authorization.new(ResponseSerializer.new(node).serialize)
         end
       end
     end

data/lib/pagseguro/authorization_request.rb

@@ -1,6 +1,7 @@
 module PagSeguro
   class AuthorizationRequest
     include Extensions::MassAssignment
+    include Extensions::EnsureType
     include Extensions::Credentiable
 
     # The permissions given to the application
@@ -16,6 +17,9 @@ module PagSeguro
     # The url which the application is going to be redirected after the proccess
     attr_accessor :redirect_url
 
+    # The account that can be passed to register suggestion
+    attr_reader :account
+
     # The code used to confirm the authorization
     attr_reader :code
 
@@ -35,10 +39,14 @@ module PagSeguro
       cancels: 'CANCEL_TRANSACTIONS'
     }
 
+    def account=(account)
+      @account = ensure_type(Account, account)
+    end
+
     # Post and create an Authorization.
     # Return Boolean.
     def create
-      request = Request.post('authorizations/request', 'v2', params)
+      request = Request.post_xml('authorizations/request', api_version, credentials, xml)
       response = Response.new(request)
       update_attributes(response.serialize)
 
@@ -47,7 +55,7 @@ module PagSeguro
 
     # URL to confirm authorization after create one.
     def url
-      PagSeguro.site_url("v2/authorization/request.jhtml?code=#{code}") if code
+      PagSeguro.site_url("#{api_version}/authorization/request.jhtml?code=#{code}") if code
     end
 
     def errors
@@ -61,12 +69,16 @@ module PagSeguro
       self.permissions = PERMISSIONS.keys
     end
 
-    def params
-      RequestSerializer.new(self).to_params
+    def xml
+      RequestSerializer.new(self).build_xml
     end
 
     def update_attributes(attrs)
       attrs.each { |method, value| send("#{method}=", value) }
     end
+
+    def api_version
+      'v2'
+    end
   end
 end

data/lib/pagseguro/authorization_request/request_serializer.rb

@@ -1,29 +1,141 @@
 module PagSeguro
   class AuthorizationRequest
     class RequestSerializer
-      attr_reader :authorization_request
 
-      def initialize(authorization_request)
-        @authorization_request = authorization_request
-      end
+      attr_accessor :request
 
-      def to_params
-        params[:credentials] = authorization_request.credentials if authorization_request.credentials
-        params[:notificationURL] = authorization_request.notification_url
-        params[:redirectURL] = authorization_request.redirect_url
-        params[:permissions] = serialize_permissions(authorization_request.permissions)
-        params[:reference] = authorization_request.reference if authorization_request.reference
+      def initialize(request)
+        @request = request
+        @builder = Nokogiri::XML::Builder
+      end
 
-        params
+      def build_xml
+        build.to_xml(save_with:
+          Nokogiri::XML::Node::SaveOptions::NO_EMPTY_TAGS |
+          Nokogiri::XML::Node::SaveOptions::FORMAT
+        )
       end
 
       private
-      def params
-        @params ||= {}
+
+      attr_reader :builder
+
+      def build
+        builder.new(encoding: PagSeguro.encoding) do |xml|
+          xml.send(:authorizationRequest) {
+            xml.send(:reference, request.reference) if request.reference
+            xml.send(:redirectURL, request.redirect_url)
+            xml.send(:notificationURL, request.notification_url)
+            serialize_permissions(xml, request.permissions)
+            serialize_account(xml, request.account)
+          }
+        end
+      end
+
+      def serialize_permissions(xml, permissions)
+        return unless permissions.any?
+        xml.send(:permissions) {
+          format_permissions(permissions).each do |permission|
+            xml.send(:code, permission)
+          end
+        }
+      end
+
+      def format_permissions(permissions)
+        permissions.map { |value| PagSeguro::AuthorizationRequest::PERMISSIONS[value] }
+      end
+
+      def serialize_account(xml, account)
+        return unless account
+
+        xml.send(:account) {
+          xml.send(:email, account.email) if account.email
+          xml.send(:type, account.type) if account.type
+
+          if account.person
+            serialize_person(xml, account.person)
+          elsif account.company
+            serialize_company(xml, account.company)
+          end
+        }
+      end
+
+      def serialize_person(xml, person)
+        return unless person
+
+        xml.send(:person) {
+          xml.send(:name, person.name) if person.name
+          xml.send(:birthDate, person.birth_date.to_s) if person.birth_date
+          serialize_address(xml, person.address)
+          serialize_documents(xml, person.documents)
+          serialize_phones(xml, person.phones)
+        }
+      end
+
+      def serialize_company(xml, company)
+        return unless company
+
+        xml.send(:company) {
+          xml.send(:name, company.name) if company.name
+          xml.send(:displayName, company.display_name) if company.display_name
+          xml.send(:websiteURL, company.website_url) if company.website_url
+          serialize_partner(xml, company.partner)
+          serialize_phones(xml, company.phones)
+          serialize_documents(xml, company.documents)
+          serialize_address(xml, company.address)
+        }
+      end
+
+      def serialize_address(xml, address)
+        return unless address
+
+        xml.send(:address) {
+          xml.send(:postalCode, address.postal_code) if address.postal_code
+          xml.send(:street, address.street) if address.street
+          xml.send(:number, address.number) if address.number
+          xml.send(:complement, address.complement) if address.complement
+          xml.send(:district, address.district) if address.district
+          xml.send(:city, address.city) if address.city
+          xml.send(:state, address.state) if address.state
+          xml.send(:country, address.country) if address.country
+        }
       end
 
-      def serialize_permissions(permissions)
-        permissions.map { |value| PagSeguro::AuthorizationRequest::PERMISSIONS[value] }.join(',')
+      def serialize_phones(xml, phones)
+        return unless phones.any?
+
+        xml.send(:phones) {
+          phones.each do |phone|
+            xml.send(:phone) {
+              xml.send(:type, phone.type)
+              xml.send(:areaCode, phone.area_code)
+              xml.send(:number, phone.number)
+            }
+          end
+        }
+      end
+
+      def serialize_documents(xml, documents)
+        return unless documents.any?
+
+        xml.send(:documents) {
+          documents.each do |document|
+            xml.send(:document) {
+              xml.send(:type, document.type)
+              xml.send(:value, document.value)
+            }
+          end
+        }
+      end
+
+      def serialize_partner(xml, partner)
+        return unless partner
+
+        xml.send(:partner) {
+          xml.send(:name, partner.name) if partner.name
+          xml.send(:birthDate, partner.birth_date.to_s) if partner.birth_date
+          serialize_documents(xml, partner.documents)
+        }
       end
     end
   end