pag_seguro 0.1.0

data/.gitignore

@@ -0,0 +1,6 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+coverage/*
+spec/pag_seguro/integration/config.yml

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,10 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in PagSeguro.gemspec
+gemspec
+
+# test gems
+gem 'rspec'
+gem 'simplecov', require: false
+gem 'guard-rspec'
+gem 'growl'

data/Guardfile

@@ -0,0 +1,7 @@
+guard 'rspec', version: 2 do
+  watch(%r{^spec/.+_spec\.rb})
+  watch(%r{^lib/(.+)\.rb})     { |m| "spec/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb') { "spec" }
+  watch('lib/pag_seguro.rb') { "spec" }
+  watch('lib/checkout.xml.haml') { "spec/pag_seguro/checkout_xml_spec.rb" }
+end

data/README.markdown

@@ -0,0 +1,9 @@
+Esta gem foi criada com o intuito de facilitar o uso da versão 2 das APIs do PagSeguro, como pagamento e notificações.
+
+Para exemplos de uso, olhe spec/pag_seguro/integration/checkout_spec.rb
+Para rodar os testes de integração, é necessário alterar os arquivo spec/pag_seguro/integration/config.yml com seu e-mail e token cadastrados no PagSeguro
+
+Desenvolvida por Stefano Diem Benatti e Thiago Colucci (stefano@heavenstudio.com.br, ticolucci@gmail.com)
+
+Obrigado à:
+- Nando Vieira pela gem pagseguro que usei por bastante tempo

data/Rakefile

@@ -0,0 +1 @@
+require 'bundler/gem_tasks'

data/lib/pag_seguro/checkout.xml.haml

@@ -0,0 +1,59 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+%checkout
+  - if payment.id.present?
+    %reference= payment.id
+  - if payment.extra_amount.present?
+    %extraAmount= payment.extra_amount
+  - if payment.redirect_url.present?
+    %redirectUrl= payment.redirect_url
+  - if payment.max_uses.present?
+    %maxUses= payment.max_uses
+  - if payment. max_age.present?
+    %maxAge= payment.max_age
+
+  %currency BRL
+
+  %items
+    - items.each do |item|
+      %item
+        %id= item.id
+        %description= item.description
+        %amount= item.amount
+        %quantity= item.quantity
+        - if item.shipping_cost.present?
+          %shippingCost= item.shipping_cost
+        - if item.weight.present?
+          %weight= item.weight
+
+  - if sender.present?
+    %sender
+      - if sender.name.present?
+        %name= sender.name
+      - if sender.email.present?
+        %email= sender.email
+      %phone
+        - if sender.phone_ddd.present?
+          %areaCode= sender.phone_ddd
+        - if sender.phone_number.present?
+          %number= sender.phone_number
+
+  - if shipping.present?
+    %shipping
+      - if shipping.type.present?
+        %type= shipping.type
+      %address
+        %country BRA
+        - if shipping.state.present?
+          %state= shipping.state
+        - if shipping.city.present?
+          %city= shipping.city
+        - if shipping.postal_code.present?
+          %postalCode= shipping.postal_code
+        - if shipping.district.present?
+          %district= shipping.district
+        - if shipping.street.present?
+          %street= shipping.street
+        - if shipping.number.present?
+          %number= shipping.number
+        - if shipping.complement.present?
+          %complement= shipping.complement

data/lib/pag_seguro/errors/invalid_data.rb

@@ -0,0 +1,12 @@
+module PagSeguro
+  module Errors
+    class InvalidData < Exception
+      def initialize(response_xml)
+        err_msg = Nokogiri::XML(response_xml).css("errors error").inject("") do |acc, node|
+          acc + "#{node.css('code').first.content}: #{node.css('message').first.content}\n"
+        end
+        super(err_msg)
+      end
+    end
+  end
+end

data/lib/pag_seguro/errors/unauthorized.rb

@@ -0,0 +1,9 @@
+module PagSeguro
+  module Errors
+    class Unauthorized < Exception
+      def initialize
+        super("Credentials provided (e-mail and token) failed to authenticate")
+      end
+    end
+  end
+end

data/lib/pag_seguro/errors/unknown_error.rb

@@ -0,0 +1,9 @@
+module PagSeguro
+  module Errors
+    class UnknownError
+      def initialize(response)
+        super("Unknown response code (#{response.code}):\n#{reponse.body}")
+      end
+    end
+  end
+end

data/lib/pag_seguro/item.rb

@@ -0,0 +1,31 @@
+module PagSeguro
+  class Item
+    include ActiveModel::Validations
+    
+    attr_accessor :id, :description, :amount, :quantity, :shipping_cost, :weight
+        
+    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
+    
+    def initialize(attributes = {})
+      @id = attributes[:id]
+      @description = attributes[:description]
+      @amount = attributes[:amount]
+      @quantity = attributes[:quantity]
+      @shipping_cost = attributes[:shipping_cost]
+      @weight = attributes[:weight]
+    end
+    
+    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

data/lib/pag_seguro/notification.rb

@@ -0,0 +1,79 @@
+require 'net/https'
+
+module PagSeguro
+  class Notification
+    attr_accessor :data
+    PAGSEGURO_APPROVED = 3
+    PAGSEGURO_AVAILABLE = 4
+  
+    def initialize(email = nil, token = nil, notification_code=nil)
+      raise "Needs a notification code" if notification_code.blank?
+      raise "Needs an email" if email.blank?
+      raise "Needs a token" if token.blank?
+      @data = Nokogiri::XML(notification_data(email, token, notification_code))
+    end
+      
+    def status
+      @data.css("status").first.content.to_i
+    end
+  
+    def approved?
+      PAGSEGURO_APPROVED == status
+    end
+    
+    def available?
+      PAGSEGURO_AVAILABLE == status
+    end
+  
+    def id
+      @data.css("reference").first.content
+    end
+    
+    def transaction_id
+      @data.css("code").first.content
+    end
+  
+    def items
+      @data.css("items item").map do |i|
+        Item.new(id: parse_item(i, "id"), description: parse_item(i, "description"), quantity: parse_item(i, "quantity"), amount: parse_item(i, "amount"))
+      end
+    end
+    
+    def sender
+      sn = Sender.new
+      sn.name = parse_css("sender name")
+      sn.email = parse_css("sender email")
+      sn.phone_ddd = parse_css("sender phone areaCode")
+      sn.phone_number = parse_css("sender phone number")
+      sn
+    end
+    
+    def shipping
+      sh = Shipping.new
+      sh.type = parse_css("shipping type")
+      sh.cost = parse_css("shipping cost")
+      sh.state = parse_css("shipping address state")
+      sh.city = parse_css("shipping address city")
+      sh.postal_code = parse_css("shipping address postalCode")
+      sh.district = parse_css("shipping address district")
+      sh.street = parse_css("shipping address street")
+      sh.number = parse_css("shipping address number")
+      sh.complement = parse_css("shipping address complement")
+      sh
+    end
+    
+    private
+      def notification_data(email, token, notification_code)
+        RestClient.get("https://ws.pagseguro.uol.com.br/v2/transactions/notifications/#{notification_code}?email=#{email}&token=#{token}")
+      end
+
+      def parse_item(data, attribute)
+        data.css(attribute).first.content
+      end
+      
+      def parse_css(selector)
+        value = @data.css(selector).first
+        value.nil? ? nil : value.content
+      end      
+  end
+end

data/lib/pag_seguro/payment.rb

@@ -0,0 +1,64 @@
+module PagSeguro
+  class Payment
+    include ActiveModel::Validations
+        
+    attr_accessor :id, :email, :token, :items, :sender, :shipping, :extra_amount, :redirect_url, :max_uses, :max_age
+    
+    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_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
+    
+    def initialize(email = nil, token = nil, options = {})
+      @email        = email unless email.nil?
+      @token        = token unless token.nil?
+      @id           = options[:id]
+      @sender       = options[:sender] || Sender.new
+      @shipping     = options[:shipping] || Shipping.new
+      @items        = options[:items] || []
+      @extra_amount = options[:extra_amount]
+      @redirect_url = options[:redirect_url]
+      @max_uses     = options[:max_uses]
+      @max_age      = options[:max_age]
+    end
+    
+    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)
+    end
+    
+    def checkout_url_with_params
+      "https://ws.pagseguro.uol.com.br/v2/checkout?email=#{@email}&token=#{@token}"
+    end
+    
+    def checkout_payment_url
+      "https://pagseguro.uol.com.br/v2/checkout/payment.html?code=#{code}"
+    end
+    
+    def code
+      response = send_checkout
+      if response.code == 200
+        Nokogiri::XML(response.body).css("checkout code").first.content
+      elsif response.code == 401
+        raise Errors::Unauthorized
+      elsif response.code == 400
+        raise Errors::InvalidData.new(response.body)
+      else
+        raise Errors::UnknownError.new(response)
+      end
+    end
+    
+    protected
+      def max_uses_number
+        errors.add(:max_uses, " must be an integer greater than 0") if @max_uses.present? && @max_uses.to_i <= 0
+      end
+      
+      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 send_checkout
+        RestClient.post(checkout_url_with_params, checkout_xml, content_type: "application/xml"){|response, request, result| response }
+      end
+  end
+end

data/lib/pag_seguro/sender.rb

@@ -0,0 +1,32 @@
+module PagSeguro
+  class Sender
+    attr_accessor :name, :email, :phone_ddd, :phone_number
+    
+    def initialize(options = {})
+      @name         = options[:name]
+      @email        = options[:email]
+      @phone_ddd    = options[:phone_ddd]
+      @phone_number = options[:phone_number]
+    end
+    
+    def email
+      valid_email? ? @email : nil
+    end
+
+    def valid_email?
+      @email =~ /\A([^@\s]+)@((?:[-a-z0-9]+\.)+[a-z]{2,})\Z/i && @email.size <= 60
+    end
+    
+    def name
+      ( @name.present? && @name.size > 50 ) ? @name[0..49] : @name
+    end
+    
+    def phone_ddd
+      @phone_ddd if @phone_ddd =~ /^\d{2}$/
+    end
+    
+    def phone_number
+      @phone_number if @phone_number =~/^\d{8}$/
+    end
+  end
+end

data/lib/pag_seguro/shipping.rb

@@ -0,0 +1,29 @@
+module PagSeguro
+  class Shipping
+    include ActiveModel::Validations
+    
+    PAC = 1
+    SEDEX = 2
+    NOT_IDENTIFIED = 3
+    
+    validates_format_of :postal_code, with: /^\d{8}$/, message: " must be an integer with 8 digits", allow_blank: true
+    
+    attr_accessor :type, :state, :city, :postal_code, :district, :street, :number, :complement, :cost
+    
+    def initialize(attributes = {})
+      @type = attributes[:type]
+      @state = attributes[:state]
+      @city = attributes[:city]
+      @postal_code = attributes[:postal_code]
+      @district = attributes[:district]
+      @street = attributes[:street]
+      @number = attributes[:number]
+      @complement = attributes[:complement]
+      @cost = attributes[:cost]
+    end
+    
+    def postal_code
+      @postal_code if @postal_code.present? && @postal_code.to_s.size == 8
+    end
+  end
+end

data/lib/pag_seguro/version.rb

@@ -0,0 +1,3 @@
+module PagSeguro
+  VERSION = "0.1.0"
+end

data/lib/pag_seguro.rb

@@ -0,0 +1,25 @@
+$: << "lib/pag_seguro"
+
+# Third party gems
+require "active_model"
+require "nokogiri"
+require "haml"
+require "rest-client"
+
+# PagSeguro classes
+require "item"
+require "payment"
+require "sender"
+require "shipping"
+require "notification"
+
+# Error classes
+require "errors/unauthorized"
+require "errors/invalid_data"
+require "errors/unknown_error"
+
+# Version
+require "version"
+
+module PagSeguro
+end

data/pag_seguro.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "pag_seguro/version"
+
+Gem::Specification.new do |s|
+  s.platform    = Gem::Platform::RUBY
+  s.name        = "pag_seguro"
+  s.version     = PagSeguro::VERSION
+  s.authors     = ["Stefano Diem Benatti"]
+  s.email       = ["stefano.diem@gmail.com"]
+  s.homepage    = "http://github.com/heavenstudio/pag_seguro"
+  s.summary     = %q{A ruby gem to handle PagSeguro's API version 2}
+  s.required_ruby_version = '>= 1.9.2'
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+  s.has_rdoc      = false
+  
+  s.add_dependency('activemodel')
+  s.add_dependency('haml')
+  s.add_dependency('nokogiri')
+  s.add_dependency('rest-client', '~> 1.6.7')
+end

data/spec/pag_seguro/checkout_xml_spec.rb

@@ -0,0 +1,176 @@
+# encoding: utf-8
+require 'spec_helper'
+
+items = [
+  PagSeguro::Item.new(id: 25, description: "A Bic Pen", amount: "1.50",  quantity: "4", shipping_cost: "1.00",  weight: 10),
+  PagSeguro::Item.new(id: 73, description: "A Book",    amount: "38.23", quantity: "1", shipping_cost: "12.00", weight: 300),
+  PagSeguro::Item.new(id: 95, description: "A Towel",   amount: "69.35", quantity: "2", weight: 400),
+  PagSeguro::Item.new(id: 17, description: "A pipe",    amount: "3.00",  quantity: "89")
+]
+
+sender_info = {name: "Stefano Diem Benatti", email: "stefano@heavenstudio.com.br", phone_ddd: "11", phone_number: "93430994"}
+
+shipping_info = {type: PagSeguro::Shipping::SEDEX, state: "SP", city: "São Paulo", postal_code: "05363000",
+  district: "Jd. PoliPoli", street: "Av. Otacilio Tomanik", number: "775", complement: "apto. 92"}
+
+
+describe PagSeguro::Payment do
+  context "checkout_xml" do
+    before { @payment = PagSeguro::Payment.new }
+    
+    it "should be a valid xml" do
+      lambda { Nokogiri::XML(@payment.checkout_xml) { |config| config.options = Nokogiri::XML::ParseOptions::STRICT } }.should_not raise_error
+    end
+    
+    it "should have encoding UTF-8" do
+      @payment.checkout_xml.should match(/^<\?xml.+encoding="UTF-8".+\?>$/)
+    end
+    
+    it "should have currency BRL" do
+      Nokogiri::XML(@payment.checkout_xml).css("checkout currency").first.content.should == "BRL"
+    end
+    
+    context "items" do
+      before do
+        @payment.items = items
+        @xml = Nokogiri::XML(@payment.checkout_xml)
+      end
+
+      it "should have 4 items" do
+        @xml.css("checkout items item").size.should == 4
+      end
+      
+      it "should show all ids" do
+        @xml.css("checkout items item id").map(&:content).should == ["25","73","95","17"]
+      end
+      
+      it "should show all descriptions" do
+        @xml.css("checkout items item description").map(&:content).should == ["A Bic Pen","A Book","A Towel","A pipe"]
+      end
+      
+      it "should show all amounts" do
+        @xml.css("checkout items item amount").map(&:content).should == ["1.50","38.23","69.35","3.00"]
+      end
+
+      it "should show all quantities" do
+        @xml.css("checkout items item quantity").map(&:content).should == ["4","1","2","89"]
+      end
+      
+      it "should show all shipping_costs" do
+        @xml.css("checkout items item shippingCost").map(&:content).should == ["1.00","12.00"]
+      end
+
+      it "should show all weights" do
+        @xml.css("checkout items item weight").map(&:content).should == ["10","300","400"]
+      end
+    end
+    
+    context "sender info" do
+      before do
+        @xml_without_sender_info = Nokogiri::XML(@payment.checkout_xml)
+        @payment.sender = PagSeguro::Sender.new(sender_info)
+        @xml = Nokogiri::XML(@payment.checkout_xml)
+      end
+      
+      it "should have sender name" do
+        @xml_without_sender_info.css("checkout sender name").should be_empty
+        @xml.css("checkout sender name").first.content.should == "Stefano Diem Benatti"
+      end
+
+      it "should have sender email" do
+        @xml_without_sender_info.css("checkout sender email").should be_empty
+        @xml.css("checkout sender email").first.content.should == "stefano@heavenstudio.com.br"
+      end
+
+      it "should have sender phone ddd" do
+        @xml_without_sender_info.css("checkout sender phone areaCode").should be_empty
+        @xml.css("checkout sender phone areaCode").first.content.should == "11"
+      end
+
+      it "should have sender phone number" do
+        @xml_without_sender_info.css("checkout sender phone number").should be_empty
+        @xml.css("checkout sender phone number").first.content.should == "93430994"
+      end
+    end
+    
+    context "shipping" do
+      before do
+        @xml_without_shipping_info = Nokogiri::XML(@payment.checkout_xml)
+        @payment.shipping = PagSeguro::Shipping.new(shipping_info)
+        @xml = Nokogiri::XML(@payment.checkout_xml)
+      end
+      
+      it "should have shipping type" do
+        @xml_without_shipping_info.css("checkout shipping type").should be_empty
+        @xml.css("checkout shipping type").first.content.to_i.should == PagSeguro::Shipping::SEDEX
+      end
+
+      it "should have state" do
+        @xml_without_shipping_info.css("checkout shipping address state").should be_empty
+        @xml.css("checkout shipping address state").first.content.should == "SP"
+      end
+
+      it "should have city" do
+        @xml_without_shipping_info.css("checkout shipping address city").should be_empty
+        @xml.css("checkout shipping address city").first.content.should == "São Paulo"
+      end
+
+      it "should have posta code" do
+        @xml_without_shipping_info.css("checkout shipping address postalCode").should be_empty
+        @xml.css("checkout shipping address postalCode").first.content.should == "05363000"
+      end
+
+      it "should have district" do
+        @xml_without_shipping_info.css("checkout shipping address district").should be_empty
+        @xml.css("checkout shipping address district").first.content.should == "Jd. PoliPoli"
+      end
+
+      it "should have street" do
+        @xml_without_shipping_info.css("checkout shipping address street").should be_empty
+        @xml.css("checkout shipping address street").first.content.should == "Av. Otacilio Tomanik"
+      end
+
+      it "should have number" do
+        @xml_without_shipping_info.css("checkout shipping address number").should be_empty
+        @xml.css("checkout shipping address number").first.content.should == "775"
+      end
+
+      it "should have complement" do
+        @xml_without_shipping_info.css("checkout shipping address complement").should be_empty
+        @xml.css("checkout shipping address complement").first.content.should == "apto. 92"
+      end
+    end
+    
+    context "payment settings" do
+      it "should not show id unless specified" do
+        Nokogiri::XML(@payment.checkout_xml).css("checkout reference").should be_empty
+        @payment.id = 305
+        Nokogiri::XML(@payment.checkout_xml).css("checkout reference").first.content.should == "305"
+      end
+      
+      it "should not show extra amount unless specified" do
+        Nokogiri::XML(@payment.checkout_xml).css("checkout extraAmount").should be_empty
+        @payment.extra_amount = "10.50"
+        Nokogiri::XML(@payment.checkout_xml).css("checkout extraAmount").first.content.should == "10.50"
+      end
+      
+      it "should not show redirect url unless specified" do
+        Nokogiri::XML(@payment.checkout_xml).css("checkout redirectUrl").should be_empty
+        @payment.redirect_url = "http://heavenstudio.com.br"
+        Nokogiri::XML(@payment.checkout_xml).css("checkout redirectUrl").first.content.should == "http://heavenstudio.com.br"
+      end
+      
+      it "should not show max uses unless specified" do
+        Nokogiri::XML(@payment.checkout_xml).css("checkout maxUses").should be_empty
+        @payment.max_uses = "10"
+        Nokogiri::XML(@payment.checkout_xml).css("checkout maxUses").first.content.should == "10"
+      end
+      
+      it "should not show max age unless specified" do
+        Nokogiri::XML(@payment.checkout_xml).css("checkout maxAge").should be_empty
+        @payment.max_age = "5000"
+        Nokogiri::XML(@payment.checkout_xml).css("checkout maxAge").first.content.should == "5000"
+      end
+    end
+  end
+end

data/spec/pag_seguro/integration/checkout_spec.rb

@@ -0,0 +1,41 @@
+# encoding: utf-8
+require 'spec_helper'
+
+config = YAML.load_file(File.dirname(__FILE__) + "/config.yml")
+EMAIL = config["email"]
+TOKEN = config["token"]
+
+def create_valid_payment
+  payment = PagSeguro::Payment.new(EMAIL, TOKEN)
+  payment.items = [
+    PagSeguro::Item.new(id: 25, description: "A Bic Pen", amount: "1.50",  quantity: "4", shipping_cost: "1.00",  weight: 10),
+    PagSeguro::Item.new(id: 73, description: "A Book",    amount: "38.23", quantity: "1", shipping_cost: "12.00", weight: 300),
+    PagSeguro::Item.new(id: 95, description: "A Towel",   amount: "69.35", quantity: "2", weight: 400),
+    PagSeguro::Item.new(id: 17, description: "A pipe",    amount: "3.00",  quantity: "89")
+  ]
+  payment.sender = PagSeguro::Sender.new(name: "Stefano Diem Benatti", email: "stefano@heavenstudio.com.br", phone_ddd: "11", phone_number: "93430994")
+  payment.shipping = PagSeguro::Shipping.new(type: PagSeguro::Shipping::SEDEX, state: "SP", city: "São Paulo", postal_code: "05363000", district: "Jd. PoliPoli", street: "Av. Otacilio Tomanik", number: "775", complement: "apto. 92")
+  payment
+end
+
+describe "PagSeguro::Payment.code" do
+  it "should send a request to pagseguro" do
+    payment = create_valid_payment
+    payment.code.size.should == 32
+  end
+  
+  it "should tell me when the email and token are invalid" do
+    payment = PagSeguro::Payment.new("not_a_user@not_an_email.com", "NOTATOKEN7F048A09A8AEFDD1E5A7B91")
+    lambda { payment.code }.should raise_error(PagSeguro::Errors::Unauthorized)
+  end
+    
+  it "should list errors given by pagseguro" do
+    payment = PagSeguro::Payment.new(EMAIL, TOKEN)
+    lambda { payment.code }.should raise_error(PagSeguro::Errors::InvalidData)
+  end
+  
+  it "should give a response code of 200 for the user pagseguro url" do
+    payment = create_valid_payment
+    RestClient.get(payment.checkout_payment_url).code.should == 200
+  end
+end

data/spec/pag_seguro/integration/config.yml

@@ -0,0 +1,2 @@
+email: billing@heavenstudio.com.br
+token: 97392F4047F048A09A8AEFDD1E5A7B91

data/spec/pag_seguro/item_spec.rb

@@ -0,0 +1,79 @@
+require "spec_helper"
+
+valid_attributes = {
+  id: 1,
+  description: "descrevendo um item",
+  amount: "100.50",
+  quantity: 1,
+  shipping_cost: "10.50",
+  weight: 300
+}
+
+describe PagSeguro::Item do
+  context "instance" do
+    before { @item = PagSeguro::Item.new }
+
+    it { @item.should have_attribute_accessor(:id) }
+    it { @item.should have_attribute_accessor(:description) }
+    it { @item.should have_attribute_accessor(:amount) }
+    it { @item.should have_attribute_accessor(:quantity) }
+    it { @item.should have_attribute_accessor(:shipping_cost) }
+    it { @item.should have_attribute_accessor(:weight) }
+
+    it "should be valid with valid attributes" do
+      PagSeguro::Item.new(valid_attributes).should be_valid
+    end
+
+    it "should not be valid without an id" do
+      PagSeguro::Item.new(valid_attributes.except(:id)).should_not be_valid
+    end
+
+    it "should not be valid without a description" do
+      PagSeguro::Item.new(valid_attributes.except(:description)).should_not be_valid
+    end
+
+    it "should trim description to 100 characters if it has more than 100 characters" do
+      item = PagSeguro::Item.new(valid_attributes)
+      item.description = "-" * 100
+      item.description.size.should == 100
+      item.should be_valid
+      item.description = "-" * 101
+      item.description.size.should == 100
+      item.should be_valid
+    end
+
+    it "should not be valid without an amount" do
+      PagSeguro::Item.new(valid_attributes.except(:amount)).should_not be_valid
+    end
+
+    it "should not allow invalid amount formats" do
+      PagSeguro::Item.new(valid_attributes.merge(amount: "10")).should_not be_valid
+      PagSeguro::Item.new(valid_attributes.merge(amount: "10,50")).should_not be_valid
+      PagSeguro::Item.new(valid_attributes.merge(amount: "R$ 10.50")).should_not be_valid
+      PagSeguro::Item.new(valid_attributes.merge(amount: "-10.50")).should_not be_valid
+    end
+
+    it "should not be valid without a quantity" do
+      PagSeguro::Item.new(valid_attributes.except(:quantity)).should_not be_valid
+    end
+
+    it "should not allow invalid quantities" do
+      PagSeguro::Item.new(valid_attributes.merge(quantity: "1000")).should_not be_valid
+      PagSeguro::Item.new(valid_attributes.merge(quantity: "0")).should_not be_valid
+      PagSeguro::Item.new(valid_attributes.merge(quantity: "-1")).should_not be_valid
+    end
+
+    it "should not allow invalid shipping_cost formats" do
+      PagSeguro::Item.new(valid_attributes.merge(shipping_cost: "10")).should_not be_valid
+      PagSeguro::Item.new(valid_attributes.merge(shipping_cost: "10,50")).should_not be_valid
+      PagSeguro::Item.new(valid_attributes.merge(shipping_cost: "R$ 10.50")).should_not be_valid
+      PagSeguro::Item.new(valid_attributes.merge(shipping_cost: "-10.50")).should_not be_valid
+    end
+    
+    it "should not allow non integer values for weight" do
+      PagSeguro::Item.new(valid_attributes.merge(weight: "-10")).should_not be_valid
+      PagSeguro::Item.new(valid_attributes.merge(weight: "10.5")).should_not be_valid
+      PagSeguro::Item.new(valid_attributes.merge(weight: "10,5")).should_not be_valid
+    end
+  end
+end

data/spec/pag_seguro/notification_data_mock.rb

@@ -0,0 +1,64 @@
+# encoding: utf-8
+module PagSeguro
+  class Notification
+    def notification_data(email, token, notification_code)
+      <<-XML
+        <?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?>  
+        <transaction>  
+          <date>2011-02-10T16:13:41.000-03:00</date>  
+          <code>9E884542-81B3-4419-9A75-BCC6FB495EF1</code>  
+          <reference>REF1234</reference>  
+          <type>1</type>  
+          <status>3</status>  
+          <paymentMethod>  
+            <type>1</type>  
+            <code>101</code>  
+          </paymentMethod>  
+          <grossAmount>49900.00</grossAmount>  
+          <discountAmount>0.00</discountAmount>  
+          <feeAmount>0.00</feeAmount>  
+          <netAmount>49900.00</netAmount>  
+          <extraAmount>0.00</extraAmount>  
+          <installmentCount>1</installmentCount>  
+          <itemCount>2</itemCount>  
+          <items>  
+            <item>  
+              <id>0001</id>  
+              <description>Notebook Prata</description>  
+              <quantity>1</quantity>  
+              <amount>24300.00</amount>  
+            </item>  
+            <item>  
+              <id>0002</id>  
+              <description>Notebook Rosa</description>  
+              <quantity>1</quantity>  
+              <amount>25600.00</amount>  
+            </item>  
+          </items>  
+          <sender>  
+            <name>José Comprador</name>  
+            <email>comprador@uol.com.br</email>  
+            <phone>  
+              <areaCode>11</areaCode>  
+              <number>56273440</number>  
+            </phone>  
+          </sender>  
+          <shipping>  
+            <address>  
+              <street>Av. Brig. Faria Lima</street>  
+              <number>1384</number>  
+              <complement>5o andar</complement>  
+              <district>Jardim Paulistano</district>  
+              <postalCode>01452002</postalCode>  
+              <city>Sao Paulo</city>  
+              <state>SP</state>  
+              <country>BRA</country>  
+            </address>  
+            <type>1</type>  
+            <cost>21.50</cost>  
+          </shipping>  
+        </transaction> 
+      XML
+    end
+  end
+end

data/spec/pag_seguro/notification_spec.rb

@@ -0,0 +1,58 @@
+# encoding: utf-8
+
+require 'spec_helper'
+require_relative 'notification_data_mock'
+
+describe PagSeguro::Notification do
+  before do
+    @notification = PagSeguro::Notification.new("mail", "token", "not_code")
+  end
+  
+  it "should have an id" do
+    @notification.id.should == "REF1234"
+  end
+  
+  it "should have a transaction id" do
+    @notification.transaction_id.should == "9E884542-81B3-4419-9A75-BCC6FB495EF1"
+  end
+  
+  it "should be approved in this case" do
+    @notification.should be_approved
+  end
+  
+  it "should have a sender" do
+    @sender = @notification.sender
+    @sender.name.should == "José Comprador"
+    @sender.email.should == "comprador@uol.com.br"
+    @sender.phone_ddd.should == "11"
+    @sender.phone_number == "56273440"
+  end
+  
+  it "should have a shipping" do
+    @shipping = @notification.shipping
+    @shipping.type.should == "1"
+    @shipping.cost.should == "21.50"
+    @shipping.state.should == "SP"
+    @shipping.city.should == "Sao Paulo"
+    @shipping.postal_code.should == "01452002"
+    @shipping.district.should == "Jardim Paulistano"
+    @shipping.street.should == "Av. Brig. Faria Lima"
+    @shipping.number.should == "1384"
+    @shipping.complement.should == "5o andar"
+  end
+  
+  it "should have items" do
+    @items = @notification.items
+    @items.size.should == 2
+
+    @items[0].id.should == "0001"
+    @items[0].description.should == "Notebook Prata"
+    @items[0].quantity.should == "1"
+    @items[0].amount.should == "24300.00"
+
+    @items[1].id.should == "0002"
+    @items[1].description.should == "Notebook Rosa"
+    @items[1].quantity.should == "1"
+    @items[1].amount.should == "25600.00"
+  end
+end

data/spec/pag_seguro/payment_spec.rb

@@ -0,0 +1,94 @@
+require 'spec_helper'
+
+describe PagSeguro::Payment do
+  context "instance" do
+    context "accessors" do
+      before { @payment = PagSeguro::Payment.new }
+      
+      it { @payment.should have_attribute_accessor(:id) }
+      it { @payment.should have_attribute_accessor(:items) }
+      it { @payment.should have_attribute_accessor(:sender) }
+      it { @payment.should have_attribute_accessor(:shipping) }
+      it { @payment.should have_attribute_accessor(:email) }
+      it { @payment.should have_attribute_accessor(:token) }
+      it { @payment.should have_attribute_accessor(:extra_amount) }
+      it { @payment.should have_attribute_accessor(:redirect_url) }
+      it { @payment.should have_attribute_accessor(:max_uses) }
+      it { @payment.should have_attribute_accessor(:max_age) }
+
+      it "should have items" do
+        @payment.items.should be_instance_of(Array)
+        @payment.items.should be_empty
+      end
+
+      it "should have a sender" do
+        @payment.sender.should be_instance_of(PagSeguro::Sender)
+      end
+    end
+        
+    it "should allow to set email and token initialization" do
+      payment = PagSeguro::Payment.new("mymail", "mytoken")
+      payment.email.should == "mymail"
+      payment.token.should == "mytoken"
+    end
+    
+    context "validation" do
+      before { @payment = PagSeguro::Payment.new("mymail", "mytoken") }
+      it "should be valid with valid attributes" do
+        @payment.should be_valid
+      end
+      
+      it "should not be valid without email" do
+        @payment.email = nil
+        @payment.should_not be_valid
+      end
+
+      it "should not be valid without token" do
+        @payment.token = nil
+        @payment.should_not be_valid
+      end
+      
+      it "should not be valid with invalid extra amount format" do
+        @payment.extra_amount = "10,50"
+        @payment.should_not be_valid
+        @payment.extra_amount = "R$ 10.50"
+        @payment.should_not be_valid
+        @payment.extra_amount = "10.50"
+        @payment.should be_valid
+      end
+      
+      it "should not allow invalid urls" do
+        @payment.redirect_url = "httd://something"
+        @payment.should_not be_valid
+        @payment.redirect_url = "http://heavenstudio.com.br"
+        @payment.should be_valid
+      end
+      
+      it "should not allow an invalid number of uses" do
+        @payment.max_uses = "0"
+        @payment.should_not be_valid
+        @payment.max_uses = "10"
+        @payment.should be_valid
+      end
+      
+      it "should not allow an invalid second time" do
+        @payment.max_age = "29"
+        @payment.should_not be_valid
+        @payment.max_age = "30"
+        @payment.should be_valid
+      end
+    end
+  end
+  
+  context "checking out" do
+    it "should have a checkout_url_with_params" do
+      PagSeguro::Payment.new("mymail", "mytoken").checkout_url_with_params.should == 'https://ws.pagseguro.uol.com.br/v2/checkout?email=mymail&token=mytoken'
+    end
+    
+    it "should generate a checkout url based on the received response" do
+      payment = PagSeguro::Payment.new("mymail", "mytoken")
+      payment.stub(:code).and_return("aabbcc")
+      payment.checkout_payment_url.should == "https://pagseguro.uol.com.br/v2/checkout/payment.html?code=aabbcc"
+    end
+  end
+end

data/spec/pag_seguro/sender_spec.rb

@@ -0,0 +1,60 @@
+require "spec_helper"
+
+describe PagSeguro::Sender do
+  context "instance" do
+    before { @sender = PagSeguro::Sender.new }
+    
+    it "should have an email accessor" do
+      @sender.should have_attribute_accessor(:email)
+    end
+    
+    it "should have a name accessor" do
+      @sender.should have_attribute_accessor(:name)
+    end
+
+    it "should have a phone_ddd accessor" do
+      @sender.should have_attribute_accessor(:phone_ddd)
+    end
+
+    it "should have a phone_number" do
+      @sender.should have_attribute_accessor(:phone_number)
+    end
+    
+    it "should be able to initialize with all attributes" do
+      sender = PagSeguro::Sender.new(name: "Stefano Diem Benatti", email: "stefano@heavenstudio.com.br", phone_ddd: "11", phone_number: "93430994")
+      sender.name.should == "Stefano Diem Benatti"
+      sender.email.should == "stefano@heavenstudio.com.br"
+      sender.phone_ddd.should == "11"
+      sender.phone_number.should == "93430994"
+    end
+    
+    it "should tell valid e-mail appart" do
+      @sender.email = "nothing"
+      @sender.should_not be_a_valid_email
+      @sender.email = ("a" * 50) + "waytoolongemail@mail.com"
+      @sender.should_not be_a_valid_email
+      @sender.email = "stefano@heavenstudio.com.br"
+      @sender.should be_a_valid_email
+    end
+    
+    it "should not show invalid e-mail" do
+      @sender.email = "nothing"
+      @sender.email.should be_nil
+    end
+    
+    it "should crop the name if it is too big" do
+      @sender.name = "a" * 50 + "b" * 10
+      @sender.name.should == "a" * 50
+    end
+    
+    it "should not show invalid phone ddd's" do
+      @sender.phone_ddd = "111"
+      @sender.phone_ddd.should be_nil
+    end
+    
+    it "should not show invalid phone number" do
+      @sender.phone_number = "1234567"
+      @sender.phone_number.should be_nil
+    end
+  end
+end

data/spec/pag_seguro/shipping_spec.rb

@@ -0,0 +1,36 @@
+# encoding: utf-8
+require "spec_helper"
+
+valid_attributes = {
+  type: PagSeguro::Shipping::SEDEX,
+  state: "SP",
+  city: "São Paulo",
+  postal_code: "05363000",
+  district: "Jd. PoliPoli",
+  street: "Av. Otacilio Tomanik",
+  number: "775",
+  complement: "apto. 92"
+}
+
+describe PagSeguro::Shipping do
+  context "instance" do
+    before { @shipping = PagSeguro::Shipping.new }
+    it { @shipping.should have_attribute_accessor(:type) }
+    it { @shipping.should have_attribute_accessor(:state) }
+    it { @shipping.should have_attribute_accessor(:city) }
+    it { @shipping.should have_attribute_accessor(:postal_code) }
+    it { @shipping.should have_attribute_accessor(:district) }
+    it { @shipping.should have_attribute_accessor(:street) }
+    it { @shipping.should have_attribute_accessor(:number) }
+    it { @shipping.should have_attribute_accessor(:complement) }
+  end
+  
+  it "should be able to initialize all attributes" do
+    PagSeguro::Shipping.new(valid_attributes).should be_valid
+  end
+  
+  it "should not show postal code unless valid" do
+    PagSeguro::Shipping.new(valid_attributes).postal_code.should == "05363000"
+    PagSeguro::Shipping.new(valid_attributes.merge(postal_code: 1234567)).postal_code.should be_blank
+  end
+end

data/spec/pag_seguro/version_spec.rb

@@ -0,0 +1,7 @@
+require 'spec_helper'
+
+describe PagSeguro do
+  it "should have a version" do
+    PagSeguro::VERSION.should_not be_empty
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,31 @@
+require 'simplecov'
+SimpleCov.start do
+  add_filter "spec/"
+end
+
+require 'yaml'
+require File.dirname(__FILE__) + "/../lib/pag_seguro"
+
+class HaveAttributeAccessor
+  def initialize(attribute)
+    @attribute = attribute
+  end
+  
+  def matches?(target)
+    @target = target
+    @target.respond_to?(:"#{@attribute}").should == true
+    @target.respond_to?(:"#{@attribute}=").should == true
+  end
+  
+  def failure_message
+    "expected #{@target.inspect} to have '#{@expected}' attribute accessor"
+  end
+  
+  def negative_failure_message
+    "expected #{@target.inspect} not to have '#{@expected}' attribute accessor"
+  end
+end
+
+def have_attribute_accessor(attribute)
+  HaveAttributeAccessor.new(attribute)
+end

metadata

@@ -0,0 +1,138 @@
+--- !ruby/object:Gem::Specification 
+name: pag_seguro
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Stefano Diem Benatti
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-01-24 00:00:00 -02:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: activemodel
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: haml
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: nokogiri
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: rest-client
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.6.7
+  type: :runtime
+  version_requirements: *id004
+description: 
+email: 
+- stefano.diem@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .rspec
+- Gemfile
+- Guardfile
+- README.markdown
+- Rakefile
+- lib/pag_seguro.rb
+- lib/pag_seguro/checkout.xml.haml
+- lib/pag_seguro/errors/invalid_data.rb
+- lib/pag_seguro/errors/unauthorized.rb
+- lib/pag_seguro/errors/unknown_error.rb
+- lib/pag_seguro/item.rb
+- lib/pag_seguro/notification.rb
+- lib/pag_seguro/payment.rb
+- lib/pag_seguro/sender.rb
+- lib/pag_seguro/shipping.rb
+- lib/pag_seguro/version.rb
+- pag_seguro.gemspec
+- spec/pag_seguro/checkout_xml_spec.rb
+- spec/pag_seguro/integration/checkout_spec.rb
+- spec/pag_seguro/integration/config.yml
+- spec/pag_seguro/item_spec.rb
+- spec/pag_seguro/notification_data_mock.rb
+- spec/pag_seguro/notification_spec.rb
+- spec/pag_seguro/payment_spec.rb
+- spec/pag_seguro/sender_spec.rb
+- spec/pag_seguro/shipping_spec.rb
+- spec/pag_seguro/version_spec.rb
+- spec/spec_helper.rb
+has_rdoc: false
+homepage: http://github.com/heavenstudio/pag_seguro
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: 1.9.2
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: A ruby gem to handle PagSeguro's API version 2
+test_files: 
+- spec/pag_seguro/checkout_xml_spec.rb
+- spec/pag_seguro/integration/checkout_spec.rb
+- spec/pag_seguro/integration/config.yml
+- spec/pag_seguro/item_spec.rb
+- spec/pag_seguro/notification_data_mock.rb
+- spec/pag_seguro/notification_spec.rb
+- spec/pag_seguro/payment_spec.rb
+- spec/pag_seguro/sender_spec.rb
+- spec/pag_seguro/shipping_spec.rb
+- spec/pag_seguro/version_spec.rb
+- spec/spec_helper.rb