pagseguro-oficial 2.1.1 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e9b1b2e0adeabe9b5ea466ca2c8ce25c9b89362f
-  data.tar.gz: 40bea3b901045da2b170bfb1782ef3eb63a62815
+  metadata.gz: 195f2fa2ef3756e03ccdde0b6e0d6dd6f632edf3
+  data.tar.gz: 159f0ddf89ed6d5bd3e25e13d8c292456466be3d
 SHA512:
-  metadata.gz: 499bf71c2fb90813ac226126976c7574ecbcf0d2e883fdae3ffe51c2c2f56553f76622a05a3941854c4dfcbb232d41db441b48aa0e759a098b7972ff6dae5211
-  data.tar.gz: 2405a5be45744b83c9eecfccd9875f119081d307280d7ce7ad53c1f0b81f5d7a7212cb7229afd8677e3a30cf56f851941b5e2d4d040bf4da06632f617438e012
+  metadata.gz: 4e648a26a4dedcc676c19a3f2f9158db9672993529d18889af97bf3bcd9314a2428dbca8c8e3232b78b33d63d852791a5d55c2c5aae83d33e040035d9072cbac
+  data.tar.gz: c265b5e829a21f3ecf99e8fcc3efd6cb956f252bc5806c8e23fd8fa64474e5a1eb74600333641bd1d60285fee6201256896ed1036e2ae7f494d2bee93eadc597

data/.travis.yml

@@ -1,12 +1,14 @@
 language: ruby
 rvm:
-  - 2.2.0
-  - 2.1.5
+  - 2.2.2
+  - 2.1.6
   - 2.0.0
   - 1.9.3
   - jruby-19mode
-
 notifications:
   email:
-    - lucas.renan@codeminer42.com
-    - vitor.kusiaki@codeminer42.com
+  - lucas.renan@codeminer42.com
+  - vitor.kusiaki@codeminer42.com
+  - dmitry.rocha@codeminer42.com
+  slack:
+    secure: H7PR+eH28CRGZ7E71EQ2xAjkbLX53eXbJ8nadHgx6W2gggNSB8UPw6gqQg/UC0lCbK6ejQ0wE/pEPfLBnCJkqL8mfBr7ADTqZe2fM/YxXQktdOlldJtZaxUikDwOWZSXdOG+3ITdbv/MQW/wehi8UWzFC+XkhJCudOPW1n+9bqs=

data/CHANGELOG.md

@@ -51,4 +51,3 @@
  - Criação de checkouts via API.
  - Tratamento de notificações de pagamento enviadas pelo PagSeguro.
  - Consulta de transações.
-

data/README.md

@@ -26,7 +26,7 @@ A biblioteca PagSeguro em Ruby é um conjunto de classes de domínio que facilit
  - Adicione a biblioteca ao seu Gemfile.
 
 ```ruby
-gem "pagseguro-oficial", "~> 2.1.1"
+gem "pagseguro-oficial", "~> 2.2.0"
 ```
 
  - Execute o comando `bundle install`.
