baby-braspag 0.1.3

data/.gitignore

@@ -0,0 +1,9 @@
+nbproject
+pkg
+doc
+tags
+*.sw*
+.bundle
+.rvmrc
+Gemfile.lock
+

data/.rspec

@@ -0,0 +1 @@
+--colour

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in rbraspag.gemspec
+gemspec

data/Guardfile

@@ -0,0 +1,10 @@
+guard 'bundler' do
+  watch('Gemfile')
+end
+
+guard 'rspec', :version => 2, :bundler => false do
+  watch(%r{^spec/(.*)_spec\.rb$})
+  watch(%r{^lib/rbraspag.rb$})                       { "spec" }
+  watch(%r{^lib/rbraspag/(.*)\.rb$})                 { |m| "spec/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')                       { "spec" }
+end

data/README.md

@@ -0,0 +1,60 @@
+# Baby Braspag
+
+baby-braspag gem to use Braspag gateway
+
+* This gem need RACK_ENV environment variable to identify the environment
+
+# How to install
+
+## for Rails 3 app
+
+### Add on your Gemfile
+
+	gem "baby-braspag"
+
+### Create a config/braspag.yml file
+
+	$ rails generate braspag:install
+
+### Set RACK_ENV (our suggest)
+
+	# add last line in config/environment.rb
+    # ...
+    # ENV["RACK_ENV"] ||= ENV["RAILS_ENV"]
+
+### Edit config/braspag.yml with your Braspag merchant_id
+
+# Examples
+
+## to create a Bill (Boleto/Bloqueto for brazilian guys)
+    @bill = Braspag::Bill.generate({
+      :order_id => 1,
+      :amount => 3,
+      :payment_method => 10
+    })
+
+# License
+
+(The MIT License)
+
+Copyright (c) 2010
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+

data/RELEASES.md

@@ -0,0 +1,20 @@
+# RELEASES
+
+## For next release
+
+d2b9a7a Voltando a usar o HTTPI
+
+## 0.1.1 - 09/01/2012
+
+9ffbcbd adicionando novos códigos de métodos de pagamento
+
+
+## 0.1.0 - 09/01/2012
+
+5cf697e adicionando Gemfile.lock ao .gitignore
+a6b1f54 removendo Gemfile.lock; modificando verificação do argumento has_interest
+a663e0a baixando a versão mínima requerida do nokogiri
+628d108 refatorando testes e implementação
+087549a moving Connection exceptions to errors.rb; tests for Utils class
+9a727eb bump up version
+6e5b1c3 refatorando para suportar o ambiente de produção da Braspag

data/Rakefile

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

data/baby-braspag.gemspec

@@ -0,0 +1,33 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "baby-braspag/version"
+
+Gem::Specification.new do |s|
+  s.name        = "baby-braspag"
+  s.version     = Braspag::VERSION
+  s.authors     = ["baby dev"]
+  s.email       = %w["dev-team@baby.com.br"]
+  s.homepage    = "https://github.com/Baby-com-br/braspag"
+  s.summary     = "baby braspag gem to use Braspag gateway"
+  s.description = "baby braspag gem to use Braspag gateway"
+
+  s.rubyforge_project = "baby-braspag"
+
+  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.add_dependency 'httpi', '>= 0.9.6'
+  s.add_dependency 'json', '>= 1.6.1'
+  s.add_dependency 'nokogiri', '>= 1.4.7'
+  s.add_dependency 'savon', '>= 0.9.9'
+
+  s.add_development_dependency "rake"
+  s.add_development_dependency "rspec"
+  s.add_development_dependency "fakeweb"
+  s.add_development_dependency "shoulda-matchers"
+  s.add_development_dependency "guard-rspec"
+  s.add_development_dependency "guard-bundler"
+  s.add_development_dependency "debugger"
+end

data/config/braspag.yml

@@ -0,0 +1,17 @@
+development:
+  environment: "homologation"
+  merchant_id: "{84BE7E7F-698A-6C74-F820-AE359C2A07C2}"
+  crypto_url: "http://localhost:9292"
+  crypto_key: "1234561246"
+
+test:
+  environment: "homologation"
+  merchant_id: "{84BE7E7F-698A-6C74-F820-AE359C2A07C2}"
+  crypto_url: "http://localhost:9292"
+  crypto_key: "1234561246"
+
+production:
+  environment: "production"
+  merchant_id: "{84BE7E7F-698A-6C74-F820-AE359C2A07C2}"
+  crypto_url: "http://localhost:9292"
+  crypto_key: "1234561246"

data/lib/baby-braspag.rb

@@ -0,0 +1,45 @@
+require 'singleton'
+require 'httpi'
+require 'nokogiri'
+require 'json'
+require 'savon'
+
+require "baby-braspag/version"
+require 'baby-braspag/connection'
+require 'baby-braspag/payment_method'
+require 'baby-braspag/crypto/jar_webservice'
+require 'baby-braspag/crypto/webservice'
+require 'baby-braspag/bill'
+require 'baby-braspag/poster'
+require 'baby-braspag/credit_card'
+require 'baby-braspag/protected_credit_card'
+require 'baby-braspag/eft'
+require 'baby-braspag/errors'
+require 'baby-braspag/utils'
+require 'baby-braspag/order'
+
+module Braspag
+  def self.logger=(value)
+    @logger = value
+  end
+
+  def self.logger
+    @logger
+  end
+
+  def self.config_file_path=(path)
+    @config_path = path
+  end
+
+  def self.config_file_path
+    @config_path || 'config/braspag.yml'
+  end
+
+  def self.proxy_address=(value)
+    @proxy_address = value
+  end
+
+  def self.proxy_address
+    @proxy_address
+  end
+end

data/lib/baby-braspag/bill.rb

@@ -0,0 +1,160 @@
+require "bigdecimal"
+
+module Braspag
+  class Bill < PaymentMethod
+
+    PAYMENT_METHODS = {
+      :bradesco => "06",
+      :cef => "07",
+      :hsbc => "08",
+      :bb => "09",
+      :real => "10",
+      :citibank => "13",
+      :itau => "14",
+      :unibanco => "26"
+    }
+
+    MAPPING = {
+      :merchant_id => "merchantId",
+      :order_id => "orderId",
+      :customer_name => "customerName",
+      :customer_id => "customerIdNumber",
+      :amount => "amount",
+      :payment_method => "paymentMethod",
+      :number => "boletoNumber",
+      :instructions => "instructions",
+      :expiration_date => "expirationDate",
+      :emails => "emails"
+    }
+
+    PRODUCTION_INFO_URI   = "/webservices/pagador/pedido.asmx/GetDadosBoleto"
+    HOMOLOGATION_INFO_URI = "/pagador/webservice/pedido.asmx/GetDadosBoleto"
+    CREATION_URI = "/webservices/pagador/Boleto.asmx/CreateBoleto"
+
+    def self.generate(params)
+      connection = Braspag::Connection.instance
+      params[:merchant_id] = connection.merchant_id
+
+      params = self.normalize_params(params)
+      self.check_params(params)
+
+      data = {}
+
+      MAPPING.each do |k, v|
+        case k
+        when :payment_method
+          data[v] = PAYMENT_METHODS[params[:payment_method]]
+        when :amount
+          data[v] = Utils.convert_decimal_to_string(params[:amount])
+        else
+          data[v] = params[k] || ""
+        end
+      end
+
+      request = ::HTTPI::Request.new(self.creation_url)
+      request.body = data
+
+      response = Utils::convert_to_map(::HTTPI.post(request).body,
+        {
+          :url => nil,
+          :amount => nil,
+          :number => "boletoNumber",
+          :expiration_date => Proc.new { |document|
+            begin
+              Date.parse(document.search("expirationDate").first.to_s)
+            rescue
+              nil
+            end
+          },
+          :return_code => "returnCode",
+          :status => nil,
+          :message => nil
+        })
+
+      raise InvalidMerchantId if response[:message] == "Invalid merchantId"
+      raise InvalidAmount if response[:message] == "Invalid purchase amount"
+      raise InvalidPaymentMethod if response[:message] == "Invalid payment method"
+      raise InvalidStringFormat if response[:message] == "Input string was not in a correct format."
+      raise UnknownError if response[:status].nil?
+
+      response[:amount] = BigDecimal.new(response[:amount])
+
+      response
+    end
+
+    def self.normalize_params(params)
+      params = super
+
+      if params[:expiration_date].respond_to?(:strftime)
+        params[:expiration_date] = params[:expiration_date].strftime("%d/%m/%y")
+      end
+
+      params
+    end
+
+    def self.check_params(params)
+      super
+
+      if params[:number]
+        raise InvalidNumber unless (1..255).include?(params[:number].to_s.size)
+      end
+
+      if params[:instructions]
+        raise InvalidInstructions unless (1..512).include?(params[:instructions].to_s.size)
+      end
+
+      if params[:expiration_date]
+        matches = params[:expiration_date].to_s.match /(\d{2})\/(\d{2})\/(\d{2})/
+        raise InvalidExpirationDate unless matches
+        begin
+          Date.new(matches[3].to_i, matches[2].to_i, matches[1].to_i)
+        rescue ArgumentError
+          raise InvalidExpirationDate
+        end
+      end
+    end
+
+    def self.info_url
+      connection = Braspag::Connection.instance
+      connection.braspag_url + (connection.production? ? PRODUCTION_INFO_URI : HOMOLOGATION_INFO_URI)
+    end
+
+    def self.creation_url
+      Braspag::Connection.instance.braspag_url + CREATION_URI
+    end
+
+    def self.info(order_id)
+      connection = Braspag::Connection.instance
+
+      raise InvalidOrderId unless self.valid_order_id?(order_id)
+
+      request = ::HTTPI::Request.new(self.info_url)
+      request.body = {
+        :loja => connection.merchant_id,
+        :numeroPedido => order_id.to_s
+      }
+
+      response = ::HTTPI.post(request)
+
+      response = Utils::convert_to_map(response.body, {
+          :document_number => "NumeroDocumento",
+          :payer => "Sacado",
+          :our_number => "NossoNumero",
+          :bill_line => "LinhaDigitavel",
+          :document_date => "DataDocumento",
+          :expiration_date => "DataVencimento",
+          :receiver => "Cedente",
+          :bank => "Banco",
+          :agency => "Agencia",
+          :account => "Conta",
+          :wallet => "Carteira",
+          :amount => "ValorDocumento",
+          :amount_invoice => "ValorPago",
+          :invoice_date => "DataCredito"
+        })
+
+      raise UnknownError if response[:document_number].nil?
+      response
+    end
+  end
+end

data/lib/baby-braspag/connection.rb

@@ -0,0 +1,37 @@
+module Braspag
+  class Connection
+    include Singleton
+
+    PRODUCTION_URL = "https://transaction.pagador.com.br"
+    HOMOLOGATION_URL = "https://homologacao.pagador.com.br"
+    
+    PROTECTED_CARD_PRODUCTION_URL = "https://cartaoprotegido.braspag.com.br/Services"
+    PROTECTED_CARD_HOMOLOGATION_URL = "https://homologacao.braspag.com.br/services/testenvironment"
+
+    attr_reader :braspag_url, :protected_card_url, :merchant_id, :crypto_url, :crypto_key, :options, :environment
+
+    def initialize
+      raise InvalidEnv if ENV["BRASPAG_ENV"].nil? || ENV["BRASPAG_ENV"].empty?
+
+      @options = YAML.load_file(Braspag.config_file_path)[ ENV['BRASPAG_ENV'] ]
+      @merchant_id = @options['merchant_id']
+
+      raise InvalidMerchantId unless @merchant_id =~ /\{[a-z0-9]{8}-([a-z0-9]{4}-){3}[a-z0-9]{12}\}/i
+
+      @crypto_key  = @options["crypto_key"]
+      @crypto_url  = @options["crypto_url"]
+      @environment = @options["environment"] == 'production' ? 'production' : 'homologation'
+
+      @braspag_url = self.production? ? PRODUCTION_URL : HOMOLOGATION_URL
+      @protected_card_url = self.production? ? PROTECTED_CARD_PRODUCTION_URL : PROTECTED_CARD_HOMOLOGATION_URL
+    end
+
+    def production?
+      @environment == 'production'
+    end
+
+    def homologation?
+      @environment == 'homologation'
+    end
+  end
+end

data/lib/baby-braspag/credit_card.rb

@@ -0,0 +1,210 @@
+module Braspag
+  class CreditCard < PaymentMethod
+
+    MAPPING = {
+      :merchant_id => "merchantId",
+      :order => 'order',
+      :order_id => "orderId",
+      :customer_name => "customerName",
+      :amount => "amount",
+      :payment_method => "paymentMethod",
+      :holder => "holder",
+      :card_number => "cardNumber",
+      :expiration => "expiration",
+      :security_code => "securityCode",
+      :number_payments => "numberPayments",
+      :type => "typePayment"
+    }
+
+    AUTHORIZE_URI = "/webservices/pagador/Pagador.asmx/Authorize"
+    CAPTURE_URI = "/webservices/pagador/Pagador.asmx/Capture"
+    PARTIAL_CAPTURE_URI = "/webservices/pagador/Pagador.asmx/CapturePartial"
+    CANCELLATION_URI = "/webservices/pagador/Pagador.asmx/VoidTransaction"
+    PRODUCTION_INFO_URI   = "/webservices/pagador/pedido.asmx/GetDadosCartao"
+    HOMOLOGATION_INFO_URI = "/pagador/webservice/pedido.asmx/GetDadosCartao"
+
+    def self.authorize(params = {})
+      connection = Braspag::Connection.instance
+      params[:merchant_id] = connection.merchant_id
+
+      self.check_params(params)
+
+      data = {}
+      MAPPING.each do |k, v|
+        case k
+        when :payment_method
+          data[v] = Braspag::Connection.instance.homologation? ? PAYMENT_METHODS[:braspag] : PAYMENT_METHODS[params[:payment_method]]
+        when :amount
+          data[v] = Utils.convert_decimal_to_string(params[:amount])
+        else
+          data[v] = params[k] || ""
+        end
+      end
+
+      response = Braspag::Poster.new(self.authorize_url).do_post(:authorize, data)
+
+      Utils::convert_to_map(response.body, {
+          :amount => nil,
+          :number => "authorisationNumber",
+          :message => 'message',
+          :return_code => 'returnCode',
+          :status => 'status',
+          :transaction_id => "transactionId"
+        })
+    end
+
+    def self.capture(order_id)
+      connection = Braspag::Connection.instance
+      merchant_id = connection.merchant_id
+
+      raise InvalidOrderId unless self.valid_order_id?(order_id)
+
+      data = {
+        MAPPING[:order_id] => order_id,
+        MAPPING[:merchant_id] => merchant_id
+      }
+
+      response = Braspag::Poster.new(self.capture_url).do_post(:capture, data)
+
+      Utils::convert_to_map(response.body, {
+          :amount => nil,
+          :number => "authorisationNumber",
+          :message => 'message',
+          :return_code => 'returnCode',
+          :status => 'status',
+          :transaction_id => "transactionId"
+        })
+    end
+
+    def self.partial_capture(order_id, amount)
+      connection = Braspag::Connection.instance
+      merchant_id = connection.merchant_id
+
+      raise InvalidOrderId unless self.valid_order_id?(order_id)
+
+      data = {
+        MAPPING[:order_id] => order_id,
+        MAPPING[:merchant_id] => merchant_id,
+        "captureAmount" => Utils.convert_decimal_to_string(amount)
+      }
+
+      response = Braspag::Poster.new(self.partial_capture_url).do_post(:partial_capture, data)
+
+      Utils::convert_to_map(response.body, {
+          :amount => nil,
+          :number => "authorisationNumber",
+          :message => 'message',
+          :return_code => 'returnCode',
+          :status => 'status',
+          :transaction_id => "transactionId"
+        })
+    end
+
+    def self.void(order_id)
+      connection = Braspag::Connection.instance
+      merchant_id = connection.merchant_id
+
+      raise InvalidOrderId unless self.valid_order_id?(order_id)
+
+      data = {
+        MAPPING[:order] => order_id,
+        MAPPING[:merchant_id] => merchant_id
+      }
+
+      response = Braspag::Poster.new(self.cancellation_url).do_post(:void, data)
+
+      Utils::convert_to_map(response.body, {
+          :amount => nil,
+          :number => "authorisationNumber",
+          :message => 'message',
+          :return_code => 'returnCode',
+          :status => 'status',
+          :transaction_id => "transactionId"
+        })
+    end
+
+    def self.info(order_id)
+      connection = Braspag::Connection.instance
+
+      raise InvalidOrderId unless self.valid_order_id?(order_id)
+
+      data = {:loja => connection.merchant_id, :numeroPedido => order_id.to_s}
+      response = Braspag::Poster.new(self.info_url).do_post(:info_credit_card, data)
+
+      response = Utils::convert_to_map(response.body, {
+          :checking_number => "NumeroComprovante",
+          :certified => "Autenticada",
+          :autorization_number => "NumeroAutorizacao",
+          :card_number => "NumeroCartao",
+          :transaction_number => "NumeroTransacao"
+        })
+
+      raise UnknownError if response[:checking_number].nil?
+      response
+    end
+
+    def self.check_params(params)
+      super
+
+      [:customer_name, :holder, :card_number, :expiration, :security_code, :number_payments, :type].each do |param|
+        raise IncompleteParams if params[param].nil?
+      end
+
+      raise InvalidHolder if params[:holder].to_s.size < 1 || params[:holder].to_s.size > 100
+
+      matches = params[:expiration].to_s.match /^(\d{2})\/(\d{2,4})$/
+      raise InvalidExpirationDate unless matches
+      begin
+        year = matches[2].to_i
+        year = "20#{year}" if year.size == 2
+
+        Date.new(year.to_i, matches[1].to_i)
+      rescue ArgumentError
+        raise InvalidExpirationDate
+      end
+
+      raise InvalidSecurityCode if params[:security_code].to_s.size < 1 || params[:security_code].to_s.size > 4
+
+      raise InvalidNumberPayments if params[:number_payments].to_i < 1 || params[:number_payments].to_i > 99
+    end
+
+    # <b>DEPRECATED:</b> Please use <tt>ProtectedCreditCard.save</tt> instead.
+    def self.save(params)
+      warn "[DEPRECATION] `CreditCard.save` is deprecated.  Please use `ProtectedCreditCard.save` instead."
+      ProtectedCreditCard.save(params)
+    end
+
+    # <b>DEPRECATED:</b> Please use <tt>ProtectedCreditCard.get</tt> instead.
+    def self.get(just_click_key)
+      warn "[DEPRECATION] `CreditCard.get` is deprecated.  Please use `ProtectedCreditCard.get` instead."
+      ProtectedCreditCard.get(just_click_key)
+    end
+
+    # <b>DEPRECATED:</b> Please use <tt>ProtectedCreditCard.just_click_shop</tt> instead.
+    def self.just_click_shop(params = {})
+      warn "[DEPRECATION] `CreditCard.just_click_shop` is deprecated.  Please use `ProtectedCreditCard.just_click_shop` instead."
+      ProtectedCreditCard.just_click_shop(params)
+    end
+
+    def self.info_url
+      connection = Braspag::Connection.instance
+      connection.braspag_url + (connection.production? ? PRODUCTION_INFO_URI : HOMOLOGATION_INFO_URI)
+    end
+
+    def self.authorize_url
+      Braspag::Connection.instance.braspag_url + AUTHORIZE_URI
+    end
+
+    def self.capture_url
+      Braspag::Connection.instance.braspag_url + CAPTURE_URI
+    end
+
+    def self.partial_capture_url
+      Braspag::Connection.instance.braspag_url + PARTIAL_CAPTURE_URI
+    end
+
+    def self.cancellation_url
+      Braspag::Connection.instance.braspag_url + CANCELLATION_URI
+    end
+  end
+end