paypal-server-sdk 0.6.1 → 0.7.0

data/lib/paypal_server_sdk/models/shipping_details.rb

@@ -13,6 +13,13 @@ module PaypalServerSdk
     # @return [ShippingName]
     attr_accessor :name
 
+    # The internationalized email address. Note: Up to 64 characters are allowed
+    # before and 255 characters are allowed after the @ sign. However, the
+    # generally accepted maximum length for an email address is 254 characters.
+    # The pattern verifies that an unquoted @ sign exists.
+    # @return [String]
+    attr_accessor :email_address
+
     # The phone number in its canonical international [E.164 numbering plan
     # format](https://www.itu.int/rec/T-REC-E.164/en).
     # @return [PhoneNumberWithCountryCode]
@@ -42,6 +49,7 @@ module PaypalServerSdk
     def self.names
       @_hash = {} if @_hash.nil?
       @_hash['name'] = 'name'
+      @_hash['email_address'] = 'email_address'
       @_hash['phone_number'] = 'phone_number'
       @_hash['type'] = 'type'
       @_hash['options'] = 'options'
@@ -53,6 +61,7 @@ module PaypalServerSdk
     def self.optionals
       %w[
         name
+        email_address
         phone_number
         type
         options
@@ -65,9 +74,10 @@ module PaypalServerSdk
       []
     end
 
-    def initialize(name: SKIP, phone_number: SKIP, type: SKIP, options: SKIP,
-                   address: SKIP)
+    def initialize(name: SKIP, email_address: SKIP, phone_number: SKIP,
+                   type: SKIP, options: SKIP, address: SKIP)
       @name = name unless name == SKIP
+      @email_address = email_address unless email_address == SKIP
       @phone_number = phone_number unless phone_number == SKIP
       @type = type unless type == SKIP
       @options = options unless options == SKIP
@@ -80,6 +90,7 @@ module PaypalServerSdk
 
       # Extract variables from the hash.
       name = ShippingName.from_hash(hash['name']) if hash['name']
+      email_address = hash.key?('email_address') ? hash['email_address'] : SKIP
       phone_number = PhoneNumberWithCountryCode.from_hash(hash['phone_number']) if
         hash['phone_number']
       type = hash.key?('type') ? hash['type'] : SKIP
@@ -97,10 +108,26 @@ module PaypalServerSdk
 
       # Create object from extracted values.
       ShippingDetails.new(name: name,
+                          email_address: email_address,
                           phone_number: phone_number,
                           type: type,
                           options: options,
                           address: address)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} name: #{@name}, email_address: #{@email_address}, phone_number:"\
+      " #{@phone_number}, type: #{@type}, options: #{@options}, address: #{@address}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} name: #{@name.inspect}, email_address: #{@email_address.inspect},"\
+      " phone_number: #{@phone_number.inspect}, type: #{@type.inspect}, options:"\
+      " #{@options.inspect}, address: #{@address.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/shipping_name.rb

@@ -46,5 +46,17 @@ module PaypalServerSdk
       # Create object from extracted values.
       ShippingName.new(full_name: full_name)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} full_name: #{@full_name}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} full_name: #{@full_name.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/shipping_option.rb

@@ -90,5 +90,19 @@ module PaypalServerSdk
                          type: type,
                          amount: amount)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} id: #{@id}, label: #{@label}, type: #{@type}, amount: #{@amount}, selected:"\
+      " #{@selected}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} id: #{@id.inspect}, label: #{@label.inspect}, type: #{@type.inspect},"\
+      " amount: #{@amount.inspect}, selected: #{@selected.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/shipping_options_purchase_unit.rb

