pagseguro-transparente 1.0.1 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 50c23ec1585127452ab5ef5825ab28c1f49d7890
-  data.tar.gz: 06b91010e1abc25b4134b3e8525abfa3dc63af30
+  metadata.gz: e5a03899badf0bd49904ceaeeb35c27721bf53d0
+  data.tar.gz: 438e7bf01d5ebabd5d1bf77ce6289539a37d96bd
 SHA512:
-  metadata.gz: 19c26ce1724c42fe0021c6719a4b8efe1c33783e878ec3c91649398b8a68fb7648f481ab69d260ddee439b8d5cf5832cd63dff3d23d116b1e76e7521e2b84594
-  data.tar.gz: 7f135a9e059b7c3d754a083f0d8e95df1657c2f7076dadcbc5a50ef620469f5479258820065d65bada411228055143743bf2b70dbacb39a488253b20153ae72d
+  metadata.gz: a993b7e1b3fb21edd4783d9cab6d074fffa81487fd10da0b0a5a25348bdabe099b9bbe167fb8d4a5e72fd60b270d945f432c33d878025b971b74ff037c9fd404
+  data.tar.gz: ebefe858aba1e89e7b405868b6cd5836aafb771a276721831905876c9823a91db86e25d5aa68cb20df2b351820a4469b51ab578bb93d86127f90d764367f9c64

data/README.md

@@ -1,6 +1,6 @@
 # PagSeguro Transparente
 
