pag_seguro 0.1.4 → 0.1.6

data/README.md

@@ -0,0 +1,64 @@
+# PagSeguro
+
+Esta gem foi criada com o intuito de facilitar o uso da versão 2 das APIs do PagSeguro, como pagamento e notificações através de código Ruby. Esta gem não depende de rails e portanto pode ser utilizada com uma aplicação Rack ou como Backend de outra aplicação sem precisar carregar um environment rails.
+
+Utilizando esta gem é possível enviar informações de compra ao pag seguro sem necessitar renderizar um formulário, impedindo o usuário de forjar informações pois as informações são trocadas apenas entre a sua aplicação e o pagseguro sem intermédio do usuário.
+
+Esta gem foi desenvolvida para utilizar Ruby 1.9.2 ou superior, e não têm compatibilidade com versões anteriores. Caso deseje utilizar esta gem com versões anteriores de ruby, faça um fork desta gem e corrija os problemas encontrados.
+
+## Instalação
+
+Adicione a `gem "pag_seguro"` ao seu Gemfile:
+
+    gem 'pag_seguro'
+	
+Além disso, é necessário que tenha uma conta no pag seguro, e que habilite as seguintes configurações:
+
+    Em Integrações -> Token de segurança clique em Gerar novo token e guarde esta informação em local seguro
+    Em Integrações -> Pagamentos via API é necessário ativar a opção "Quero receber somente pagamentos via API."
+    Em Integrações -> Notificação de transações é necessário ativar a notificação de transações e definir a url de retorno
+	
+## Documentação da API e dos attributos
+
+A nomenclatura dos atributos esperados pelo PagSeguro foram mantidas porém no padrão underscore (que é o padrão de ruby, ao invés do camelcase utilizado pelo pagseguro). Seguem os links das documentações dos attributos no pagseguro:
+
+* [API de pagamentos](https://pagseguro.uol.com.br/v2/guia-de-integracao/api-de-pagamentos.html#v2-item-api-de-pagamentos-parametros-api)
+* [API de notificação](https://pagseguro.uol.com.br/v2/guia-de-integracao/api-de-notificacoes.html)
+
+## Documentação
+
+Segue um exemplo de uso desta gem (para mais exemplos, olhe o arquivo spec/integration/checkout_spec.rb):
+
+    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: 17, description: "A pipe",    amount: "3.00",  quantity: "89")
+    ]
+    
+    redirect_to_url = payment.checkout_payment_url
+    
+Além dos items presentes no exemplo acima, é possível configurar `payment.sender` (com informações do usuário que está efetuando a compra) e `payment.shipping` ( com as informações de endereço ).
+
+## Validações
+
+Os modelos utilizados nesta gem utilizam as validações do ActiveModel (semelhantes às presentes em ActiveRecord/Rails) e incluem diversas validações, permitindo que se verifique a validade (utilizando object.valid?) dos dados antes de enviá-los ao PagSeguro. A gem não bloqueia o envio das informações caso os dados estejam inválidos, deixando este passo a cargo da sua aplicação, mas levanta erros caso o pag seguro retorne algum erro relativo às informações enviadas.
+
+## Testes
+
+Esta gem possui testes extensivos utilizando Rspec. Para rodar os estes, altere o arquivo spec/pag_seguro/integration/config.yml com seus dados no pag_seguro, entre na pasta onde a gem está instalada e execute:
+
+    bundle
+    guard
+
+## Contribuindo
+
+Caso queira contribuir, faça um fork desta gem no [github](https://github.com/heavenstudio/pag_seguro), escreva os testes respectivos ao bug/feature desejados e faça um merge request.
+
+## TODO
+
+Permitir realizar [consultas de transações](https://pagseguro.uol.com.br/v2/guia-de-integracao/consultas.html)
+
+## Sobre
+
+Desenvolvida por [Stefano Diem Benatti](mailto:stefano.diem@gmail.com)

data/lib/pag_seguro/version.rb

@@ -1,3 +1,3 @@
 module PagSeguro
-  VERSION = "0.1.4"
+  VERSION = "0.1.6"
 end

data/spec/pag_seguro/integration/checkout_spec.rb

@@ -23,6 +23,13 @@ describe "PagSeguro::Payment.code" do
     payment = create_valid_payment
     payment.code.size.should == 32
   end
+  
+  it "should be valid even without a sender and shipping information" do
+    payment = create_valid_payment
+    payment.sender = nil
+    payment.shipping = nil
+    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")

data/spec/pag_seguro/integration/config.yml

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pag_seguro
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.6
   prerelease: 
 platform: ruby
 authors:
@@ -13,7 +13,7 @@ date: 2012-02-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel
-  requirement: &2152459520 !ruby/object:Gem::Requirement
+  requirement: &2168863380 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *2152459520
+  version_requirements: *2168863380
 - !ruby/object:Gem::Dependency
   name: haml
-  requirement: &2152458800 !ruby/object:Gem::Requirement
+  requirement: &2168862900 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *2152458800
+  version_requirements: *2168862900
 - !ruby/object:Gem::Dependency
   name: nokogiri
-  requirement: &2152458100 !ruby/object:Gem::Requirement
+  requirement: &2168862140 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *2152458100
+  version_requirements: *2168862140
 - !ruby/object:Gem::Dependency
   name: rest-client
-  requirement: &2152457160 !ruby/object:Gem::Requirement
+  requirement: &2168861420 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -54,7 +54,7 @@ dependencies:
         version: 1.6.7
   type: :runtime
   prerelease: false
-  version_requirements: *2152457160
+  version_requirements: *2168861420
 description: 
 email:
 - stefano.diem@gmail.com
@@ -66,7 +66,7 @@ files:
 - .rspec
 - Gemfile
 - Guardfile
-- README.markdown
+- README.md
 - Rakefile
 - lib/pag_seguro.rb
 - lib/pag_seguro/checkout.xml.haml

data/README.markdown

@@ -1,9 +0,0 @@
-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