@@ -0,0 +1,102 @@
+# paypal_server_sdk
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module PaypalServerSdk
+  # This would contain shipping option and amount data at purchase unit level.
+  class ShippingOptionsPurchaseUnit < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # The API caller-provided external ID for the purchase unit. Required for
+    # multiple purchase units when you must update the order through `PATCH`. If
+    # you omit this value and the order contains only one purchase unit, PayPal
+    # sets this value to `default`. Note: If there are multiple purchase units,
+    # reference_id is required for each purchase unit.
+    # @return [String]
+    attr_accessor :reference_id
+
+    # The total order amount with an optional breakdown that provides details,
+    # such as the total item amount, total tax amount, shipping, handling,
+    # insurance, and discounts, if any. If you specify `amount.breakdown`, the
+    # amount equals `item_total` plus `tax_total` plus `shipping` plus
+    # `handling` plus `insurance` minus `shipping_discount` minus discount. The
+    # amount must be a positive number. For listed of supported currencies and
+    # decimal precision, see the PayPal REST APIs Currency Codes.
+    # @return [AmountWithBreakdown]
+    attr_accessor :amount
+
+    # An array of shipping options that the payee or merchant offers to the
+    # payer to ship or pick up their items.
+    # @return [Array[ShippingOption]]
+    attr_accessor :shipping_options
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['reference_id'] = 'reference_id'
+      @_hash['amount'] = 'amount'
+      @_hash['shipping_options'] = 'shipping_options'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        reference_id
+        amount
+        shipping_options
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(reference_id: SKIP, amount: SKIP, shipping_options: SKIP)
+      @reference_id = reference_id unless reference_id == SKIP
+      @amount = amount unless amount == SKIP
+      @shipping_options = shipping_options unless shipping_options == SKIP
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      reference_id = hash.key?('reference_id') ? hash['reference_id'] : SKIP
+      amount = AmountWithBreakdown.from_hash(hash['amount']) if hash['amount']
+      # Parameter is an array, so we need to iterate through it
+      shipping_options = nil
+      unless hash['shipping_options'].nil?
+        shipping_options = []
+        hash['shipping_options'].each do |structure|
+          shipping_options << (ShippingOption.from_hash(structure) if structure)
+        end
+      end
+
+      shipping_options = SKIP unless hash.key?('shipping_options')
+
+      # Create object from extracted values.
+      ShippingOptionsPurchaseUnit.new(reference_id: reference_id,
+                                      amount: amount,
+                                      shipping_options: shipping_options)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} reference_id: #{@reference_id}, amount: #{@amount}, shipping_options:"\
+      " #{@shipping_options}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} reference_id: #{@reference_id.inspect}, amount: #{@amount.inspect},"\
+      " shipping_options: #{@shipping_options.inspect}>"
+    end
+  end
+end

data/lib/paypal_server_sdk/models/shipping_preference.rb

@@ -7,13 +7,16 @@ module PaypalServerSdk
   # The location from which the shipping address is derived.
   class ShippingPreference
     SHIPPING_PREFERENCE = [
-      # TODO: Write general description for GET_FROM_FILE
+      # Get the customer-provided shipping address on the PayPal site.
       GET_FROM_FILE = 'GET_FROM_FILE'.freeze,
 
-      # TODO: Write general description for NO_SHIPPING
+      # Redacts the shipping address from the PayPal site. Recommended for
+      # digital goods.
       NO_SHIPPING = 'NO_SHIPPING'.freeze,
 
-      # TODO: Write general description for SET_PROVIDED_ADDRESS
+      # Get the merchant-provided address. The customer cannot change this
+      # address on the PayPal site. If merchant does not pass an address,
+      # customer can choose the address on PayPal pages.
       SET_PROVIDED_ADDRESS = 'SET_PROVIDED_ADDRESS'.freeze
     ].freeze
 

data/lib/paypal_server_sdk/models/shipping_type.rb

