pagseguro-sdk 2.6.2

data/examples/request_transaction_cancellation.rb

@@ -0,0 +1,19 @@
+require_relative "boot"
+
+# Request Transaction Cancellation
+#
+#   You need:
+#     - give TRANSACTION CODE to TransactionCancellation#transaction_code
+#     - set your AccountCredentials (EMAIL, TOKEN) in the application config (P.S.: See the boot file example)
+
+cancellation = PagSeguro::TransactionCancellation.new
+cancellation.transaction_code = "AFB8FCF29496401681257C1ECE3A98FF"
+
+cancellation.register
+
+if cancellation.errors.any?
+  puts cancellation.errors.join("\n")
+else
+  puts "=> CANCELLATION RESPONSE"
+  puts cancellation.result
+end

data/examples/split_payment/create_authorization.rb

@@ -0,0 +1,32 @@
+require_relative "../boot"
+
+# Create Authorization
+#
+#   You need to give:
+#     - notification_url
+#     - redirect_url
+#     - permissions defaults to all permissions
+#     - applications credentials (APP_ID, APP_KEY)
+#
+#   You can pass these parameters to PagSeguro::AuthorizationRequest#new
+#
+# PS: For more details look the class PagSeguro::AuthorizationRequest
+
+credentials = PagSeguro::ApplicationCredentials.new('APP_ID', 'APP_KEY')
+
+options = {
+  credentials: credentials, # Unnecessary if you set in application config
+  permissions: [:checkouts],
+  notification_url: 'http://example.com/',
+  redirect_url: 'http://example.com/',
+  reference: 'REF4321' # optional
+}
+
+authorization_request = PagSeguro::AuthorizationRequest.new(options)
+
+if authorization_request.create
+  print "Use this link to confirm authorizations: "
+  puts authorization_request.url
+else
+  puts authorization_request.errors.join("\n")
+end

data/examples/split_payment/create_payment_request.rb

@@ -0,0 +1,71 @@
+require_relative "../boot"
+
+# Create Split Payment.
+#
+# You need to set your ApplicationCredentials (EMAIL, TOKEN) in the application
+# config.
+#
+# P.S: See the boot file example for more details.
+
+payment = PagSeguro::PaymentRequest.new
+payment.abandon_url = "http://example.com/?abandoned"
+payment.notification_url = "http://example.com/?notification"
+payment.redirect_url = "http://example.com/?redirect"
+
+# If you don't want to use the application config, you can give your credentials
+# object to payment request.
+
+payment.credentials = PagSeguro::ApplicationCredentials.new('APP_ID', 'APP_KEY')
+
+payment.items << {
+  id: 1234,
+  description: %[Televisão 19" Sony],
+  quantity: 1,
+  amount: 459.50,
+  shipping_cost: 0.0,
+  weight: 0
+}
+
+payment.primary_receiver = 'primary.receiver@example.com'
+
+payment.receivers = [
+  {
+    email: 'other.receiver@example.com',
+    split: { amount: '400.00', },
+  }
+]
+
+payment.reference = "REF1234"
+payment.sender = {
+  name: "Sender One",
+  email: "sender@example.com",
+  document: { type: "CPF", value: "75073461100" },
+  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"
+  }
+}
+
+puts "=> REQUEST"
+puts PagSeguro::PaymentRequest::RequestSerializer.new(payment).to_xml_params
+
+response = payment.register
+
+puts
+puts "=> RESPONSE"
+puts response.url
+puts response.code
+puts response.created_at
+puts response.errors.to_a

data/examples/split_payment/create_transaction_using_boleto.rb

