pagseguro-sdk 2.6.2

data/examples/direct/create_transaction_using_credit_card.rb

@@ -0,0 +1,128 @@
+require_relative "../boot"
+
+# Create Transaction Using Credit Card
+#
+# You need to set your AccountCredentials (EMAIL, TOKEN) in the application config
+#
+# P.S: See the boot file example for more details.
+
+payment = PagSeguro::CreditCardTransactionRequest.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-credit-card"
+payment.sender = {
+  hash: "f8d95a0747cdddf277a111ec1bab1d68628e095243b7a56382ec01f260216313",
+  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"
+  }
+}
+
+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

data/examples/direct/create_transaction_using_online_debit.rb

@@ -0,0 +1,104 @@
+require_relative "../boot"
+
+# Create Transaction Using Oline Debit
+#
+# You need to set your AccountCredentials (EMAIL, TOKEN) in the application config
+#
+# P.S: See the boot file example for more details.
+
+payment = PagSeguro::OnlineDebitTransactionRequest.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-online-debit"
+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"
+  }
+}
+
+payment.bank = {
+  name: "itau"
+}
+
+
+# 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/get_installments.rb

@@ -0,0 +1,40 @@
+require_relative "boot"
+
+# Get Installments
+#
+# Required AccountCredentials
+#
+#   You need to give:
+#     - amount
+#     - card_brand
+#     - account credentials (EMAIL, TOKEN)
+#
+#   You can pass these parameters to PagSeguro::Installment#find
+
+credentials = PagSeguro::AccountCredentials.new('EMAIL', 'TOKEN')
+
+options = {
+  credentials: credentials # Unnecessary if you set in application config
+}
+
+installments = PagSeguro::Installment.find("100.00", nil, options)
+
+if installments.errors.any?
+  puts installments.errors.join("\n")
+else
+  puts "=> INSTALLMENTS"
+  puts
+  installments.each do |installment|
+    puts installment.inspect
+  end
+
+  visa_installments = PagSeguro::Installment.find("100.00", :visa, options)
+
+  puts
+  puts "=> VISA INSTALLMENTS"
+  puts
+  visa_installments.each do |installment|
+    puts installment.inspect
+  end
+end
+

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