-Gem para a utilização do novo checkout transparente do Pagseguro.
+Gem para a utilização do novo [checkout transparente](https://pagseguro.uol.com.br/receba-pagamentos.jhtml#checkout-transparent) do Pagseguro. Essa forma de checkout permite que a compra seja realizada completamente em sua loja. Até o momento, para ter acesso a esse novo checkout é necessário entrar em contato com o PagSeguro para ter acesso a documentação.
 
 [![Build Status](https://travis-ci.org/eventick/pagseguro-transparente.svg?branch=master)](https://travis-ci.org/eventick/pagseguro-transparente)
 [![Coverage Status](https://coveralls.io/repos/eventick/pagseguro-transparente/badge.png)](https://coveralls.io/r/eventick/pagseguro-transparente)
@@ -17,15 +17,15 @@ PagSeguro é a solução completa para pagamentos online, que garante a seguran
 Ruby >= 1.9.3
 Rails >= 3.0
 
-##Como usar
+## Como usar
 
 Adicione a biblioteca ao arquivo Gemfile:
 ~~~.ruby
-gem "pagseguro-transparente", "~> 0.2.3"
+gem "pagseguro-transparente", "~> 1.0.1"
 ~~~
-* Ainda não publicada, é preciso baixar direto do Github.
 
-Criar um initializer em config/initializer/pagseguro.rb
+
+Criar um initializer em ```config/initializer/pagseguro.rb```
 ~~~.ruby
 PagSeguro.configure do |config|
     config.email = "exemplo@pagseguro.com.br"
@@ -33,42 +33,142 @@ PagSeguro.configure do |config|
 end
 ~~~
 
-##Criando uma nova sessão
+## Etapas do checkout transparente
+* Iniciar uma sessão de pagamento
+* Obter os meios de pagamento*
+* Obter a bandeira do cartão de crédito* (Cartão e crédito)
+* Obter o token do cartão de crédito* (Cartão de crédito)
+* Verificar as opções de parcelamento* (Cartão de crédito)
+* Obter a identificação do comprador
+* Efetuar o pagamento utilizando a API do Checkout Transparente
+
+```* Lib Javascript fornecidade pelo PagSeguro```
+
+## Iniciando uma nova sessão
 ~~~.ruby
 pagseguro_session = PagSeguro::Session.new
-@pagseguro_session_id = pagseguro_session.create.id
+pagseguro_session_id = pagseguro_session.create.id
 ~~~
 
-##Criando uma transação
-~~~.ruby
-payment = PagSeguro::Payment.new(notification_url: 'www.eventick.com.br', payment_method: 'boleto', reference: '1')
-items = [PagSeguro::Item.new(id: 1, description: 'Ingresso Teste', amount: 2, quantity: 1)]
-payment.items = items
+## Criando uma transação
 
+### Cartão de crédito
+~~~.ruby
+payment = PagSeguro::Payment.new(notification_url: 'www.eventick.com.br/notify', payment_method: 'creditCard', reference: '1')
+~~~
 
-phone = PagSeguro::Phone.new('81', '97550129')
-document = PagSeguro::Document.new('01735536300')
+#### Adicionando items
+~~~.ruby
+items = [PagSeguro::Item.new(id: 1, description: 'Ticket 1', amount: 2, quantity: 1), PagSeguro::Item.new(id: 2, description: 'Ticket 2', amount: 2, quantity: 1)]
+payment.items = items
+~~~
 
-sender = PagSeguro::Sender.new(email: 'cirdes@gmail.com', name: 'Cirdes Henrique', hash_id:  )
+#### Adicionando comprador
+~~~.ruby
+phone = PagSeguro::Phone.new('11', '999999999')
+document = PagSeguro::Document.new('111111111111')
+sender = PagSeguro::Sender.new(email: 'cirdes@eventick.com.br', name: 'Cirdes Henrique', hash_id: identificao_do_comprador )
 sender.phone = phone
 sender.document = document
-
 payment.sender = sender
+~~~.ruby
 
-address = PagSeguro::Address.new(postal_code: '52050040', street: 'Rua Teles Junior', number: '475', complement: '301', district: 'rosarinho', city: 'Recife', state: 'PE')
+#### Adicionando endereço do comprador ou endereço de cobrança para cartão de crédito
+~~~.ruby
+address = PagSeguro::Address.new(postal_code: '01318002', street: 'AV BRIGADEIRO LUIS ANTONIO', number: '1892', complement: '112', district: 'Bela Vista', city: 'São Paulo', state: 'SP')
 shipping = PagSeguro::Shipping.new
 shipping.address = address
-
 payment.shipping = shipping
+~~~
+
+#### Adicionando informações do cartão
+~~~.ruby
+credit_card = PagSeguro::CreditCard.new(creditcard_token)
+credit_card.installment = PagSeguro::Installment.new(installment_quantity, installment_value)
+credit_card.holder = PagSeguro::Holder.new(creditcard_name, creditcard_birthday)
+document = PagSeguro::Document.new('111111111111')
+credit_card.holder.document = document
+phone = PagSeguro::Phone.new('11', '999999999')
+credit_card.holder.phone = phone
+address = PagSeguro::Address.new(postal_code: zipcode, street: street, number: number, complement: extra, district: neighbourhood, city: city, state: state )
+credit_card.billing_address = mount_address
+payment.credit_card = credit_card
+~~~
+
+#### Efetuando a transação
+~~~.ruby
+transaction = payment.transaction
+~~~
+
+Ao efetuar a transação, será retornado um objeto ```PagSeguro::Transaction``` que você poderá usar para atualizar o status da compra.
+
+### Boleto
+Com o retorno da transação você pegará a url para imprimir o boleto.
+
+~~~.ruby
+payment = PagSeguro::Payment.new(notification_url: 'www.eventick.com.br/notify', payment_method: 'boleto', reference: '1')
+transaction = payment.transaction
+transaction.payment_link
+~~~
+
+### Débito bancário
+Você recebá a URL para redirecionar o usuário ao banco.
+Valores possívels para os bancos são: ```bradesco``` ```itau``` ```bancodobrasil``` ```banrisul``` ```hsbc```
+~~~.ruby
+payment = PagSeguro::Payment.new(notification_url: 'www.eventick.com.br/notify', payment_method: 'eft', reference: '1')
+payment.bank = PagSeguro::Bank.new('bradesco')
+
+transaction = payment.transaction
+transaction.payment_link
+~~~
+
+## Recebendo uma notificação de mundaça de status da transação
+A documentação da API de Notificações podem ser encontrada no (site)[https://pagseguro.uol.com.br/v3/guia-de-integracao/api-de-notificacoes.html] do PagSeguro. As notificações utilizam a versão V3 da API do PagSeguro.
+
+A notification_url informada como parâmetro da transação, irá receber um POST do PagSeguro informando que existe um atualização no status da transação. Para consultar o status da transação podemos utilizar o PagSeguroTransparent.
+
+~~~.ruby
+transaction = PagSeguro::Notification.new(notification_code, 'transaction').transaction
+~~~
+
+É possível verificar se a transação é uma transação válida, sem erros ou consultar os erros retornados pelo PagSeguro.
+~~~.ruby
+transaction.valid?
+transaction.errors
+~~~
 
-response = payment.register
+## API de Consulta
+A documentação da API de Consulta podem ser encontrada no (site)[https://pagseguro.uol.com.br/v3/guia-de-integracao/consulta-de-transacoes-por-codigo.html] do PagSeguro. As consultas utilizam a versão V3 da API do PagSeguro.
 
-response.payment_link
+~~~.ruby
+transaction = PagSeguro::Query.new(order_identifier).transaction
 ~~~
 
-Você deve redirecionar o usário para a url retornada para compras com boleto e débito bancário.
+## PagSeguro::Transaction
+A API de notificação, a API de consulta e de pagamento retornam um objeto da classe ```PagSeguro::Transaction. Transaction``` responde aos seguintes métodos:
+
+~~~.ruby
+date, last_event_date, code,reference, type, status, status_name, cancellation_source, payment_method, payment_link, gross_amount, discount_amount, escrow_end_date, net_amount, extra_amount, installment_count, items, sender, shipping, valid?, errors, fee_amount
+~~~
 
-This is a working in progress!
+## Suporte a múltipas contas
+É possível utilizar mais de uma conta do PagSeguro ao efetuar suas transações. A utilização de uma segunda conta pode ser útil caso alguma das contas tenha alguma customização que fazem sentido para apenas alguns tipos de compras.
+
+~~~.ruby
+PagSeguro.configure do |config|
+	config.email = 'email1@eventick.com.br'
+	config.token = 'token1'
+	config.alt_email = 'email2@eventick.com.br'
+	config.alt_token = 'token2'
+end
+~~~
+
+Em todos as chamadas a API é possível especificar qual conta deve ser utilizada. Caso o valor seja diferente de 'alternative' a conta principal será utilizada.
+
+~~~.ruby
+payment.transaction('alternative')
+PagSeguro::Notification.new(notification_code, 'transaction').transaction('alternative')
+~~~
 
 ## Contributing
 

data/lib/pagseguro/transaction.rb

@@ -83,7 +83,7 @@ module PagSeguro
     end
 
     def sender
-      Sender.new(transaction['sender'])
+      Sender.new(transaction['sender']) if transaction['sender']
     end
 
     def shipping

data/lib/pagseguro/version.rb

@@ -1,3 +1,3 @@
 module PagSeguro
-  VERSION = "1.0.1"
+  VERSION = "1.1.0"
 end

data/spec/pagseguro/transaction_spec.rb

@@ -3,7 +3,18 @@ require "spec_helper"
 describe PagSeguro::Transaction do
   let(:xml) { MultiXml.parse(xml_file) }
 
-  let(:xml_file) {
+  let(:sender) do
+    "<sender>
+      <name>José Comprador</name>
+      <email>comprador@uol.com.br</email>
+      <phone>
+        <areaCode>11</areaCode>
+        <number>56273440</number>
+      </phone>
+    </sender>"
+  end
+
+  let(:xml_file) do
     "<transaction>
         <date>2011-02-05T15:46:12.000-02:00</date>
         <lastEventDate>2011-02-15T17:39:14.000-03:00</lastEventDate>
@@ -24,8 +35,9 @@ describe PagSeguro::Transaction do
         <installmentCount>1</installmentCount>
         <escrowEndDate>2011-02-05T15:46:12.000-02:00</escrowEndDate>
         <cancellationSource>INTERNAL</cancellationSource>
+        #{sender}
     </transaction>"
-  }
+  end
 
   let(:response) { PagSeguro::Transaction.new(xml) }
 
@@ -63,6 +75,12 @@ describe PagSeguro::Transaction do
     it { expect(subject).to respond_to(:fee_amount) }
   end
 
+  context "response without sender" do
+    let(:sender) { "" }
+
+    its(:sender) { should be_nil }
+  end
+
   context "unsuccessfull transaction" do
     context "one error only" do
       let(:xml_file) {

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pagseguro-transparente
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.1.0
 platform: ruby
 authors:
 - Cirdes Henrique
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-03-16 00:00:00.000000000 Z
+date: 2015-07-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activemodel