@@ -294,6 +294,11 @@ PagSeguro.environment = "production" # production ou sandbox
 PagSeguro.encoding = "UTF-8" # UTF-8 ou ISO-8859-1
 ```
 
+## Checkout Transparente
+
+Encontre toda a documentação necessária para o checkout transparente aqui:
+https://github.com/pagseguro/ruby/blob/master/docs/transparent_checkout.md
+
 ## Dúvidas?
 
 Caso tenha dúvidas ou precise de suporte, acesse nosso [fórum].

data/docs/transparent_checkout.md

@@ -0,0 +1,201 @@
+# Checkout Transparente
+
+Integrando seu sistema de comércio eletrônico com o Checkout Transparente você pode oferecer toda a segurança e comodidade do PagSeguro para os seus clientes no momento da compra, sem precisar sair do seu site ou e-commerce. Com ele é possível disponibilizar em seu site os meios de pagamento Cartão de Crédito, Débito Online e Boleto.
+
+O Checkout Transparente está disponível para contas do tipo Vendedor e Empresarial. As seções seguintes indicarão como é possível integrar seu sistema de pagamentos ao Checkout Transparente do PagSeguro.
+
+A API do Checkout Transparente oferece maior controle e flexibilidade sobre o processo de pagamento. Com essa integração o cliente fica no ambiente do seu e-commerce ou site durante todo o processo de compra, sem necessidade de cadastro ou páginas intermediárias de pagamento.
+Para essa integração o PagSeguro criou alguns serviços que juntos possibilitam construir um checkout integrado, seguro e invisível para o comprador.
+
+## Integração
+
+Para fazer a integração do Checkout Transparente, você precisa seguir os seguintes passos:
+
+- Iniciar uma sessão de pagamento (Todos os meios de pagamento)
+- Obter a bandeira do cartão de crédito (Apenas para Cartão de Crédito)
+- Obter o token do cartão de crédito (Apenas para Cartão de Crédito)
+- Verificar as opções de parcelamento (Apenas para Cartão de Crédito)
+- Obter a identificação do comprador (Todos os meios de pagamento)
+- Efetuar o pagamento utilizando a API do Checkout Transparente (Todos os meios de pagamento)
+
+### Iniciar Sessão de Pagamento
+
+Para iniciar um Checkout Transparente é necessário ter um ID de sessão válido. Este serviço retorna o ID de sessão que será usado nas chamadas JavaScript.
+
+```ruby
+  session = PagSeguro::Session.create
+  @session_id = session.id
+```
+
+### Integrações no browser
+
+A API do Checkout Transparente possui funções JavaScript para algumas operações que devem ser executadas no browser do cliente, funções que serão descritas mais adiante. Para essas funções uma API JavaScript deve ser importada no final da página dos meios de pagamento:
+
+```html
+produção:
+<script type="text/javascript" src="https://stc.pagseguro.uol.com.br/pagseguro/api/v2/checkout/pagseguro.directpayment.js"></script>
+
+sandbox:
+<script type="text/javascript" src="https://stc.sandbox.pagseguro.uol.com.br/pagseguro/api/v2/checkout/pagseguro.directpayment.js"></script>
+```
+
+Esse JavaScript possui um objeto chamado `PagSeguroDirectPayment`, que é a interface de acesso aos métodos. Após importar o arquivo, deve ser executado o método `setSessionId` com o ID de sessão gerado anteriormente.
+
+```javascript
+  PagSeguroDirectPayment.setSessionId('<%= @session_id %>');
+```
+
+Nas funções, os eventos de sucesso e erro ocorrem em chamadas callback no JavaScript que são passadas via JSON. Para isso, basta passar três funções JavaScript com nome 'success', 'error' e 'complete' via JSON na chamada dos métodos. A função 'complete' será chamada independente do retorno e as funções 'success' e 'error' serão chamadas dependendo do retorno, ou seja, se o retorno não possuir erro a função chamada será a 'success' e se possuir erro a função chamada será a 'error'.
+
+### Obter identificação do comprador
+
+Para realizar o Checkout Transparente á necessário enviar um identificador do comprador gerado pelo JavaScript. Para isso você deve utilizar o método `getSenderHash`. Esse método não possui parâmetros e retorna um identificador. O identificador é obrigatório para todos os meios de pagamento.
+
+```javascript
+  PagSeguroDirectPayment.getSenderHash();
+```
+
+**Atenção:** Esse método possui algumas dependências e por isso recomendamos que o `getSenderHash` não seja executado no onLoad da página. Você pode executá-lo, por exemplo, quando o cliente clicar no botão de conclusão de pagamento.
+
+### Obter bandeira do cartão de crédito
+
+Esse processo é necessário somente para o meio de pagamento **cartão de crédito**. O método `getBrand` é utilizado para verificar qual a bandeira do cartão que está sendo digitado. Esse método recebe por parâmetro o BIN do cartão (seis primeiros dígitos do cartão) e retorna dados como qual a bandeira, o tamanho do CVV, se possui data de expiração e qual algoritmo de validação. A chamada desse serviço não é obrigatória.
+
+Exemplo:
+
+```javascript
+  PagSeguroDirectPayment.getBrand({
+    cardBin: $("input#cartao").val(),
+    success: function (response) {
+      //bandeira encontrada
+    },
+    error: function (response) {
+      //tratamento do erro
+    },
+    complete: function (response) {
+      //tratamento comum para todas chamadas
+    }
+  });
+```
+
+Retorno:
+
+```javascript
+  {
+    "brand": {
+      "name":"visa",
+      "bin":411111,
+      "cvvSize":3,
+      "expirable":true,
+      "validationAlgorithm":"LUHN"
+    }
+  }
+```
+
+### Obter token do cartão de crédito
+
+Esse processo é necessário somente para o meio de pagamento **cartão de crédito**. O método `createCardToken` é utilizado para gerar o token que representará o cartão de crédito na chamada para a API do Checkout Transparente. Este método recebe os seguintes dados: número do cartão (obrigatório), CVV (opcional para alguns cartões), data de expiração (opcional para alguns cartões) e a bandeira (opcional).
+
+Exemplo:
+
+```javascript
+  var params = {
+    cardNumber: $("input#cartao").val(),
+    cvv: $("input#cvv").val(),
+    expirationMonth: $("input#validadeMes").val(),
+    expirationYear: $("input#validadeAno").val(),
+    success: function (response) {
+      //token gerado, esse deve ser usado na chamada da API do Checkout Transparente
+    },
+    error: function (response) {
+      //tratamento do erro
+    },
+    complete: function (response) {
+      //tratamento comum para todas chamadas
+    }
+  }
+
+  // parâmetro opcional para qualquer chamada
+  if($("input#bandeira").val() !== '') {
+    params.brand = $("input#bandeira").val();
+  }
+
+  PagSeguroDirectPayment.createCardToken(params);
+```
+
+Retorno:
+
+```javascript
+  {
+    "card":{
+      "token":"653fe9044cf149f9b7db562431cb130d"
+    }
+  }
+```
+
+### Obter opções de parcelamento
+
+Esse processo é necessário apenas para o meio de pagamento **cartão de crédito**. Caso queira mostrar as opções de parcelamento para o comprador, você deverá utilizar o método `getInstallments`. Esse método recebe o valor a ser parcelado (obrigatório) e a bandeira que se deseja obter o parcelamento, retornando as configurações de cada parcela sendo: valor total do pagamento (que deve ser enviado junto na API do Checkout Transparente), valor e quantidade da parcela (que também devem ser informados na API do Checkout Transparente) e um indicador se aquela parcela tem juros ou não (caso o vendedor tenha configurado uma promoção no PagSeguro).
+
+Se não for informado uma bandeira como parâmetro na chamada, o método retornará os dados para todas bandeiras aceitas pelo PagSeguro.
+
+Exemplo:
+
+```javascript
+  PagSeguroDirectPayment.getInstallments({
+    amount: $("input#valorPagto").val(),
+    brand: $("input#bandeira").val(),
+    success: function (response) {
+      //opções de parcelamento disponíveis
+    },
+    error: function (response) {
+      //tratamento do erro
+    },
+    complete: function (response) {
+      //tratamento comum para todas chamadas
+    }
+  });
+```
+
+Retorno:
+
+```javascript
+  {
+    "error":false,
+    "installments":{
+      "visa":
+      [
+        {
+          "quantity":1,
+          "totalAmount":16,
+          "installmentAmount":16,
+          "interestFree":true
+        },
+        {
+          "quantity":2,
+          "totalAmount":16.48,
+          "installmentAmount":8.24,
+          "interestFree":false
+        },
+        {
+          "quantity":3,
+          "totalAmount":16.64,
+          "installmentAmount":5.55,
+          "interestFree":false
+        }
+      ]
+    }
+  }
+```
+
+## API do Checkout Transparente
+
+Este serviço envia os dados do comprador e do pagamento para realizar a cobrança.
+
+A criação das transações podem ser feitas utilizando três métodos de pagamento:
+
+[Boleto Bancário](https://github.com/pagseguro/ruby/blob/master/examples/boleto_transaction_request.rb)
+
+[Cartão de Crédito](https://github.com/pagseguro/ruby/blob/master/examples/credit_card_transaction_request.rb)
+
+[Transferência Eletrônica](https://github.com/pagseguro/ruby/blob/master/examples/online_debit_transaction.rb)

data/examples/boleto_transaction_request.rb

@@ -0,0 +1,94 @@
+require_relative "boot"
+
+payment = PagSeguro::BoletoTransactionRequest.new
+payment.notification_url = "http://www.meusite.com.br/notification"
+payment.payment_mode = "default"
+
+payment.items << {
+  id: 1234,
+  description: %[Televisão 19" Sony],
+  amount: 459.50,
+  weight: 0
+}
+
+payment.reference = "REF1234-boleto"
+payment.sender = {
+  hash: "7e215170790948f45e26175c2192c77e88c0e4c361a5860b99d2e9a97af982e6",
+  name: "Joao Comprador",
+  email: "joao@sandbox.pagseguro.com.br",
+  cpf: "75073461100",
+  phone: {
+    area_code: 11,
+    number: "12345678"
+  }
+}
+
+payment.shipping = {
+  type_name: "sedex",
+  address: {
+    street: "Av. Brig. Faria Lima",
+    number: "1384",
+    complement: "5º andar",
+    city: "São Paulo",
+    state: "SP",
+    district: "Jardim Paulistano",
+    postal_code: "01452002"
+  }
+}
+
+
+# Add extras params to request
+# payment.extra_params << { paramName: 'paramValue' }
+# payment.extra_params << { senderBirthDate: '07/05/1981' }
+
+puts "=> REQUEST"
+puts PagSeguro::TransactionRequest::RequestSerializer.new(payment).to_params
+puts
+
+payment.create
+
+if payment.errors.any?
+  puts "=> ERRORS"
+  puts payment.errors.join("\n")
+else
+  puts "=> Transaction"
+  puts "  code: #{payment.code}"
+  puts "  reference: #{payment.reference}"
+  puts "  type: #{payment.type_id}"
+  puts "  payment link: #{payment.payment_link}"
+  puts "  status: #{payment.status}"
+  puts "  payment method type: #{payment.payment_method}"
+  puts "  created at: #{payment.created_at}"
+  puts "  updated at: #{payment.updated_at}"
+  puts "  gross amount: #{payment.gross_amount.to_f}"
+  puts "  discount amount: #{payment.discount_amount.to_f}"
+  puts "  net amount: #{payment.net_amount.to_f}"
+  puts "  extra amount: #{payment.extra_amount.to_f}"
+  puts "  installment count: #{payment.installment_count}"
+
+  puts "    => Items"
+  puts "      items count: #{payment.items.size}"
+  payment.items.each do |item|
+    puts "      item id: #{item.id}"
+    puts "      description: #{item.description}"
+    puts "      quantity: #{item.quantity}"
+    puts "      amount: #{item.amount.to_f}"
+  end
+
+  puts "    => Sender"
+  puts "      name: #{payment.sender.name}"
+  puts "      email: #{payment.sender.email}"
+  puts "      phone: (#{payment.sender.phone.area_code}) #{payment.sender.phone.number}"
+  puts "      document: #{payment.sender.document}"
+
+  puts "    => Shipping"
+  puts "      street: #{payment.shipping.address.street}, #{payment.shipping.address.number}"
+  puts "      complement: #{payment.shipping.address.complement}"
+  puts "      postal code: #{payment.shipping.address.postal_code}"
+  puts "      district: #{payment.shipping.address.district}"
+  puts "      city: #{payment.shipping.address.city}"
+  puts "      state: #{payment.shipping.address.state}"
+  puts "      country: #{payment.shipping.address.country}"
+  puts "      type: #{payment.shipping.type_name}"
+  puts "      cost: #{payment.shipping.cost}"
+end

data/examples/create_session.rb

@@ -0,0 +1,13 @@
+require_relative "boot"
+
+session = PagSeguro::Session.create
+
+if session.errors.any?
+  puts "=> ERRORS"
+  puts session.errors.join("\n")
+  puts session.inspect
+else
+  puts "=> SESSION"
+  puts session.id
+  puts session.inspect
+end

data/examples/credit_card_transaction_request.rb

@@ -0,0 +1,122 @@
+require_relative "boot"
+
+payment = PagSeguro::CreditCardTransactionRequest.new
+payment.notification_url = "http://www.meusite.com.br/notification"
+payment.payment_mode = "gateway"
+
+payment.items << {
+  id: 1234,
+  description: %[Televisão 19" Sony],
+  amount: 459.50,
+  weight: 0
+}
+
+payment.reference = "REF1234-credit-card"
+payment.sender = {
+  hash: "f8d95a0747cdddf277a111ec1bab1d68628e095243b7a56382ec01f260216313",
+  name: "Joao Comprador",
+  email: "joao@sandbox.pagseguro.com.br",
+  cpf: "75073461100",
+  phone: {
+    area_code: 11,
+    number: "12345678"
+  }
+}
+
+payment.shipping = {
+  type_name: "sedex",
+  address: {
+    street: "Av. Brig. Faria Lima",
+    number: "1384",
+    complement: "5º andar",
+    city: "São Paulo",
+    state: "SP",
+    district: "Jardim Paulistano",
+    postal_code: "01452002"
+  }
+}
+
+payment.billing_address = {
+  street: "Av. Brig. Faria Lima",
+  number: "1384",
+  complement: "5º andar",
+  city: "São Paulo",
+  state: "SP",
+  district: "Jardim Paulistano",
+  postal_code: "01452002"
+}
+
+payment.credit_card_token = "41c1f784216748ccae689fcd854aaca1"
+payment.holder = {
+  name: "João Comprador",
+  birth_date: "07/05/1981",
+  document: {
+    type: "CPF",
+    value: "00000000191"
+  },
+  phone: {
+    area_code: 11,
+    number: "123456789"
+  }
+}
+
+payment.installment = {
+  value: 459.50,
+  quantity: 1
+}
+
+# Add extras params to request
+# payment.extra_params << { paramName: 'paramValue' }
+# payment.extra_params << { senderBirthDate: '07/05/1981' }
+
+puts "=> REQUEST"
+puts PagSeguro::TransactionRequest::RequestSerializer.new(payment).to_params
+puts
+
+payment.create
+
+if payment.errors.any?
+  puts "=> ERRORS"
+  puts payment.errors.join("\n")
+else
+  puts "=> Transaction"
+  puts "  code: #{payment.code}"
+  puts "  reference: #{payment.reference}"
+  puts "  type: #{payment.type_id}"
+  puts "  payment link: #{payment.payment_link}"
+  puts "  status: #{payment.status}"
+  puts "  payment method type: #{payment.payment_method}"
+  puts "  created at: #{payment.created_at}"
+  puts "  updated at: #{payment.updated_at}"
+  puts "  gross amount: #{payment.gross_amount.to_f}"
+  puts "  discount amount: #{payment.discount_amount.to_f}"
+  puts "  net amount: #{payment.net_amount.to_f}"
+  puts "  extra amount: #{payment.extra_amount.to_f}"
+  puts "  installment count: #{payment.installment_count}"
+
+  puts "    => Items"
+  puts "      items count: #{payment.items.size}"
+  payment.items.each do |item|
+    puts "      item id: #{item.id}"
+    puts "      description: #{item.description}"
+    puts "      quantity: #{item.quantity}"
+    puts "      amount: #{item.amount.to_f}"
+  end
+
+  puts "    => Sender"
+  puts "      name: #{payment.sender.name}"
+  puts "      email: #{payment.sender.email}"
+  puts "      phone: (#{payment.sender.phone.area_code}) #{payment.sender.phone.number}"
+  puts "      document: #{payment.sender.document}: #{payment.sender.document}"
+
+  puts "    => Shipping"
+  puts "      street: #{payment.shipping.address.street}, #{payment.shipping.address.number}"
+  puts "      complement: #{payment.shipping.address.complement}"
+  puts "      postal code: #{payment.shipping.address.postal_code}"
+  puts "      district: #{payment.shipping.address.district}"
+  puts "      city: #{payment.shipping.address.city}"
+  puts "      state: #{payment.shipping.address.state}"
+  puts "      country: #{payment.shipping.address.country}"
+  puts "      type: #{payment.shipping.type_name}"
+  puts "      cost: #{payment.shipping.cost}"
+end