pagseguro-sdk 2.6.2

data/examples/checkout/create_payment_request.rb

@@ -0,0 +1,63 @@
+# -*- encoding : utf-8 -*-
+require_relative "../boot"
+
+# Create Payment Request
+#
+# You need to set your AccountCredentials (EMAIL, TOKEN) in the application config
+#
+# P.S: See the boot file example for more details.
+
+payment = PagSeguro::PaymentRequest.new
+payment.abandon_url = "http://dev.simplesideias.com.br/?abandoned"
+payment.notification_url = "http://dev.simplesideias.com.br/?notification"
+payment.redirect_url = "http://dev.simplesideias.com.br/?redirect"
+
+# If you don't want to use payment request credentials you can use application config
+payment.credentials = PagSeguro::AccountCredentials.new('EMAIL', 'TOKEN')
+
+payment.items << {
+  id: 1234,
+  description: %[Televisão 19" Sony],
+  amount: 459.50,
+  weight: 0
+}
+
+payment.reference = "REF1234"
+payment.sender = {
+  name: "Nando Vieira",
+  email: "fnando.vieira@gmail.com",
+  document: { type: "CPF", value: "21639716866" },
+  phone: {
+    area_code: 11,
+    number: "12345678"
+  }
+}
+
+payment.shipping = {
+  type_name: "sedex",
+  address: {
+    street: "R. Vergueiro",
+    number: 1421,
+    complement: "Sala 213",
+    city: "São Paulo",
+    state: "SP",
+    district: "Vila Mariana"
+  }
+}
+
+# Add extras params to request
+# payment.extra_params << { paramName: 'paramValue' }
+# payment.extra_params << { senderBirthDate: '07/05/1981' }
+# payment.extra_params << { extraAmount: '-15.00' }
+
+puts "=> REQUEST"
+puts PagSeguro::PaymentRequest::RequestSerializer.new(payment).to_params
+
+response = payment.register
+
+puts
+puts "=> RESPONSE"
+puts response.url
+puts response.code
+puts response.created_at
+puts response.errors.to_a

data/examples/checkout/search/search_abandoned_transactions.rb

@@ -0,0 +1,41 @@
+require "active_support/all"
+require_relative "../../boot"
+
+# Search Abandoned Transactions
+#
+#   The acount credentials (EMAIL, TOKEN) are required
+#
+#   You can pass the credentials parameters to PagSeguro::Transaction#find_abandoned
+
+options = {
+  credentials: PagSeguro::AccountCredentials.new('EMAIL', 'TOKEN'),
+  starts_at: Time.new(2016, 2, 10, 14, 0),
+  ends_at: Time.new(2016, 2, 11, 14, 0),
+  per_page: 50
+  # You can pass more arguments by params, look (/lib/pagseguro/transaction.rb)
+}
+
+report = PagSeguro::Transaction.find_abandoned(options)
+
+# OR through the application settings like the boot file example (/examples/boot.rb)
+#
+# report = PagSeguro::Transaction.find_abandoned
+
+while report.next_page?
+  report.next_page!
+  puts "=> Fetching page #{report.page}"
+
+  abort "=> Errors: #{report.errors.join("\n")}" unless report.valid?
+
+  puts "=> Report was created at: #{report.created_at}"
+  puts
+
+  report.transactions.each do |transaction|
+    puts "=> Abandoned transaction"
+    puts "   created at: #{transaction.created_at}"
+    puts "   code: #{transaction.code}"
+    puts "   type_id: #{transaction.type_id}"
+    puts "   gross amount: #{transaction.gross_amount.to_f}"
+    puts
+  end
+end

data/examples/checkout/search/search_transaction_by_code.rb

@@ -0,0 +1,76 @@
+require_relative "../../boot"
+
+# Search Transaction by Code
+#
+#   You need to give:
+#     - transaction code
+#     - account credentials (EMAIL, TOKEN) OR application credentials (APP_ID, APP_KEY)
+#
+#   You can pass these parameters to PagSeguro::Transaction#find_by_code
+
+# credentials = PagSeguro::ApplicationCredentials.new('APP_ID', 'APP_KEY')
+credentials = PagSeguro::AccountCredentials.new('EMAIL', 'TOKEN')
+
+options = { credentials: credentials } # Unnecessary if you set in application config
+
+transaction = PagSeguro::Transaction.find_by_code("TRANSACTION_CODE", options)
+
+if transaction.errors.any?
+  puts transaction.errors.join("\n")
+else
+  puts "=> Transaction"
+  puts "  code: #{transaction.code}"
+  puts "  type: #{transaction.type_id}"
+  puts "  status: #{transaction.status.status}"
+  puts "  cancellation source: #{transaction.cancellation_source}"
+  puts "  escrow end date: #{transaction.escrow_end_date}"
+  puts "  payment method type: #{transaction.payment_method.type}"
+  puts "  gross amount: #{transaction.gross_amount.to_f}"
+  puts "  discount amount: #{transaction.discount_amount.to_f}"
+  puts "  operational fee amount: #{transaction.creditor_fees.operational_fee_amount.to_f}"
+  puts "  installment fee amount: #{transaction.creditor_fees.installment_fee_amount.to_f}"
+  puts "  intermediation rate amount: #{transaction.creditor_fees.intermediation_rate_amount.to_f}"
+  puts "  intermediation fee amount: #{transaction.creditor_fees.intermediation_fee_amount.to_f}"
+  puts "  commission fee amount: #{transaction.creditor_fees.commission_fee_amount.to_f}"
+  puts "  commission fee amount: #{transaction.creditor_fees.commission_fee_amount.to_f}"
+  puts "  efrete: #{transaction.creditor_fees.efrete.to_f}"
+  puts "  net amount: #{transaction.net_amount.to_f}"
+  puts "  extra amount: #{transaction.extra_amount.to_f}"
+
+  puts "    => Payments"
+  puts "      installment count: #{transaction.installments}"
+  transaction.payment_releases.each do |release|
+    puts "    current installment: #{release.installment}"
+    puts "    total amount: #{release.total_amount.to_f}"
+    puts "    release amount: #{release.release_amount.to_f}"
+    puts "    status: #{release.status}"
+    puts "    release date: #{release.release_date}"
+  end
+
+  puts "    => Items"
+  puts "      items count: #{transaction.items.size}"
+  transaction.items.each do |item|
+    puts "      item id: #{item.id}"
+    puts "      description: #{item.description}"
+    puts "      quantity: #{item.quantity}"
+    puts "      amount: #{item.amount.to_f}"
+    puts "      weight: #{item.weight}g"
+  end
+
+  puts "    => Sender"
+  puts "      name: #{transaction.sender.name}"
+  puts "      email: #{transaction.sender.email}"
+  puts "      phone: (#{transaction.sender.phone.area_code}) #{transaction.sender.phone.number}"
+  puts "      document: #{transaction.sender.document.type}: #{transaction.sender.document.value}"
+
+  puts "    => Shipping"
+  puts "      street: #{transaction.shipping.address.street}, #{transaction.shipping.address.number}"
+  puts "      complement: #{transaction.shipping.address.complement}"
+  puts "      postal code: #{transaction.shipping.address.postal_code}"
+  puts "      district: #{transaction.shipping.address.district}"
+  puts "      city: #{transaction.shipping.address.city}"
+  puts "      state: #{transaction.shipping.address.state}"
+  puts "      country: #{transaction.shipping.address.country}"
+  puts "      type: #{transaction.shipping.type_name}"
+  puts "      cost: #{transaction.shipping.cost}"
+end

data/examples/checkout/search/search_transaction_by_notification_code.rb

@@ -0,0 +1,76 @@
+require_relative "../../boot"
+
+# Search Transaction by Notification Code
+#
+#   You need to give:
+#     - transaction notification code
+#     - account credentials (EMAIL, TOKEN) OR application credentials (APP_ID, APP_KEY)
+#
+#   You can pass these parameters to PagSeguro::Transaction#find_by_code
+
+# credentials = PagSeguro::ApplicationCredentials.new('APP_ID', 'APP_KEY')
+credentials = PagSeguro::AccountCredentials.new('EMAIL', 'TOKEN')
+
+options = { credentials: credentials } # Unnecessary if you set in application config
+
+transaction = PagSeguro::Transaction.find_by_notification_code("NOTIFICATION_CODE", options)
+
+if transaction.errors.any?
+  puts transaction.errors.join("\n")
+else
+  puts "=> Transaction"
+  puts "  code: #{transaction.code}"
+  puts "  type: #{transaction.type_id}"
+  puts "  status: #{transaction.status.status}"
+  puts "  cancellation source: #{transaction.cancellation_source}"
+  puts "  escrow end date: #{transaction.escrow_end_date}"
+  puts "  payment method type: #{transaction.payment_method.type}"
+  puts "  gross amount: #{transaction.gross_amount.to_f}"
+  puts "  discount amount: #{transaction.discount_amount.to_f}"
+  puts "  operational fee amount: #{transaction.creditor_fees.operational_fee_amount.to_f}"
+  puts "  installment fee amount: #{transaction.creditor_fees.installment_fee_amount.to_f}"
+  puts "  intermediation rate amount: #{transaction.creditor_fees.intermediation_rate_amount.to_f}"
+  puts "  intermediation fee amount: #{transaction.creditor_fees.intermediation_fee_amount.to_f}"
+  puts "  commission fee amount: #{transaction.creditor_fees.commission_fee_amount.to_f}"
+  puts "  commission fee amount: #{transaction.creditor_fees.commission_fee_amount.to_f}"
+  puts "  efrete: #{transaction.creditor_fees.efrete.to_f}"
+  puts "  net amount: #{transaction.net_amount.to_f}"
+  puts "  extra amount: #{transaction.extra_amount.to_f}"
+
+  puts "    => Payments"
+  puts "      installment count: #{transaction.installments}"
+  transaction.payment_releases.each do |release|
+    puts "    current installment: #{release.installment}"
+    puts "    total amount: #{release.total_amount.to_f}"
+    puts "    release amount: #{release.release_amount.to_f}"
+    puts "    status: #{release.status}"
+    puts "    release date: #{release.release_date}"
+  end
+
+  puts "    => Items"
+  puts "      items count: #{transaction.items.size}"
+  transaction.items.each do |item|
+    puts "      item id: #{item.id}"
+    puts "      description: #{item.description}"
+    puts "      quantity: #{item.quantity}"
+    puts "      amount: #{item.amount.to_f}"
+    puts "      weight: #{item.weight}g"
+  end
+
+  puts "    => Sender"
+  puts "      name: #{transaction.sender.name}"
+  puts "      email: #{transaction.sender.email}"
+  puts "      phone: (#{transaction.sender.phone.area_code}) #{transaction.sender.phone.number}"
+  puts "      document: #{transaction.sender.document.type}: #{transaction.sender.document.value}"
+
+  puts "    => Shipping"
+  puts "      street: #{transaction.shipping.address.street}, #{transaction.shipping.address.number}"
+  puts "      complement: #{transaction.shipping.address.complement}"
+  puts "      postal code: #{transaction.shipping.address.postal_code}"
+  puts "      district: #{transaction.shipping.address.district}"
+  puts "      city: #{transaction.shipping.address.city}"
+  puts "      state: #{transaction.shipping.address.state}"
+  puts "      country: #{transaction.shipping.address.country}"
+  puts "      type: #{transaction.shipping.type_name}"
+  puts "      cost: #{transaction.shipping.cost}"
+end

data/examples/checkout/search/search_transaction_by_reference.rb

@@ -0,0 +1,36 @@
+require_relative "../../boot"
+
+# Search Transaction by Reference
+#
+#   You need to give:
+#     - reference code
+#     - account credentials (EMAIL, TOKEN)
+#
+#   You can pass these parameters to PagSeguro::Transaction#find_by_reference
+
+credentials = PagSeguro::AccountCredentials.new('EMAIL', 'TOKEN')
+
+options = { credentials: credentials } # Unnecessary if you set in application config
+
+transaction = PagSeguro::Transaction.find_by_reference("REFERENCE_CODE", options)
+
+while transaction.next_page?
+  transaction.next_page!
+  puts "== Page #{transaction.page}"
+  abort "=> Errors: #{transaction.errors.join("\n")}" unless transaction.valid?
+  puts "Report created on #{transaction.created_at}"
+  puts
+
+  transaction.transactions.each do |transaction|
+    puts "=> Transaction"
+    puts "   created_at: #{transaction.created_at}"
+    puts "   code: #{transaction.code}"
+    puts "   cancellation_source: #{transaction.cancellation_source}"
+    puts "   payment method: #{transaction.payment_method.type}"
+    puts "   gross amount: #{transaction.gross_amount.to_f}"
+    puts "   updated at: #{transaction.updated_at}"
+    puts "   status: #{transaction.status.status}"
+    puts
+  end
+end
+

data/examples/checkout/search/search_transactions_by_date.rb

@@ -0,0 +1,45 @@
+require_relative "../../boot"
+require "active_support/all"
+
+# Search Transactions by Date
+#
+#   You need to give:
+#     - reference code
+#     - account credentials (EMAIL, TOKEN)
+#
+#   You can pass these parameters to PagSeguro::Transaction#find_by_date
+
+credentials = PagSeguro::AccountCredentials.new('EMAIL', 'TOKEN')
+
+options = {
+  starts_at: 29.days.ago,
+  per_page: 1,
+  credentials: credentials # Unnecessary if you set in application config
+}
+
+report = PagSeguro::Transaction.find_by_date(options)
+
+while report.next_page?
+  report.next_page!
+  puts "== Page #{report.page}"
+  abort "=> Errors: #{report.errors.join("\n")}" unless report.valid?
+  puts "Report created on #{report.created_at}"
+  puts
+
+  report.transactions.each do |transaction|
+    puts "=> Transaction"
+    puts "   created_at: #{transaction.created_at}"
+    puts "   code: #{transaction.code}"
+    puts "   cancellation_source: #{transaction.cancellation_source}"
+    puts "   type: #{transaction.type_id}"
+    puts "   status: #{transaction.status.status}"
+    puts "   payment method: #{transaction.payment_method.type}"
+    puts "   gross amount: #{transaction.gross_amount.to_f}"
+    puts "   discount amount: #{transaction.discount_amount.to_f}"
+    puts "   net amount: #{transaction.net_amount.to_f}"
+    puts "   extra amount: #{transaction.extra_amount.to_f}"
+    puts "   updated at: #{transaction.updated_at}"
+    puts "   status: #{transaction.status.status}"
+    puts
+  end
+end

data/examples/create_session.rb

@@ -0,0 +1,19 @@
+require_relative "boot"
+
+# Create Session
+#
+# You need to set your AccountCredentials (EMAIL, TOKEN) in the application config
+#
+# P.S: See the boot file example for more details.
+
+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/direct/create_transaction_using_boleto.rb

@@ -0,0 +1,100 @@
+require_relative "../boot"
+
+# Create Transaction Using Boleto
+#
+# You need to set your AccountCredentials (EMAIL, TOKEN) in the application config
+#
+# P.S: See the boot file example for more details
+
+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",
+  document: { type: "CPF", value: "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