@@ -7,16 +7,24 @@ module PaypalServerSdk
   # A classification for the method of purchase fulfillment.
   class ShippingType
     SHIPPING_TYPE = [
-      # TODO: Write general description for SHIPPING
+      # The payer intends to receive the items at a specified address.
       SHIPPING = 'SHIPPING'.freeze,
 
-      # TODO: Write general description for PICKUP
+      # DEPRECATED. To ensure that seller protection is correctly assigned,
+      # please use 'PICKUP_IN_STORE' or 'PICKUP_FROM_PERSON' instead. Currently,
+      # this field indicates that the payer intends to pick up the items at a
+      # specified address (ie. a store address).
       PICKUP = 'PICKUP'.freeze,
 
-      # TODO: Write general description for PICKUP_IN_STORE
+      # The payer intends to pick up the item(s) from the payee's physical
+      # store. Also termed as BOPIS, "Buy Online, Pick-up in Store". Seller
+      # protection is provided with this option.
       PICKUP_IN_STORE = 'PICKUP_IN_STORE'.freeze,
 
-      # TODO: Write general description for PICKUP_FROM_PERSON
+      # The payer intends to pick up the item(s) from the payee in person. Also
+      # termed as BOPIP, "Buy Online, Pick-up in Person". Seller protection is
+      # not available, since the payer is receiving the item from the payee in
+      # person, and can validate the item prior to payment.
       PICKUP_FROM_PERSON = 'PICKUP_FROM_PERSON'.freeze
     ].freeze
 

data/lib/paypal_server_sdk/models/shipping_with_tracking_details.rb

@@ -13,6 +13,13 @@ module PaypalServerSdk
     # @return [ShippingName]
     attr_accessor :name
 
+    # The internationalized email address. Note: Up to 64 characters are allowed
+    # before and 255 characters are allowed after the @ sign. However, the
+    # generally accepted maximum length for an email address is 254 characters.
+    # The pattern verifies that an unquoted @ sign exists.
+    # @return [String]
+    attr_accessor :email_address
+
     # The phone number in its canonical international [E.164 numbering plan
     # format](https://www.itu.int/rec/T-REC-E.164/en).
     # @return [PhoneNumberWithCountryCode]
@@ -46,6 +53,7 @@ module PaypalServerSdk
     def self.names
       @_hash = {} if @_hash.nil?
       @_hash['name'] = 'name'
+      @_hash['email_address'] = 'email_address'
       @_hash['phone_number'] = 'phone_number'
       @_hash['type'] = 'type'
       @_hash['options'] = 'options'
@@ -58,6 +66,7 @@ module PaypalServerSdk
     def self.optionals
       %w[
         name
+        email_address
         phone_number
         type
         options
@@ -71,9 +80,10 @@ module PaypalServerSdk
       []
     end
 
-    def initialize(name: SKIP, phone_number: SKIP, type: SKIP, options: SKIP,
-                   address: SKIP, trackers: SKIP)
+    def initialize(name: SKIP, email_address: SKIP, phone_number: SKIP,
+                   type: SKIP, options: SKIP, address: SKIP, trackers: SKIP)
       @name = name unless name == SKIP
+      @email_address = email_address unless email_address == SKIP
       @phone_number = phone_number unless phone_number == SKIP
       @type = type unless type == SKIP
       @options = options unless options == SKIP
@@ -87,6 +97,7 @@ module PaypalServerSdk
 
       # Extract variables from the hash.
       name = ShippingName.from_hash(hash['name']) if hash['name']
+      email_address = hash.key?('email_address') ? hash['email_address'] : SKIP
       phone_number = PhoneNumberWithCountryCode.from_hash(hash['phone_number']) if
         hash['phone_number']
       type = hash.key?('type') ? hash['type'] : SKIP
@@ -114,11 +125,28 @@ module PaypalServerSdk
 
       # Create object from extracted values.
       ShippingWithTrackingDetails.new(name: name,
+                                      email_address: email_address,
                                       phone_number: phone_number,
                                       type: type,
                                       options: options,
                                       address: address,
                                       trackers: trackers)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} name: #{@name}, email_address: #{@email_address}, phone_number:"\
