locomotiva-braspag 0.1.6

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: b328bd3b8324a13c1607b3df909b0a6ebfae7c27
+  data.tar.gz: c3df45262ecd9eba10eecb5677321e03dbb08a96
+SHA512:
+  metadata.gz: 7fe820a0e29f668b030e3d33aed4897dc772f8a16a04c7ada5f917d6449f84756f80dfed8770aa5e6be0bb246d934577ceef9d26ffe03752c0c084f3f0fea753
+  data.tar.gz: 9dded58c47931707874a5a2b094979ea50cc0bec3201595b881a4584b359c652e7fd582cd285e385a4878710fc7da8479545b963d2c0e585e5fb1f572af8ffd2

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,59 @@
+# Locomotiva.pro Braspag
+
+locomotiva-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 "locomotiva-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/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/generators/braspag/install/install_generator.rb

@@ -0,0 +1,15 @@
+module Braspag
+  module Generators
+    class InstallGenerator < ::Rails::Generators::Base
+      desc "Copy braspag.yml file to your application config directory."
+
+      def self.source_root
+        @source_root ||= File.expand_path(File.join(File.dirname(__FILE__), 'templates'))
+      end
+
+      def copy_config_file
+        template "config/braspag.yml"
+      end
+    end
+  end
+end

data/lib/generators/braspag/install/templates/config/braspag.yml

@@ -0,0 +1,17 @@
+development:
+  environment: "homologation"
+  merchant_id: "{YOUR_MERCHANT_ID_ON_BRASPAG}"
+  crypto_url: "http://localhost:9292"
+  crypto_key: "1234561246"
+
+test:
+  environment: "homologation"
+  merchant_id: "{YOUR_MERCHANT_ID_ON_BRASPAG}"
+  crypto_url: "http://localhost:9292"
+  crypto_key: "1234561246"
+
+production:
+  environment: "production"
+  merchant_id: "{YOUR_MERCHANT_ID_ON_BRASPAG}"
+  crypto_url: "http://localhost:9292"
+  crypto_key: "1234561246"

data/lib/locomotiva-braspag.rb

@@ -0,0 +1,45 @@
+require 'singleton'
+require 'httpi'
+require 'nokogiri'
+require 'json'
+require 'savon'
+
+require "locomotiva-braspag/version"
+require 'locomotiva-braspag/connection'
+require 'locomotiva-braspag/payment_method'
+require 'locomotiva-braspag/crypto/jar_webservice'
+require 'locomotiva-braspag/crypto/webservice'
+require 'locomotiva-braspag/bill'
+require 'locomotiva-braspag/poster'
+require 'locomotiva-braspag/credit_card'
+require 'locomotiva-braspag/protected_credit_card'
+require 'locomotiva-braspag/eft'
+require 'locomotiva-braspag/errors'
+require 'locomotiva-braspag/utils'
+require 'locomotiva-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/locomotiva-braspag/bill.rb

@@ -0,0 +1,164 @@
+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",
+      :bank_boston => "33",
+      :brb => "38",
+      :safra => "40",
+      :santander => "124"
+    }
+
+    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/locomotiva-braspag/connection.rb

@@ -0,0 +1,50 @@
+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"]
+
+      @braspag_url = @options["pagador_url"] || default_env_configuration[:pagador][@environment]
+      @protected_card_url = @options["protected_card_url"] || default_env_configuration[:protected_card][@environment]
+    end
+
+    def default_env_configuration
+      {
+        :pagador => {
+          "production"   => PRODUCTION_URL,
+          "homologation" => HOMOLOGATION_URL
+        },
+        :protected_card  => {
+          "production"   => PROTECTED_CARD_PRODUCTION_URL,
+          "homologation" => PROTECTED_CARD_HOMOLOGATION_URL
+        }
+      }
+    end
+
+    def production?
+      @environment == 'production'
+    end
+
+    def homologation?
+      @environment == 'homologation'
+    end
+  end
+end