moip 1.0.1

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,24 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC
+
+lib/main.rb
+config.yaml

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Guilherme Nascimento
+
+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/README.markdown

@@ -0,0 +1,79 @@
+# MoIP
+
+Esta Gem permite utilizar a API do MoIP, gateway de pagamentos do IG.
+
+## Pagamento direto
+
+O Pagamento Direto é um recurso que a MoIP disponibiliza para aqueles clientes que necessitam de uma flexibilidade maior do que a Integração HTML pode oferecer.
+
+Diferentemente de como é feito com a Integração HTML, seu cliente não precisa ser redirecionado para o site da MoIP para concluir a compra: tudo é feito dentro do ambiente do seu site, dando ao cliente uma maior segurança e confiança no processo.
+	
+As formas de pagamento disponibilizadas pela Gem são:
+
+* Boleto
+* Débito
+* Cartão de Crédito
+
+## Instalação
+
+Instale a Gem
+	gem install moip
+
+Adicione a Gem ao Gemfile
+	gem "moip"
+
+## Utilização
+
+O MoIP possui uma SandBox de testes que permite a simulação de pagamentos. Para utilizar a Gem com o SandBox, crie o arquivo moip.yml na pasta Rails.root/config e adicione o token e chave do MoIP.
+
+## moip.yml
+
+	development:
+	    uri: https://desenvolvedor.moip.com.br/sandbox
+	    token: SEU_TOKEN
+	    key: SUA_KEY
+
+	production:
+	    uri: 
+	    token: 
+	    key:
+
+Após realizar os testes na SandBox, você poderá fazer a mudança para o ambiente de produção do MoIP de maneira simples. Basta inserir o token e chave de produção no arquivo moip.yml.
+
+###Crie os dados do pagador
+
+	pagador = { :nome => "Luiz Inácio Lula da Silva",
+            	:login_moip => "lula",
+            	:email => "presidente@planalto.gov.br",
+            	:tel_cel => "(61)9999-9999",
+            	:apelido => "Lula",
+            	:identidade => "111.111.111-11",
+            	:logradouro => "Praça dos Três Poderes",
+            	:numero => "0",
+            	:complemento => "Palácio do Planalto",
+            	:bairro => "Zona Cívico-Administrativa",
+            	:cidade => "Brasília",
+            	:estado => "DF",
+            	:pais => "BRA",
+            	:cep => "70100-000",
+            	:tel_fixo => "(61)3211-1221" }
+
+###Dados do boleto
+
+	boleto = { :valor => "50",
+		   	   :id_proprio => "Pag#{rand(1000)}",
+	           :forma => "BoletoBancario",
+	           :dias_expiracao => 5,
+	           :pagador => pagador }
+
+###Checkout
+
+	def checkout
+		response = MoIP.checkout(boleto)
+
+		# exibe o boleto para impressão
+		redirect_to MoIP.moip_page(response["Token"])
+	end
+
+
+Baseado no projeto do [Daniel Lopes](http://github.com/danielvlopes/moip_usage).

data/Rakefile

@@ -0,0 +1,54 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "moip"
+    gem.summary = %Q{Gem para utilização da API MoIP}
+    gem.description = %Q{Gem para utilização da API MoIP}
+    gem.email = "guilherme.ruby@gmail.com"
+    gem.homepage = "http://github.com/guinascimento/moip"
+    gem.authors = ["Guilherme Nascimento"]
+#    gem.add_development_dependency "thoughtbot-shoulda", ">= 0"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/test_*.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "moip #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+

data/VERSION

@@ -0,0 +1 @@
+1.0.1

data/lib/direct_payment.rb

@@ -0,0 +1,130 @@
+module MoIP
+
+  class DirectPayment
+
+    class << self
+
+      # Cria uma instrução de pagamento direto
+      def direct(attributes = {})
+        builder = Nokogiri::XML::Builder.new(:encoding => "UTF-8") do |xml|
+
+          # Identificador do tipo de instrução
+          xml.EnviarInstrucao {
+            xml.InstrucaoUnica {
+              # Dados da transação
+              xml.Razao {
+                xml.text "Pagamento"
+              }
+              xml.Valores {
+                xml.Valor(:moeda => "BRL") {
+                  xml.text attributes[:valor]
+                }
+              }
+              xml.IdProprio {
+                xml.text attributes[:id_proprio]
+              }
+
+              # Definindo o pagamento direto
+              xml.PagamentoDireto {
+                xml.Forma {
+                  xml.text attributes[:forma]
+                }
+
+                # Débito Bancário
+                if attributes[:forma] == "DebitoBancario"
+                  xml.Instituicao {
+                    xml.text attributes[:instituicao]
+                  }
+                end
+
+                # Cartão de Crédito
+                if attributes[:forma] == "CartaoCredito"
+                  xml.Instituicao {
+                    xml.text attributes[:instituicao]
+                  }
+
+                  xml.CartaoCredito {
+                    xml.Numero {
+                      xml.text attributes[:numero]
+                    }
+                    xml.Expiracao {
+                      xml.text attributes[:expiracao]
+                    }
+                    xml.CodigoSeguranca {
+                      xml.text attributes[:codigo_seguranca]
+                    }
+                    xml.Portador {
+                      xml.Nome {
+                        xml.text attributes[:nome]
+                      }
+                      xml.Identidade(:Tipo => "CPF") {
+                        xml.text attributes[:identidade]
+                      }
+                      xml.Telefone {
+                        xml.text attributes[:telefone]
+                      }
+                      xml.DataNascimento {
+                        xml.text attributes[:data_nascimento]
+                      }
+                    }
+                  }
+                  xml.Parcelamento {
+                    xml.Parcelas {
+                      xml.text attributes[:parcelas]
+                    }
+                    xml.Recebimento {
+                      xml.text attributes[:recebimento]
+                    }
+                  }
+                end
+              }
+
+              # Dados do pagador
+              raise(StandardError, "É obrigatório passar as informações do pagador") if attributes[:pagador].nil?
+              xml.Pagador {
+                xml.Nome { xml.text attributes[:pagador][:nome] }
+                xml.LoginMoIP { xml.text attributes[:pagador][:login_moip] }
+                xml.Email { xml.text attributes[:pagador][:email] }
+                xml.TelefoneCelular { xml.text attributes[:pagador][:tel_cel] }
+                xml.Apelido { xml.text attributes[:pagador][:apelido] }
+                xml.Identidade { xml.text attributes[:pagador][:identidade] }
+                xml.EnderecoCobranca {
+                  xml.Logradouro { xml.text attributes[:pagador][:logradouro] }
+                  xml.Numero { xml.text attributes[:pagador][:numero] }
+                  xml.Complemento { xml.text attributes[:pagador][:complemento] }
+                  xml.Bairro { xml.text attributes[:pagador][:bairro] }
+                  xml.Cidade { xml.text attributes[:pagador][:cidade] }
+                  xml.Estado { xml.text attributes[:pagador][:estado] }
+                  xml.Pais { xml.text attributes[:pagador][:pais] }
+                  xml.CEP { xml.text attributes[:pagador][:cep] }
+                  xml.TelefoneFixo { xml.text attributes[:pagador][:tel_fixo] }
+                }
+              }
+
+              # Boleto Bancario
+              if attributes[:forma] == "BoletoBancario"
+                # Dados extras
+                xml.Boleto {
+                  xml.DiasExpiracao(:Tipo => "Corridos") {
+                    xml.text attributes[:dias_expiracao]
+                  }
+                  xml.Instrucao1 {
+                    xml.text attributes[:instrucao_1]
+                  }
+                  xml.URLLogo {
+                    xml.text attributes[:url_logo]
+                  }
+                }
+              end
+
+            }
+          }
+        end
+        builder.to_xml
+      end
+
+    end
+
+  end
+  
+end

data/lib/moip.rb

@@ -0,0 +1,61 @@
+require "rubygems"
+require 'httparty'
+require "nokogiri"
+
+require "direct_payment"
+
+module MoIP
+    include HTTParty
+
+    CONFIG = YAML.load_file("config/moip.yml")["development"]
+    STATUS = { 1 => "authorized", 2 => "started", 3 => "printed", 4 => "completed", 5 => "canceled", 6 => "analysing"}
+
+    base_uri "#{CONFIG["uri"]}/ws/alpha"
+    basic_auth CONFIG["token"], CONFIG["key"]
+
+    class << self
+
+      # Envia uma instrução para pagamento único
+      def checkout(attributes = {})
+        full_data = post('EnviarInstrucao/Unica', :body => DirectPayment.direct(attributes))
+
+        raise(StandardError, "Ocorreu um erro ao chamar o webservice") if full_data.nil?
+
+        response = full_data["ns1:EnviarInstrucaoUnicaResponse"]["Resposta"]
+        raise(StandardError, response["Erro"]) if response["Status"] == "Falha"
+
+        return response
+      end
+
+      # Consulta dos dados das autorizações e pagamentos associados à Instrução
+      def query(token)
+        full_data = get("ConsultarInstrucao/#{token}")
+        raise(StandardError, "Ocorreu um erro ao chamar o webservice") if full_data.nil?
+
+        response = full_data["ns1:ConsultarTokenResponse"]["RespostaConsultar"]
+        raise(StandardError, response["Erro"]) if response["Status"] == "Falha"
+
+        return response
+      end
+
+      # Retorna a URL de acesso ao MoIP
+      def moip_page(token)
+        raise(StandardError, "É necessário informar um token para retornar os dados da transação") if token.nil?
+        "#{CONFIG["uri"]}/Instrucao.do?token=#{token}"
+      end
+
+      # Monta o NASP
+      def notification(params)
+        notification = {}
+        notification[:transaction_id] = params["id_transacao"]
+        notification[:amount]         = sprintf("%.2f", params["valor"].to_f / 100).to_d
+        notification[:status]         = STATUS[params["status_pagamento"].to_i]
+        notification[:code]           = params["cod_moip"]
+        notification[:payment_type]   = params["tipo_pagamento"]
+        notification[:email]          = params["email_consumidor"]
+        notification
+      end
+
+    end
+
+end

data/moip.gemspec

@@ -0,0 +1,51 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{moip}
+  s.version = "1.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Guilherme Nascimento"]
+  s.date = %q{2010-11-02}
+  s.description = %q{Gem para utilização da API MoIP}
+  s.email = %q{guilherme.ruby@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.markdown"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.markdown",
+     "Rakefile",
+     "VERSION",
+     "lib/direct_payment.rb",
+     "lib/moip.rb",
+     "moip.gemspec",
+     "spec/lib/config.yaml",
+     "spec/lib/moip_spec.rb"
+  ]
+  s.homepage = %q{http://github.com/guinascimento/moip}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Gem para utilização da API MoIP}
+  s.test_files = [
+    "spec/lib/moip_spec.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end
+

data/spec/lib/config.yaml

@@ -0,0 +1,14 @@
+development:
+    uri: https://desenvolvedor.moip.com.br/sandbox
+    token: 
+    key: 
+
+test:
+    uri: https://desenvolvedor.moip.com.br/sandbox
+    token: 
+    key: 
+
+production:
+    uri: 
+    token: 
+    key: 

data/spec/lib/moip_spec.rb

@@ -0,0 +1,125 @@
+require "moip"
+
+describe "Make payments with the MoIP API" do
+
+  CONFIG_TEST = YAML.load_file("config.yaml")["test"]
+
+  before :all do
+    @pagador = { :nome => "Luiz Inácio Lula da Silva",
+                :login_moip => "lula",
+                :email => "presidente@planalto.gov.br",
+                :tel_cel => "(61)9999-9999",
+                :apelido => "Lula",
+                :identidade => "111.111.111-11",
+                :logradouro => "Praça dos Três Poderes",
+                :numero => "0",
+                :complemento => "Palácio do Planalto",
+                :bairro => "Zona Cívico-Administrativa",
+                :cidade => "Brasília",
+                :estado => "DF",
+                :pais => "BRA",
+                :cep => "70100-000",
+                :tel_fixo => "(61)3211-1221" }
+
+    @billet = { :value => "8.90", :id_proprio => id, :forma => "BoletoBancario", :pagador => @pagador }
+    @debit = { :value => "8.90", :id_proprio => id, :forma => "DebitoBancario", :instituicao => "BancoDoBrasil", :pagador => @pagador }
+    @credit = { :value => "8.90", :id_proprio => id, :forma => "CartaoCredito", :instituicao => "AmericanExpress", :numero => "345678901234564", :expiracao => "08/11", :codigo_seguranca => "1234", :nome => "João Silva", :identidade => "134.277.017.00", :telefone => "(21)9208-0547", :data_nascimento => "25/10/1980", :parcelas => "2", :recebimento => "AVista", :pagador => @pagador }
+  end
+
+  context "make a billet checkout" do
+    it "should have status Sucesso" do
+      MoIP.stub!(:post).and_return("ns1:EnviarInstrucaoUnicaResponse"=>{ "Resposta"=>{ "ID"=>Time.now.strftime("%y%m%d%H%M%S"), "Status"=>"Sucesso", "Token" => "T2N0L0X8E0S71217U2H3W1T4F4S4G4K731D010V0S0V0S080M010E0Q082X2" }})
+      response = MoIP.checkout(@billet)
+      response["Status"].should == "Sucesso"
+    end
+  end
+
+  context "make a debit checkout" do
+    it "should have status Sucesso" do
+      MoIP.stub!(:post).and_return("ns1:EnviarInstrucaoUnicaResponse"=>{ "Resposta"=>{ "ID"=>Time.now.strftime("%y%m%d%H%M%S"), "Status"=>"Sucesso", "Token" => "T2N0L0X8E0S71217U2H3W1T4F4S4G4K731D010V0S0V0S080M010E0Q082X2" }})
+      response = MoIP.checkout(@debit)
+      response["Status"].should == "Sucesso"
+    end
+  end
+
+  context "make a debit checkout without pass a institution" do
+    it "should have status Falha" do
+      @incorrect_debit = { :value => "37.90", :id_proprio => id, :forma => "DebitoBancario", :pagador => @pagador }
+      MoIP.stub!(:post).and_return("ns1:EnviarInstrucaoUnicaResponse"=>{ "Resposta"=>{"Status"=>"Falha", "Erro"=>"Pagamento direto não é possível com a instituição de pagamento enviada" }})
+      lambda { MoIP.checkout(@incorrect_debit) }.should raise_error(StandardError, "Pagamento direto não é possível com a instituição de pagamento enviada")
+    end
+  end
+
+  context "make a debit checkout without pass the payer informations" do
+    it "should raise an exception" do
+      @incorrect_debit = { :value => "37.90", :id_proprio => id, :forma => "DebitoBancario", :instituicao => "BancoDoBrasil" }
+      lambda { MoIP.checkout(@incorrect_debit) }.should raise_error(StandardError, "É obrigatório passar as informações do pagador")
+    end
+  end
+
+  context "make a credit card checkout" do
+    it "should have status Sucesso" do
+      MoIP.stub!(:post).and_return("ns1:EnviarInstrucaoUnicaResponse"=>{ "Resposta"=>{ "ID"=>Time.now.strftime("%y%m%d%H%M%S"), "Status"=>"Sucesso", "Token" => "T2N0L0X8E0S71217U2H3W1T4F4S4G4K731D010V0S0V0S080M010E0Q082X2" }})
+      response = MoIP.checkout(@credit)
+      response["Status"].should == "Sucesso"
+    end
+  end
+
+  context "make a credit card checkout without pass card informations" do
+    it "should have status Falha" do
+      @incorrect_credit = { :value => "8.90", :id_proprio => id, :forma => "CartaoCredito", :pagador => @pagador }
+      MoIP.stub!(:post).and_return("ns1:EnviarInstrucaoUnicaResponse"=>{ "Resposta"=>{"Status"=>"Falha", "Erro"=>"Pagamento direto não é possível com a instituição de pagamento enviada" }})
+      lambda { MoIP.checkout(@incorrect_credit) }.should raise_error(StandardError, "Pagamento direto não é possível com a instituição de pagamento enviada")
+    end
+  end
+
+  context "in error scenario" do
+    it "should raise an exception if response is nil" do
+      MoIP.stub!(:post).and_return(nil)
+      lambda { MoIP.checkout(@billet) }.should raise_error(StandardError, "Ocorreu um erro ao chamar o webservice")
+    end
+
+    it "should raise an exception if status is fail" do
+      MoIP.stub!(:post).and_return("ns1:EnviarInstrucaoUnicaResponse"=>{ "Resposta"=>{"Status"=>"Falha", "Erro"=>"O status da resposta é Falha" }})
+      lambda { MoIP.checkout(@billet) }.should raise_error(StandardError, "O status da resposta é Falha")
+    end
+  end
+
+  context "query a transaction token" do
+    it "should retrieve the transaction" do
+      MoIP.stub!(:get).and_return("ns1:ConsultarTokenResponse"=>{ "RespostaConsultar"=>{"Status"=>"Sucesso", "ID"=>"201010291031001210000000046760" }})
+      response = MoIP.query(token)
+      response["Status"].should == "Sucesso"
+    end
+  end
+
+  context "query a transaction token in a error scenario" do
+    it "should retrieve status Falha" do
+      MoIP.stub!(:get).and_return("ns1:ConsultarTokenResponse"=>{ "RespostaConsultar"=>{"Status"=>"Falha", "Erro"=>"Instrução não encontrada", "ID"=>"201010291102522860000000046768"}})
+      lambda { MoIP.query("000000000000000000000000000000000000000000000000000000000000") }.should raise_error(StandardError, "Instrução não encontrada")
+    end
+  end
+
+  context "build the MoIP URL" do
+    it "should build the correct URL" do
+      MoIP.moip_page(token).should == "#{CONFIG_TEST["uri"]}/Instrucao.do?token=#{token}"
+    end
+
+    it "should raise an error if the token is not informed" do
+      lambda { MoIP.moip_page("").should raise_error(ArgumentError, "É necessário informar um token para retornar os dados da transação") }
+    end
+
+    it "should raise an error if nil is passed as the token" do
+      lambda { MoIP.moip_page(nil).should raise_error(ArgumentError, "É necessário informar um token para retornar os dados da transação") }
+    end
+  end
+
+  def id
+    "transaction_" + Digest::SHA1.hexdigest([Time.now, rand].join)
+  end
+
+  def token
+    "T2X0Q1N021E0B2S9U1P0V3Y0G1F570Y2P4M0P000M0Z0F0J0G0U4N6C7W5T9"
+  end
+
+end

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification 
+name: moip
+version: !ruby/object:Gem::Version 
+  hash: 21
+  prerelease: false
+  segments: 
+  - 1
+  - 0
+  - 1
+  version: 1.0.1
+platform: ruby
+authors: 
+- Guilherme Nascimento
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-11-02 00:00:00 -02:00
+default_executable: 
+dependencies: []
+
+description: "Gem para utiliza\xC3\xA7\xC3\xA3o da API MoIP"
+email: guilherme.ruby@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.markdown
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.markdown
+- Rakefile
+- VERSION
+- lib/direct_payment.rb
+- lib/moip.rb
+- moip.gemspec
+- spec/lib/config.yaml
+- spec/lib/moip_spec.rb
+has_rdoc: true
+homepage: http://github.com/guinascimento/moip
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: "Gem para utiliza\xC3\xA7\xC3\xA3o da API MoIP"
+test_files: 
+- spec/lib/moip_spec.rb