pagseguro-oficial 2.5.0 → 2.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: fca1219acbd801903f2b2bb735bed9ce7803b064
-  data.tar.gz: 7b9daf1da4f391c5896fe9d53b20a18fd18786ea
+  metadata.gz: 1e753af9a11f3f30119c860834bf9bf329116a3e
+  data.tar.gz: fe1f186de7dc6723e836564c8207083603820fb1
 SHA512:
-  metadata.gz: 2a405d53942d7a402fce7510d23d1b0b37cddc78c4e5bb9e32cdbd3905a8af8e119c0160cf3fd02c9e933f7464c0200a3085da0b1555da81c50ca181997b8a35
-  data.tar.gz: 68a7d881ac81697f229c5d389dbc5d09446e416c9f3b9fa00555b640a1bddacba3dce5e000df4a1f809f787e05f6b1f35be20e87bd57c7caa1fc29f911473a42
+  metadata.gz: bed8920899306d08f3e0f59fb5ee727496308b7754ad9bf8226efae5f0f24716e8297999ccc8794ec77cbd8c402bd000d9c6580ba1c56e2d66f3212b8fe66c9c
+  data.tar.gz: 43b2bfdf5dee8de08dc45548e457a395b59ff680570e9a448afdd2d0ce2b5a23d75a538bf6a79ad5e43187393a9d7d2dc40bf03429d930c3dbc706a2c58d7a93

data/CHANGELOG.md

@@ -1,6 +1,18 @@
-## Next release - 2.5.0
+2.6.0
+
+- Assinatura
+- Adicionado arquivo de configuração docker e docker-compose
+- Atualização e refatoração de exemplos
+
+2.5.0
 
 - Atualizado a sintaxe do rspec
+- Cobertura de todos os tipos de erros http
+- Removido gems não usadas
+- Criado módulo de coleções
+- Adicionado parcelamento por receptor
+- Classe Refund renomeada para TransactionRefund
+- Requisição de autorização com conta existente ou sugestão de cadastro
 
 2.4.0
 

data/CONTRIBUTING.md