@@ -0,0 +1,118 @@
+require_relative "../boot"
+
+# Create Transaction Using Boleto and Split Payment
+#
+# 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.example.com/notification"
+payment.payment_mode = "default"
+payment.credentials = PagSeguro::ApplicationCredentials.new("APP_ID", "APP_KEY")
+
+payment.items << {
+  id: 1234,
+  description: %[Televisão 19" Sony],
+  amount: 50.0,
+  weight: 0
+}
+
+payment.reference = "REF1234-boleto"
+payment.sender = {
+  hash: "32fb09327a27b0a09a194a21d00be6d922fba5cfcdba03f15b3408029b56d41a",
+  name: "Joao Comprador",
+  email: "joao.comprador@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.receivers = [
+  {
+    public_key: 'PUBAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA',
+    split: {
+      amount: 20.0,
+      rate_percent: 50.0,
+      fee_percent: 50.0
+    }
+  }
+]
+
+# 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 "    => Receivers"
+  puts "      receivers count: #{payment.receivers.size}"
+  payment.receivers.each do |receiver|
+    puts "      email: #{receiver.email}"
+    puts "      amount: #{receiver.split.amount}"
+  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/split_payment/create_transaction_using_credit_card.rb

@@ -0,0 +1,152 @@
+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.
+
+app_id = 'APP_ID'
+app_key = 'APP_KEY'
+
+payment = PagSeguro::CreditCardTransactionRequest.new
+payment.notification_url = "http://www.lojateste.com.br/notification"
+payment.payment_mode = "default"
+payment.credentials = PagSeguro::ApplicationCredentials.new(app_id, app_key)
+
+payment.items << {
+  id: 1234,
+  description: %[Televisão 19" Sony],
+  amount: 100.0,
+  weight: 0
+}
+
+payment.reference = "REF1234-credit-card"
+payment.sender = {
+  hash: "9aff5821b4a6f5a1dc9e15d3a3b02ac666a1629fcb90e2bbf6b7da661b344094",
+  name: "Joao Comprador",
+  email: "EMAIL_FROM@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.receivers = [
+  {
+    public_key: 'PUBLIC_KEY',
+    split: {
+      amount: 20.0,
+      rate_percent: 50.0,
+      fee_percent: 50.0
+    }
+  }
+]
+
+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 = "CREDIT_CARD_TOKEN"
+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: 100.0,
+  quantity: 1
+}
+
+# Add extras params to request
+# payment.extra_params << { paramName: 'paramValue' }
+# payment.extra_params << { senderBirthDate: '07/05/1981' }
+
+# Edit the lines above.
+
+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 "    => Receivers"
+  puts "      receivers count: #{payment.receivers.size}"
+  payment.receivers.each do |receiver|
+    puts "      email: #{receiver.email}"
+    puts "      amount: #{receiver.split.amount}"
+  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/lib/pagseguro-oficial.rb

@@ -0,0 +1 @@
+require "pagseguro"

data/lib/pagseguro.rb

@@ -0,0 +1,221 @@
+require "bigdecimal"
+require "forwardable"
+require "time"
+
+require "nokogiri"
+require "aitch"
+require "i18n"
+
+require "pagseguro/extensions/mass_assignment"
+require "pagseguro/extensions/ensure_type"
+require "pagseguro/extensions/credentiable"
+require "pagseguro/extensions/collection_object"
+
+require "pagseguro/version"
+require "pagseguro/config"
+
+require "pagseguro/account_credentials"
+require "pagseguro/application_credentials"
+require "pagseguro/authorization"
+require "pagseguro/authorization/collection"
+require "pagseguro/authorization/request_serializer"
+require "pagseguro/authorization/response_serializer"
+require "pagseguro/authorization/response"
+require "pagseguro/authorization_request"
+require "pagseguro/authorization_request/request_serializer"
+require "pagseguro/authorization_request/response_serializer"
+require "pagseguro/authorization_request/response"
+require "pagseguro/creditor_fee"
+require "pagseguro/errors"
+require "pagseguro/exceptions"
+require "pagseguro/address"
+require "pagseguro/document"
+require "pagseguro/documents"
+require "pagseguro/shipping"
+require "pagseguro/phone"
+require "pagseguro/phones"
+require "pagseguro/person"
+require "pagseguro/partner"
+require "pagseguro/company"
+require "pagseguro/account"
+require "pagseguro/installment"
+require "pagseguro/installment/collection"
+require "pagseguro/installment/response"
+require "pagseguro/installment/response_serializer"
+require "pagseguro/installment/request_serializer"
+require "pagseguro/item"
+require "pagseguro/items"
+require "pagseguro/bank"
+require "pagseguro/holder"
+require "pagseguro/manual_subscription_charger"
+require "pagseguro/manual_subscription_charger/request_serializer"
+require "pagseguro/manual_subscription_charger/response"
+require "pagseguro/manual_subscription_charger/response_serializer"
+require "pagseguro/payment_method"
+require "pagseguro/payment_release"
+require "pagseguro/payment_releases"
+require "pagseguro/payment_request"
+require "pagseguro/payment_request/request_serializer"
+require "pagseguro/payment_request/response"
+require "pagseguro/payment_status"
+require "pagseguro/permission"
+require "pagseguro/request"
+require "pagseguro/transaction_refund"
+require "pagseguro/transaction_refund/request_serializer"
+require "pagseguro/transaction_refund/response"
+require "pagseguro/transaction_refund/response_serializer"
+require "pagseguro/receiver"
+require "pagseguro/receiver_split"
+require "pagseguro/sender"
+require "pagseguro/session"
+require "pagseguro/session/response"
+require "pagseguro/session/response_serializer"
+require "pagseguro/subscription_discount"
+require "pagseguro/subscription_discount/request_serializer"
+require "pagseguro/subscription_discount/response"
+require "pagseguro/notification"
+require "pagseguro/notification/authorization"
+require "pagseguro/notification/transaction"
+require "pagseguro/subscription_canceller"
+require "pagseguro/subscription_canceller/response"
+require "pagseguro/subscription_plan"
+require "pagseguro/subscription_plan/request_serializer"
+require "pagseguro/subscription_plan/response"
+require "pagseguro/subscription_plan/response_serializer"
+require "pagseguro/subscription_retry"
+require "pagseguro/subscription_retry/response"
+require "pagseguro/transaction"
+require "pagseguro/transaction_status"
+require "pagseguro/transaction/response"
+require "pagseguro/transaction/serializer"
+require "pagseguro/transaction/collection"
+require "pagseguro/transaction_cancellation"
+require "pagseguro/transaction_cancellation/request_serializer"
+require "pagseguro/transaction_cancellation/response"
+require "pagseguro/transaction_cancellation/response_serializer"
+require "pagseguro/transaction/search"
+require "pagseguro/transaction/search/search_by_date"
+require "pagseguro/transaction/search/search_by_reference"
+require "pagseguro/transaction/search/search_abandoned"
+require "pagseguro/transaction_installment"
+require "pagseguro/transaction_request"
+require "pagseguro/transaction_request/response"
+require "pagseguro/transaction_request/response_serializer"
+require "pagseguro/transaction_request/request_serializer"
+require "pagseguro/boleto_transaction_request"
+require "pagseguro/online_debit_transaction_request"
+require "pagseguro/credit_card_transaction_request"
+require "pagseguro/subscription_payment_method"
+require "pagseguro/subscription"
+require "pagseguro/subscription/request_serializer"
+require "pagseguro/subscription/response_serializer"
+require "pagseguro/subscription/response"
+require "pagseguro/subscription/subscription_search"
+require "pagseguro/subscription_change_payment"
+require "pagseguro/subscription_change_payment/request_serializer"
+require "pagseguro/subscription_change_payment/response"
+require "pagseguro/subscription_change_status/request_serializer"
+require "pagseguro/subscription_change_status/response"
+require "pagseguro/subscription_change_status"
+require "pagseguro/subscription_transaction"
+require "pagseguro/subscription_transactions"
+require "pagseguro/subscription_payment_order"
+require "pagseguro/subscription_payment_order/response_serializer"
+require "pagseguro/subscription_payment_order/response"
+require "pagseguro/subscription_search_payment_orders"
+
+I18n.load_path += Dir[File.expand_path("../../locales/*.yml", __FILE__)]
+
+module PagSeguro
+  class << self
+    # Delegates some calls to the config object
+    extend Forwardable
+    def_delegators :configuration, :email, :receiver_email, :token,
+      :environment, :encoding, :app_id, :app_key
+
+    def email=(email)
+      warn "[DEPRECATION] `email=` is deprecated and will be removed. Please use configuration block instead."
+      configuration.email = email
+    end
+
+    def receiver_email=(receiver_email)
+      warn "[DEPRECATION] `receiver_email=` is deprecated and will be removed. Please use configuration block instead."
+      configuration.receiver_email = receiver_email
+    end
+
+    def token=(token)
+      warn "[DEPRECATION] `token=` is deprecated and will be removed. Please use configuration block instead."
+      configuration.token = token
+    end
+
+    def environment=(environment)
+      warn "[DEPRECATION] `environment=` is deprecated and will be removed. Please use configuration block instead."
+      configuration.environment = environment
+    end
+
+    def encoding=(encoding)
+      warn "[DEPRECATION] `encoding=` is deprecated and will be removed. Please use configuration block instead."
+      configuration.encoding = encoding
+    end
+  end
+
+  # Returns an object with the configured account credentials
+  def self.account_credentials
+    PagSeguro::AccountCredentials.new(PagSeguro.email, PagSeguro.token)
+  end
+
+  # Returns an object with the configured application credentials
+  def self.application_credentials
+    PagSeguro::ApplicationCredentials.new(PagSeguro.app_id, PagSeguro.app_key)
+  end
+
+  # Register endpoints by environment.
+  def self.uris
+    @uris ||= {
+      production: {
+        api: "https://ws.pagseguro.uol.com.br/",
+        site: "https://pagseguro.uol.com.br/"
+      },
+      sandbox: {
+        site: 'https://sandbox.pagseguro.uol.com.br/',
+        api:  'https://ws.sandbox.pagseguro.uol.com.br/'
+      }
+    }
+  end
+
+  # Return the root uri based on its type.
+  # Current types are <tt>:api</tt> or <tt>:site</tt>
+  def self.root_uri(type)
+    root = uris.fetch(environment.to_sym) { raise InvalidEnvironmentError }
+    root[type.to_sym]
+  end
+
+  # The configuration instance
+  def self.configuration
+    @configuration ||= PagSeguro::Config.new
+  end
+
+  # Set the global configuration.
+  #
+  #   PagSeguro.configure do |config|
+  #     config.email = "john@example.com"
+  #     config.token = "abc"
+  #     config.app_id = "app12345"
+  #     config.app_key = "adju3cmADc52C"
+  #     config.environment = :sandbox
+  #   end
+  #
+  def self.configure(&block)
+    yield configuration
+  end
+
+  # The API endpoint.
+  def self.api_url(path)
+    File.join(root_uri(:api), path)
+  end
+
+  # The site url.
+  def self.site_url(path)
+    File.join(root_uri(:site), path)
+  end
+end