+      " #{@phone_number}, type: #{@type}, options: #{@options}, address: #{@address}, trackers:"\
+      " #{@trackers}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} name: #{@name.inspect}, email_address: #{@email_address.inspect},"\
+      " phone_number: #{@phone_number.inspect}, type: #{@type.inspect}, options:"\
+      " #{@options.inspect}, address: #{@address.inspect}, trackers: #{@trackers.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/sofort_payment_object.rb

@@ -14,11 +14,10 @@ module PaypalServerSdk
     attr_accessor :name
 
     # The [two-character ISO 3166-1 code](/api/rest/reference/country-codes/)
-    # that identifies the country or region.<blockquote><strong>Note:</strong>
-    # The country code for Great Britain is <code>GB</code> and not
-    # <code>UK</code> as used in the top-level domain names for that country.
-    # Use the `C2` country code for China worldwide for comparable uncontrolled
-    # price (CUP) method, bank card, and cross-border transactions.</blockquote>
+    # that identifies the country or region. Note: The country code for Great
+    # Britain is GB and not UK as used in the top-level domain names for that
+    # country. Use the `C2` country code for China worldwide for comparable
+    # uncontrolled price (CUP) method, bank card, and cross-border transactions.
     # @return [String]
     attr_accessor :country_code
 
@@ -81,5 +80,19 @@ module PaypalServerSdk
                               bic: bic,
                               iban_last_chars: iban_last_chars)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} name: #{@name}, country_code: #{@country_code}, bic: #{@bic},"\
+      " iban_last_chars: #{@iban_last_chars}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} name: #{@name.inspect}, country_code: #{@country_code.inspect}, bic:"\
+      " #{@bic.inspect}, iban_last_chars: #{@iban_last_chars.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/sofort_payment_request.rb

@@ -14,11 +14,10 @@ module PaypalServerSdk
     attr_accessor :name
 
     # The [two-character ISO 3166-1 code](/api/rest/reference/country-codes/)
-    # that identifies the country or region.<blockquote><strong>Note:</strong>
-    # The country code for Great Britain is <code>GB</code> and not
-    # <code>UK</code> as used in the top-level domain names for that country.
-    # Use the `C2` country code for China worldwide for comparable uncontrolled
-    # price (CUP) method, bank card, and cross-border transactions.</blockquote>
+    # that identifies the country or region. Note: The country code for Great
+    # Britain is GB and not UK as used in the top-level domain names for that
+    # country. Use the `C2` country code for China worldwide for comparable
+    # uncontrolled price (CUP) method, bank card, and cross-border transactions.
     # @return [String]
     attr_accessor :country_code
 
@@ -69,5 +68,19 @@ module PaypalServerSdk
                                country_code: country_code,
                                experience_context: experience_context)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} name: #{@name}, country_code: #{@country_code}, experience_context:"\
+      " #{@experience_context}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} name: #{@name.inspect}, country_code: #{@country_code.inspect},"\
+      " experience_context: #{@experience_context.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/standard_entry_class_code.rb

@@ -14,16 +14,24 @@ module PaypalServerSdk
   # PayPal supports the following SEC codes.
   class StandardEntryClassCode
     STANDARD_ENTRY_CLASS_CODE = [
-      # TODO: Write general description for TEL
+      # The API caller (merchant/partner) accepts authorization and payment
+      # information from a consumer over the telephone.
       TEL = 'TEL'.freeze,
 
-      # TODO: Write general description for WEB
+      # The API caller (merchant/partner) accepts Debit transactions from a
+      # consumer on their website.
       WEB = 'WEB'.freeze,
 
-      # TODO: Write general description for CCD
+      # Cash concentration and disbursement for corporate debit transaction.
+      # Used to disburse or consolidate funds. Entries are usually Optional
+      # high-dollar, low-volume, and time-critical. (e.g. intra-company
+      # transfers or invoice payments to suppliers).
       CCD = 'CCD'.freeze,
 
-      # TODO: Write general description for PPD
+      # Prearranged payment and deposit entries. Used for debit payments
+      # authorized by a consumer account holder, and usually initiated by a
+      # company. These are usually recurring debits (such as insurance
+      # premiums).
       PPD = 'PPD'.freeze
     ].freeze
 

