aprova_facil 1.3.0 → 1.4.0

data/README.markdown

@@ -3,6 +3,8 @@ Aprova Fácil
 
 Gem para integração com Gateway Aprova Fácil da [Cobrebem](https://www.cobrebemx.com.br).
 
+Mais informações: http://www.cobrebem.com/imagens/ManualAPFIntegracaoWebService.pdf
+
 COMO USAR
 ---------
 
@@ -29,8 +31,7 @@ No caso de um abiente de teste ou desenvolvimento também é possível passar o
 Efetuando uma aprovação
 -----------------------
 
-Para efetuar uma compra é necessário preencher uma instância da classe CartaoCredito, 
-segue abaixo os dados básicos para uma aprovação.
+Para efetuar uma compra é necessário criar uma instância da classe CartaoCredito com os dados da compra e do cartão de crédito a ser debitado.
 
 ```ruby
   cartao = AprovaFacil::CartaoCredito.new(
@@ -153,7 +154,7 @@ segue abaixo os dados básicos para uma aprovação.
   AprovaFacil::CartaoCredito::Bandeira::AURA      
 ```
 
-Após criar o cartão deve ser solicidade uma aprovação.
+Após criar o cartão, deve-se solicitar a aprovação da transação.
 
 ```ruby
   aprova_facil = AprovaFacil.new
@@ -174,14 +175,16 @@ Após criar o cartão deve ser solicidade uma aprovação.
 Captura
 -------
 
-  Entende­se  por   captura   o processo de confirmação de uma transação, o que caracteriza a venda 
-efetivada, sendo realizado assim, o débito no cartão de crédito do cliente.
-  De acordo com os padrões ISO 8583, todas as transações aprovadas pelas Administradoras de 
-Cartões de Crédito devem ser capturadas (confirmadas) pela aplicação do Lojista.
-  Caso a transação não seja capturada (confirmada) pela aplicação do Lojista, no prazo estipulado 
-pelas Administradoras de Cartões Crédito,  a mesma será automaticamente desfeita, não havendo assim o 
-débito  efetivo  no  cartão  de  crédito  do  cliente,  essa  informação  será  exibida   no  campo  
-“Data  Hora Cancelamento”do Extrato do Aprova Fácil.
+  Entende­-se por captura o processo de confirmação de uma transação. Em outras palavras, captura é a efetivação da venda. 
+
+  De acordo com os padrões ISO 8583, todas as transações aprovadas pelas Administradoras de Cartões de Crédito devem ser capturadas (confirmadas) pela aplicação do Lojista. 
+
+  Após essa confirmação, a reserva de crédito estabelecida na aprovação é transformada em um débito efetivo no
+cartão do Cliente.
+
+  Caso a transação não seja confirmada no prazo estipulado, a mesma será automaticamente desfeita, sem a efetivação do débito.
+
+  Tal informação será exibida no campo  “Data  Hora Cancelamento” do extrato do Aprova Fácil.
 
 ```ruby
   aprova_facil = AprovaFacil.new
@@ -198,10 +201,10 @@ débito  efetivo  no  cartão  de  crédito  do  cliente,  essa  inform
 Cancelamento
 ------------
 
-  O cancelamento de uma transação somente poderá ser realizado quando a mesma for aprovada pela 
-Administradora e confirmada pelo lojista. Por isso, para que o Aprova Fácil possa realizar o 
-cancelamento, este deve ser  solicitado no mesmo dia em que a transação foi processada, 
-ou seja, foi confirmada pela Administradora.
+  Como todas as transações precisam ser confirmadas pelo Lojista, um cancelamento de transação só faz sentido após a sua confirmação.
+
+  Após a confirmação do Lojista (captura), a transação ainda pode ser cancelada antes que o sistema de cobrança das administradoras debitem o valor do cliente (após esse prazo o valor será debitado e a reversão da venda deverá ser feita via Estorno). 
+
 
 ```ruby
   aprova_facil = AprovaFacil.new
@@ -216,16 +219,12 @@ ou seja, foi confirmada pela Administradora.
   :nsu_Cancelamento # Número de cancelamento da Administradora
 ```
 
-Recorrencia
+Recorrência
 -----------
 
-  A recorrência de transações é utilizada, quando se deseja efetuar novos débitos em um cartão de
-crédito, seja esta de qualquer  periodicidade; é possível alterar  o valor  do débito a cada cobrança, se
-necessário.
-  O processo de "re­cobrança" em uma recorrência, se difere do processo de "re­cobrança" em um
-agendamento. A re­cobrança em uma recorrência é comandada pela aplicação do lojista, nesse caso, deve
-ser  informado apenas o número que identifica a última transação aprovada e confirmada, sendo este,
-representado pelo parâmetro "Transacao".
+A recorrência de transações é utilizada quando se deseja efetuar novos débitos em um cartão de crédito, em qualquer periodicidade, podendo ainda alterar o valor do débito a cada cobrança.
+
+O processo de "re­cobrança" em uma recorrência, se difere do processo de "re­cobrança" em um agendamento A re­cobrança em uma recorrência é comandada pela aplicação do lojista. Nesse caso, a última transação aprovada e confirmada previsa ser passada como parâmetro.
 
 ```ruby
   aprova_facil = AprovaFacil.new

data/lib/aprova_facil/cartao_credito.rb

@@ -86,7 +86,7 @@ class AprovaFacil
       params['NumeroCartao']                 = numero_cartao
       params['MesValidade']                  = '%02d' % mes_validade.to_i
       params['AnoValidade']                  = '%02d' % ano_validade
-      params['CodigoSeguranc']               = codigo_seguranca
+      params['CodigoSeguranca']              = codigo_seguranca
       params['PreAutorizacao']               = pre_autorizacao ? 'S' : 'N'
       params['EnderecoIPComprado']           = ip_comprador
       params['NomePortadorCarta']            = nome_portador if nome_portador

data/lib/aprova_facil/version.rb

@@ -1,3 +1,3 @@
 class AprovaFacil
-  VERSION = "1.3.0"
+  VERSION = "1.4.0"
 end

data/test/aprova_facil_test.rb

@@ -8,12 +8,8 @@ class AprovaFacilTest < TestHelper
   end
   
   def test_aprovar
-    resultado = nil
-    3.times.each do 
-      resultado = @aprova_facil.aprovar cartao      
-      break if resultado[:aprovada]       
-    end
-    
+    resultado = @aprova_facil.aprovar cartao    
+
     assert_equal true, resultado[:aprovada] 
     assert_not_nil resultado[:resultado]     
     assert_not_nil resultado[:codigo_autorizacao]         
@@ -23,21 +19,14 @@ class AprovaFacilTest < TestHelper
   
   def test_aprovar_cartao_invalido
     cartao_invalido = cartao('502')
-    resultado = nil
-    3.times.each do     
-      resultado = @aprova_facil.aprovar cartao_invalido
-      break if !resultado[:aprovada]      
-    end
+
+    resultado = @aprova_facil.aprovar cartao_invalido
 
     assert_equal false, resultado[:aprovada]
   end
   
   def test_recobrar
-    resultado = nil
-    3.times.each do 
-      resultado = @aprova_facil.aprovar cartao      
-      break if resultado[:aprovada]
-    end
+    resultado = @aprova_facil.aprovar cartao
     assert_equal true, resultado[:aprovada]     
     
     resultado = @aprova_facil.capturar resultado[:transacao]

metadata

@@ -1,29 +1,24 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: aprova_facil
-version: !ruby/object:Gem::Version 
+version: !ruby/object:Gem::Version
+  version: 1.4.0
   prerelease: 
-  version: 1.3.0
 platform: ruby
-authors: 
+authors:
 - Bruno Frank
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2012-01-17 00:00:00 -02:00
-default_executable: 
+date: 2012-09-22 00:00:00.000000000Z
 dependencies: []
-
-description: "Gem para integra\xC3\xA7\xC3\xA3o de aplica\xC3\xA7\xC3\xA3o Ruby com o gateway de pagamento Aprova F\xC3\xA1cil da Cobre Bem."
-email: 
+description: Gem para integração de aplicação Ruby com o gateway de pagamento Aprova
+  Fácil da Cobre Bem.
+email:
 - bfscordeiro@gmail.com
 executables: []
-
 extensions: []
-
 extra_rdoc_files: []
-
-files: 
+files:
 - .gitignore
 - Gemfile
 - MIT-LICENSE
@@ -37,35 +32,32 @@ files:
 - test/aprova_facil_test.rb
 - test/cartao_credito_test.rb
 - test/test_helper.rb
-has_rdoc: true
 homepage: https://github.com/brunofrank/aprova_facil
 licenses: []
-
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: aprova_facil
-rubygems_version: 1.6.2
+rubygems_version: 1.8.17
 signing_key: 
 specification_version: 3
-summary: "Gem para integra\xC3\xA7\xC3\xA3o de aplica\xC3\xA7\xC3\xA3o Ruby com o gateway de pagamento Aprova F\xC3\xA1cil da Cobre Bem."
-test_files: 
+summary: Gem para integração de aplicação Ruby com o gateway de pagamento Aprova Fácil
+  da Cobre Bem.
+test_files:
 - test/aprova_facil_test.rb
 - test/cartao_credito_test.rb
 - test/test_helper.rb