Merge pull request #33 from pagseguro/2.0.7-dev

2.0.7 dev

Author: lucasrenan

README.md

@@ -76,6 +76,13 @@ class CheckoutController < ApplicationController
       }
     end
 
+    # Caso você precise passar parâmetros para a api que ainda não foram
+    # mapeados na gem, você pode fazer de maneira dinâmica utilizando um
+    # simples hash.
+    payment.extra_params << { paramName: 'paramValue' }
+    payment.extra_params << { senderBirthDate: '07/05/1981' }
+    payment.extra_params << { extraAmount: '-15.00' }
+
     response = payment.register
 
     # Caso o processo de checkout tenha dado errado, lança uma exceção.

examples/payment_request.rb

@@ -1,4 +1,4 @@
-# -*- encoding : utf-8 -*- 
+# -*- encoding : utf-8 -*-
 require_relative "boot"
 
 payment = PagSeguro::PaymentRequest.new
@@ -36,6 +36,11 @@
   }
 }
 
+# Add extras params to request
+# payment.extra_params << { paramName: 'paramValue' }
+# payment.extra_params << { senderBirthDate: '07/05/1981' }
+# payment.extra_params << { extraAmount: '-15.00' }
+
 puts "=> REQUEST"
 puts PagSeguro::PaymentRequest::Serializer.new(payment).to_params
 

lib/pagseguro/payment_request.rb

@@ -57,6 +57,8 @@ class PaymentRequest
     # The token that identifies the request. Defaults to PagSeguro.token
     attr_accessor :token
 
+    # The extra parameters for payment request
+    attr_accessor :extra_params
 
     # Products/items in this payment request.
     def items
@@ -84,6 +86,7 @@ def register
 
     private
     def before_initialize
+      self.extra_params = []
       self.currency = "BRL"
       self.email    = PagSeguro.email
       self.token    = PagSeguro.token

lib/pagseguro/payment_request/serializer.rb

@@ -24,6 +24,7 @@ def to_params
 
         serialize_sender(payment_request.sender)
         serialize_shipping(payment_request.shipping)
+        serialize_extra_params(payment_request.extra_params)
 
         params.delete_if {|key, value| value.nil? }
 
@@ -83,6 +84,14 @@ def serialize_address(address)
         params[:shippingAddressComplement] = address.complement
       end
 
+      def serialize_extra_params(extra_params)
+        return unless extra_params
+
+        extra_params.each do |extra_param|
+          params[extra_param.keys.first] = extra_param.values.first
+        end
+      end
+
       def to_amount(amount)
         "%.2f" % BigDecimal(amount.to_s).round(2).to_s("F") if amount
       end

lib/pagseguro/version.rb

@@ -1,3 +1,3 @@
 module PagSeguro
-  VERSION = "2.0.6"
+  VERSION = "2.0.7"
 end

spec/pagseguro/payment_request/serializer_spec.rb

@@ -139,4 +139,18 @@ def build_item(index)
     it_behaves_like "item serialization", 1
     it_behaves_like "item serialization", 2
   end
+
+  context "extra params serialization" do
+    before do
+      payment_request.stub({
+        extra_params: [
+          { extraParam: 'param_value' },
+          { newExtraParam: 'extra_param_value' }
+        ]
+      })
+    end
+
+    it { expect(params).to include(extraParam: 'param_value') }
+    it { expect(params).to include(newExtraParam: 'extra_param_value') }
+  end
 end

spec/pagseguro/payment_request_spec.rb

@@ -104,4 +104,20 @@
       expect(payment.register).to eql(response)
     end
   end
+
+  describe "#extra_params" do
+    it "is empty before initialization" do
+      expect(subject.extra_params).to eql([])
+    end
+
+    it "allows extra parameter addition" do
+      subject.extra_params << { extraParam: 'value' }
+      subject.extra_params << { itemParam1: 'value1' }
+
+      expect(subject.extra_params).to eql([
+        { extraParam: 'value' },
+        { itemParam1: 'value1' }
+      ])
+    end
+  end
 end