data/lib/paypal_server_sdk/models/store_in_vault_instruction.rb

@@ -7,7 +7,8 @@ module PaypalServerSdk
   # Defines how and when the payment source gets vaulted.
   class StoreInVaultInstruction
     STORE_IN_VAULT_INSTRUCTION = [
-      # TODO: Write general description for ON_SUCCESS
+      # Defines that the payment_source will be vaulted only when at least one
+      # authorization or capture using that payment_source is successful.
       ON_SUCCESS = 'ON_SUCCESS'.freeze
     ].freeze
 

data/lib/paypal_server_sdk/models/stored_payment_source.rb

@@ -6,15 +6,14 @@
 module PaypalServerSdk
   # Provides additional details to process a payment using a `payment_source`
   # that has been stored or is intended to be stored (also referred to as
-  # stored_credential or card-on-file).<br/>Parameter
-  # compatibility:<br/><ul><li>`payment_type=ONE_TIME` is compatible only with
-  # `payment_initiator=CUSTOMER`.</li><li>`usage=FIRST` is compatible only with
-  # `payment_initiator=CUSTOMER`.</li><li>`previous_transaction_reference` or
+  # stored_credential or card-on-file). Parameter compatibility:
+  # `payment_type=ONE_TIME` is compatible only with
+  # `payment_initiator=CUSTOMER`. `usage=FIRST` is compatible only with
+  # `payment_initiator=CUSTOMER`. `previous_transaction_reference` or
   # `previous_network_transaction_reference` is compatible only with
-  # `payment_initiator=MERCHANT`.</li><li>Only one of the parameters -
+  # `payment_initiator=MERCHANT`. Only one of the parameters -
   # `previous_transaction_reference` and
-  # `previous_network_transaction_reference` - can be present in the
-  # request.</li></ul>
+  # `previous_network_transaction_reference` - can be present in the request.
   class StoredPaymentSource < BaseModel
     SKIP = Object.new
     private_constant :SKIP
@@ -91,5 +90,22 @@ module PaypalServerSdk
                               usage: usage,
                               previous_network_transaction_reference: previous_network_transaction_reference)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} payment_initiator: #{@payment_initiator}, payment_type: #{@payment_type},"\
+      " usage: #{@usage}, previous_network_transaction_reference:"\
+      " #{@previous_network_transaction_reference}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} payment_initiator: #{@payment_initiator.inspect}, payment_type:"\
+      " #{@payment_type.inspect}, usage: #{@usage.inspect},"\
+      ' previous_network_transaction_reference:'\
+      " #{@previous_network_transaction_reference.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/stored_payment_source_payment_type.rb

@@ -7,13 +7,16 @@ module PaypalServerSdk
   # Indicates the type of the stored payment_source payment.
   class StoredPaymentSourcePaymentType
     STORED_PAYMENT_SOURCE_PAYMENT_TYPE = [
-      # TODO: Write general description for ONE_TIME
+      # One Time payment such as online purchase or donation. (e.g. Checkout
+      # with one-click).
       ONE_TIME = 'ONE_TIME'.freeze,
 
-      # TODO: Write general description for RECURRING
+      # Payment which is part of a series of payments with fixed or variable
+      # amounts, following a fixed time interval. (e.g. Subscription payments).
       RECURRING = 'RECURRING'.freeze,
 
-      # TODO: Write general description for UNSCHEDULED
+      # Payment which is part of a series of payments that occur on a non-fixed
+      # schedule and/or have variable amounts. (e.g. Account Topup payments).
       UNSCHEDULED = 'UNSCHEDULED'.freeze
     ].freeze
 

data/lib/paypal_server_sdk/models/stored_payment_source_usage_type.rb