@@ -0,0 +1,39 @@
+PagSeguro is the a library to use [pagseguro's API](https://pagseguro.uol.com.br).
+
+It is officially maintened by pagseguro company.
+
+Please note that these rules should be acknowledged by everyone, but repository contributors might occasionally deviate from them for practical work, e.g. not fork the repository, but using a branch on the main repository. This should however be an exception.
+
+# Developing
+
+Please follow this steps:
+
+* *Fork* the project at github;
+
+* git clone your project, using:
+
+    % git clone git@github.com/<your-username-here>/ruby
+
+* Optionaly you can add main repository as upstream:
+
+    % git remote add upstream git@github.com:pagseguro/ruby.git
+
+* Make sure you are on the right branch, aka, `dev`:
+
+    % git checkout dev
+
+* Create your develop/feature branch:
+
+    % git checkout -b my-cool-feature
+
+* Make your changes of the files and, of course, ensure you write the related tests.
+
+* Send your work to your repository:
+
+    % git push origin my-cool-feature
+
+* Now, create a pull request using github. Don't forget to include a clear description of what the pull request want to change and/or fix.
+
+# Test
+
+It is essential, PR without tests will not be accepted (unless rare ocasions, e. g., changing examples, documentation, …).

data/Dockerfile

@@ -0,0 +1,20 @@
+from ruby:2.2.2
+
+env DEBIAN_FRONTEND noninteractive
+
+run sed -i '/deb-src/d' /etc/apt/sources.list
+run apt-get update
+run apt-get install -y build-essential
+
+workdir /tmp
+copy Gemfile Gemfile
+copy Gemfile.lock Gemfile.lock
+copy pagseguro-oficial.gemspec pagseguro-oficial.gemspec
+run mkdir -p lib/pagseguro
+copy lib/pagseguro/version.rb lib/pagseguro
+run bundle install
+
+run mkdir /app
+workdir /app
+
+cmd bash

data/README.md

@@ -369,6 +369,28 @@ PagSeguro.encoding = "UTF-8" # UTF-8 ou ISO-8859-1
 Encontre toda a documentação necessária para o checkout transparente aqui:
 https://github.com/pagseguro/ruby/blob/master/docs/transparent_checkout.md
 
+## Docker
+
+[Docker](http://www.docker.com/) é uma ferramenta open-source que cria uma
+camada de abstração e automação da virtualização do kernel do
+GNU/Linux[\*](https://en.wikipedia.org/wiki/Docker_(software)).
+
+Primeiro certifique-se de que o Docker está instalado e configurado
+corretamente, em seguida construa a imagem:
+
+    % docker build -t pagseguro .
+
+E para entrar na imagem:
+
+    % docker run --rm -it -v ${PWD}:/app pagseguro
+    root@5c480dd6e22a:/app#
+
+Ou se preferir você pode usar o
+[docker-compose](https://docs.docker.com/compose/):
+
+    % docker-compose run script
+    root@c6697abac095:/app#
+
 ## Dúvidas?
 
 Caso tenha dúvidas ou precise de suporte, acesse nosso [fórum].

data/docker-compose.yml

@@ -0,0 +1,5 @@
+script:
+  build: .
+  volumes:
+    - .:/app
+    - /usr/share/zoneinfo/America/Fortaleza:/etc/localtime:ro

data/examples/checkout/create_payment_request.rb

@@ -26,7 +26,7 @@ payment.reference = "REF1234"
 payment.sender = {
   name: "Nando Vieira",
   email: "fnando.vieira@gmail.com",
-  cpf: "21639716866",
+  document: { type: "CPF", value: "21639716866" },
   phone: {
     area_code: 11,
     number: "12345678"

data/examples/direct/create_transaction_using_boleto.rb

@@ -22,7 +22,7 @@ payment.sender = {
   hash: "7e215170790948f45e26175c2192c77e88c0e4c361a5860b99d2e9a97af982e6",
   name: "Joao Comprador",
   email: "joao@sandbox.pagseguro.com.br",
-  cpf: "75073461100",
+  document: { type: "CPF", value: "75073461100" },
   phone: {
     area_code: 11,
     number: "12345678"

data/examples/direct/create_transaction_using_credit_card.rb

@@ -22,7 +22,7 @@ payment.sender = {
   hash: "f8d95a0747cdddf277a111ec1bab1d68628e095243b7a56382ec01f260216313",
   name: "Joao Comprador",
   email: "joao@sandbox.pagseguro.com.br",
-  cpf: "75073461100",
+  document: { type: "CPF", value: "75073461100" },
   phone: {
     area_code: 11,
     number: "12345678"

data/examples/direct/create_transaction_using_online_debit.rb

@@ -22,7 +22,7 @@ payment.sender = {
   hash: "7e215170790948f45e26175c2192c77e88c0e4c361a5860b99d2e9a97af982e6",
   name: "Joao Comprador",
   email: "joao@sandbox.pagseguro.com.br",
-  cpf: "75073461100",
+  document: { type: "CPF", value: "75073461100" },
   phone: {
     area_code: 11,
     number: "12345678"

data/examples/preapproval/cancel_preapproval.rb

@@ -0,0 +1,26 @@
+require_relative '../boot'
+
+# Cancel a Subscription.
+#
+# You need to set your AccountCredentials (EMAIL, TOKEN) in the application
+# config.
+#
+# P.S: See the boot file example for more details.
+
+code = 'CODE'
+email = 'EMAIL'
+token = 'TOKEN'
+
+# Edit the lines above.
+
+cancel = PagSeguro::SubscriptionCanceller.new(subscription_code: code)
+
+cancel.credentials = PagSeguro::AccountCredentials.new(email, token)
+cancel.save
+
+if cancel.errors.any?
+  puts '=> ERRORS'
+  puts cancel.errors.join('\n')
+else
+  print '=> Subscription cancelled correctly.'
+end

data/examples/preapproval/change_preapproval_payment.rb

@@ -0,0 +1,50 @@
+require_relative '../boot'
+
+# Change a Payment.
+#
+# You need to set your AccountCredentials (EMAIL, TOKEN) in the application
+# config.
+#
+# P.S: See the boot file example for more details.
+
+email = 'EMAIL'
+token = 'TOKEN'
+
+new_payment = PagSeguro::SubscriptionChangePayment.new(
+  subscription_code: 'SUBSCRIPTION_CODE',
+  sender: {
+    hash: 'HASH',
+    ip: '192.168.0.1',
+  },
+  subscription_payment_method: {
+    token: 'TOKEN',
+    holder: {
+      name: 'Nome',
+      birth_date: Date.new(1984, 12, 31),
+      phone: { area_code: '11', number: '988881234' },
+      document: { type: 'CPF', value: '00000000191' },
+      billing_address: {
+        street: 'Av Brigadeira Faria Lima',
+        number: '1384',
+        complement: '3 andar',
+        district: 'Jd Paulistano',
+        city: 'Sao Paulo',
+        state: 'SP',
+        country: 'BRA',
+        postal_code: '01452002'
+      }
+    }
+  }
+)
+
+# Edit the lines above.
+
+new_payment.credentials = PagSeguro::AccountCredentials.new(email, token)
+new_payment.update
+
+if new_payment.errors.any?
+  puts '=> ERRORS'
+  puts new_payment.errors.join("\n")
+else
+  print '=> Subscription correct changed.'
+end

data/examples/preapproval/change_preapproval_status.rb

@@ -0,0 +1,29 @@
+require_relative "../boot"
+
+# Change Subscription Status
+#
+# You need to set:
+#   - AccountCredentials (EMAIL, TOKEN)
+#   - Subscription's code
+#   - The new status
+#
+# P.S: Take a look at the boot file example for more details
+
+user = 'user@example.com'
+token = 'TOKEN'
+code = 'CODE'
+status = :suspended # Now just available the status :active and :suspended
+
+credentials = PagSeguro::AccountCredentials.new('user@example.com', 'TOKEN')
+
+change = PagSeguro::SubscriptionChangeStatus.new(code, status)
+change.credentials = credentials
+change.save
+
+if change.errors.any?
+  puts "ERRORS: "
+  puts change.errors.inspect
+else
+  puts "SUCCESS"
+  puts change.inspect
+end

data/examples/preapproval/charge_preapproval.rb

@@ -0,0 +1,36 @@
+require_relative '../boot'
+
+# Charge a Manual Subscription.
+#
+# You also can set your AccountCredentials (EMAIL, TOKEN) in the application
+# config.
+#
+# See the boot file example for more details.
+
+email = 'EMAIL'
+token = 'TOKEN'
+
+charger = PagSeguro::ManualSubscriptionCharger.new(
+  reference: 'REFERENCE',
+  subscription_code: 'SUBSCRIPTION_CODE',
+)
+
+charger.items << {
+  id: '0001',
+  description: 'Seguro contra roubo',
+  amount: 100.0,
+  quantity: 1
+}
+
+# Edit the lines above.
+
+charger.credentials = PagSeguro::AccountCredentials.new(email, token)
+charger.create
+
+if charger.errors.any?
+  puts '=> ERRORS'
+  puts charger.errors.join("\n")
+else
+  print '=> Subscription was corrected charged, the transaction code is '
+  puts charger.transaction_code
+end

data/examples/preapproval/create_preapproval.rb

@@ -0,0 +1,68 @@
+require_relative '../boot'
+
+# Subscribe your client in a SubscriptionPlan (Transparent Checkout).
+#
+# You need to set your AccountCredentials (EMAIL, TOKEN) in the application config
+#
+# P.S: See the boot file example for more details.
+
+email = 'EMAIL'
+token = 'TOKEN'
+
+subscription = PagSeguro::Subscription.new(
+  plan: 'SUBSCRIPTION_CODE',
+  reference: 'SUB-1234',
+  sender: {
+    name: 'Comprador',
+    email: 'user@sandbox.pagseguro.com.br',
+    ip: '192.168.0.1',
+    hash: 'hash',
+    phone: {
+      area_code: 12,
+      number: '23456789'
+    },
+    document: { type: 'CPF', value: '23606838450' },
+    address: {
+      street: 'Av Brigadeira Faria Lima',
+      number: '1384',
+      complement: '3 andar',
+      district: 'Jd Paulistano',
+      city: 'Sao Paulo',
+      state: 'SP',
+      country: 'BRA',
+      postal_code: '01452002'
+    }
+  },
+  payment_method: {
+    token: 'TOKEN',
+    holder: {
+      name: 'Nome',
+      birth_date: '11/01/1984',
+      document: { type: 'CPF', value: '00000000191' },
+      billing_address: {
+        street: 'Av Brigadeira Faria Lima',
+        number: '1384',
+        complement: '3 andar',
+        district: 'Jd Paulistano',
+        city: 'Sao Paulo',
+        state: 'SP',
+        country: 'BRA',
+        postal_code: '01452002'
+      },
+      phone: { area_code: '11', number: '988881234' }
+    }
+  }
+)
+
+# Edit the lines above.
+
+subscription.credentials = PagSeguro::AccountCredentials.new(email, token)
+subscription.create
+
+if subscription.errors.any?
+  puts '=> ERRORS'
+  puts subscription.errors.join('\n')
+else
+  print '=> Subscription correct created, its code is '
+  puts subscription.code
+end

data/examples/preapproval/create_preapproval_auto.rb

@@ -0,0 +1,53 @@
+require_relative '../boot'
+
+# Create a Subscription Plan (Auto charge)
+#
+# You need to set your AccountCredentials (EMAIL, TOKEN) in the application config
+#
+# P.S: See the boot file example for more details.
+
+email = 'EMAIL'
+token = 'TOKEN'
+
+plan = PagSeguro::SubscriptionPlan.new(
+  charge: 'auto', # Automatic Subscription Plan must always use auto charge type.
+
+  redirect_url: 'http://www.lojateste.com.br/redirect',
+  review_url: 'http://www.lojateste.com.br/review',
+  reference: 'AUTOPLAN123',
+  name: 'Seguro contra roubo do Notebook',
+  details: 'Taxa referente ao seguro contra roubo de Notebook',
+  period: 'Monthly',
+  final_date: Time.new(2017, 2, 28, 20, 20),
+  amount: 100.0,
+  max_total_amount: 2400.0,
+
+  sender: {
+    name: 'Nome do Cliente',
+    email: 'client@example.com',
+    phone: { area_code: 11, number: 123456 },
+    address: {
+      street: 'Avenida Brigadeiro Faria Lima',
+      number: 1384,
+      complement: '1 Andar',
+      district: 'Jardim Paulistano',
+      postal_code: '01452002',
+      city: 'São Paulo',
+      state: 'SP',
+      country: 'BRA',
+    }
+  }
+)
+
+# Edit the lines above.
+
+plan.credentials = PagSeguro::AccountCredentials.new(email, token)
+plan.create
+
+if plan.errors.any?
+  puts '=> ERRORS'
+  puts plan.errors.join("\n")
+else
+  print '=> Subscription Plan correct created, its code is '
+  puts plan.code
+end

data/examples/preapproval/create_preapproval_discount.rb

@@ -0,0 +1,30 @@
+require_relative '../boot'
+
+# Create a Subscription Discount.
+#
+# You need to set your AccountCredentials (EMAIL, TOKEN) in the application
+# config.
+#
+# P.S: See the boot file example for more details.
+
+email = 'EMAIL'
+token = 'TOKEN'
+
+discount = PagSeguro::SubscriptionDiscount.new(
+  # The types of discount are DISCOUNT_PERCENT and DISCOUNT_AMOUNT.
+  type: 'DISCOUNT_AMOUNT',
+  value: 5.0,
+  code: 'PREAPPROVAL_CODE'
+)
+
+# Edit the lines above.
+
+discount.credentials = PagSeguro::AccountCredentials.new(email, token)
+discount.create
+
+if discount.errors.any?
+  puts '=> ERRORS'
+  puts discount.errors.join("\n")
+else
+  puts '=> Subscription Discount correct added.'
+end