@@ -8,13 +8,16 @@ module PaypalServerSdk
   # payment source (also referred to as stored credential or card on file).
   class StoredPaymentSourceUsageType
     STORED_PAYMENT_SOURCE_USAGE_TYPE = [
-      # TODO: Write general description for FIRST
+      # Indicates the Initial/First payment with a payment_source that is
+      # intended to be stored upon successful processing of the payment.
       FIRST = 'FIRST'.freeze,
 
-      # TODO: Write general description for SUBSEQUENT
+      # Indicates a payment using a stored payment_source which has been
+      # successfully used previously for a payment.
       SUBSEQUENT = 'SUBSEQUENT'.freeze,
 
-      # TODO: Write general description for DERIVED
+      # Indicates that PayPal will derive the value of `FIRST` or `SUBSEQUENT`
+      # based on data available to PayPal.
       DERIVED = 'DERIVED'.freeze
     ].freeze
 

data/lib/paypal_server_sdk/models/supplementary_data.rb

@@ -13,18 +13,20 @@ module PaypalServerSdk
 
     # Merchants and partners can add Level 2 and 3 data to payments to reduce
     # risk and payment processing costs. For more information about processing
-    # payments, see <a
-    # href="https://developer.paypal.com/docs/checkout/advanced/processing/">che
-    # ckout</a> or <a
-    # href="https://developer.paypal.com/docs/multiparty/checkout/advanced/proce
-    # ssing/">multiparty checkout</a>.
+    # payments, see checkout or multiparty checkout.
     # @return [CardSupplementaryData]
     attr_accessor :card
 
+    # Additional information necessary to evaluate the risk profile of a
+    # transaction.
+    # @return [RiskSupplementaryData]
+    attr_accessor :risk
+
     # A mapping from model property names to API property names.
     def self.names
       @_hash = {} if @_hash.nil?
       @_hash['card'] = 'card'
+      @_hash['risk'] = 'risk'
       @_hash
     end
 
@@ -32,6 +34,7 @@ module PaypalServerSdk
     def self.optionals
       %w[
         card
+        risk
       ]
     end
 
@@ -40,8 +43,9 @@ module PaypalServerSdk
       []
     end
 
-    def initialize(card: SKIP)
+    def initialize(card: SKIP, risk: SKIP)
       @card = card unless card == SKIP
+      @risk = risk unless risk == SKIP
     end
 
     # Creates an instance of the object from a hash.
@@ -50,9 +54,23 @@ module PaypalServerSdk
 
       # Extract variables from the hash.
       card = CardSupplementaryData.from_hash(hash['card']) if hash['card']
+      risk = RiskSupplementaryData.from_hash(hash['risk']) if hash['risk']
 
       # Create object from extracted values.
-      SupplementaryData.new(card: card)
+      SupplementaryData.new(card: card,
+                            risk: risk)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} card: #{@card}, risk: #{@risk}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} card: #{@card.inspect}, risk: #{@risk.inspect}>"
     end
   end
 end

data/lib/paypal_server_sdk/models/supplementary_purchase_data.rb

@@ -59,5 +59,18 @@ module PaypalServerSdk
       SupplementaryPurchaseData.new(invoice_id: invoice_id,
                                     note_to_payer: note_to_payer)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} invoice_id: #{@invoice_id}, note_to_payer: #{@note_to_payer}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} invoice_id: #{@invoice_id.inspect}, note_to_payer:"\
+      " #{@note_to_payer.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/tax_id_type.rb

@@ -7,10 +7,10 @@ module PaypalServerSdk
   # The customer's tax ID type.
   class TaxIdType
     TAX_ID_TYPE = [
-      # TODO: Write general description for BR_CPF
+      # The individual tax ID type, typically is 11 characters long.
       BR_CPF = 'BR_CPF'.freeze,
 
-      # TODO: Write general description for BR_CNPJ
+      # The business tax ID type, typically is 14 characters long.
       BR_CNPJ = 'BR_CNPJ'.freeze
     ].freeze