paypal-server-sdk 0.6.0 → 0.7.0

data/lib/paypal_server_sdk/models/activity_timestamps.rb

@@ -12,17 +12,15 @@ module PaypalServerSdk
 
     # The date and time, in [Internet date and time
     # format](https://tools.ietf.org/html/rfc3339#section-5.6). Seconds are
-    # required while fractional seconds are
-    # optional.<blockquote><strong>Note:</strong> The regular expression
-    # provides guidance but does not reject all invalid dates.</blockquote>
+    # required while fractional seconds are optional. Note: The regular
+    # expression provides guidance but does not reject all invalid dates.
     # @return [String]
     attr_accessor :create_time
 
     # The date and time, in [Internet date and time
     # format](https://tools.ietf.org/html/rfc3339#section-5.6). Seconds are
-    # required while fractional seconds are
-    # optional.<blockquote><strong>Note:</strong> The regular expression
-    # provides guidance but does not reject all invalid dates.</blockquote>
+    # required while fractional seconds are optional. Note: The regular
+    # expression provides guidance but does not reject all invalid dates.
     # @return [String]
     attr_accessor :update_time
 
@@ -64,5 +62,18 @@ module PaypalServerSdk
       ActivityTimestamps.new(create_time: create_time,
                              update_time: update_time)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} create_time: #{@create_time}, update_time: #{@update_time}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} create_time: #{@create_time.inspect}, update_time:"\
+      " #{@update_time.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/address.rb

@@ -30,10 +30,9 @@ module PaypalServerSdk
 
     # The highest-level sub-division in a country, which is usually a province,
     # state, or ISO-3166-2 subdivision. This data is formatted for postal
-    # delivery, for example, `CA` and not `California`. Value, by country,
-    # is:<ul><li>UK. A county.</li><li>US. A state.</li><li>Canada. A
-    # province.</li><li>Japan. A prefecture.</li><li>Switzerland. A
-    # *kanton*.</li></ul>
+    # delivery, for example, `CA` and not `California`. Value, by country, is:
+    # UK. A county. US. A state. Canada. A province. Japan. A prefecture.
+    # Switzerland. A *kanton*.
     # @return [String]
     attr_accessor :admin_area_1
 
@@ -44,11 +43,10 @@ module PaypalServerSdk
     attr_accessor :postal_code
 
     # The [2-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>
+    # 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
 
@@ -112,5 +110,22 @@ module PaypalServerSdk
                   admin_area_1: admin_area_1,
                   postal_code: postal_code)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} address_line_1: #{@address_line_1}, address_line_2: #{@address_line_2},"\
+      " admin_area_2: #{@admin_area_2}, admin_area_1: #{@admin_area_1}, postal_code:"\
+      " #{@postal_code}, country_code: #{@country_code}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} address_line_1: #{@address_line_1.inspect}, address_line_2:"\
+      " #{@address_line_2.inspect}, admin_area_2: #{@admin_area_2.inspect}, admin_area_1:"\
+      " #{@admin_area_1.inspect}, postal_code: #{@postal_code.inspect}, country_code:"\
+      " #{@country_code.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/amount_breakdown.rb

@@ -111,5 +111,22 @@ module PaypalServerSdk
                           shipping_discount: shipping_discount,
                           discount: discount)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} item_total: #{@item_total}, shipping: #{@shipping}, handling: #{@handling},"\
+      " tax_total: #{@tax_total}, insurance: #{@insurance}, shipping_discount:"\
+      " #{@shipping_discount}, discount: #{@discount}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} item_total: #{@item_total.inspect}, shipping: #{@shipping.inspect},"\
+      " handling: #{@handling.inspect}, tax_total: #{@tax_total.inspect}, insurance:"\
+      " #{@insurance.inspect}, shipping_discount: #{@shipping_discount.inspect}, discount:"\
+      " #{@discount.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/amount_with_breakdown.rb

@@ -6,12 +6,11 @@
 module PaypalServerSdk
   # 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.<br/>If you specify `amount.breakdown`, the
+  # 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.<br/>The amount
-  # must be a positive number. For listed of supported currencies and decimal
-  # precision, see the PayPal REST APIs <a
-  # href="/docs/integration/direct/rest/currency-codes/">Currency Codes</a>.
+  # 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.
   class AmountWithBreakdown < BaseModel
     SKIP = Object.new
     private_constant :SKIP
@@ -21,10 +20,10 @@ module PaypalServerSdk
     # @return [String]
     attr_accessor :currency_code
 
-    # The value, which might be:<ul><li>An integer for currencies like `JPY`
-    # that are not typically fractional.</li><li>A decimal fraction for
-    # currencies like `TND` that are subdivided into thousandths.</li></ul>For
-    # the required number of decimal places for a currency code, see [Currency
+    # The value, which might be: An integer for currencies like `JPY` that are
+    # not typically fractional. A decimal fraction for currencies like `TND`
+    # that are subdivided into thousandths. For the required number of decimal
+    # places for a currency code, see [Currency
     # Codes](/api/rest/reference/currency-codes/).
     # @return [String]
     attr_accessor :value
@@ -76,5 +75,19 @@ module PaypalServerSdk
                               value: value,
                               breakdown: breakdown)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} currency_code: #{@currency_code}, value: #{@value}, breakdown:"\
+      " #{@breakdown}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} currency_code: #{@currency_code.inspect}, value: #{@value.inspect},"\
+      " breakdown: #{@breakdown.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/apple_pay_attributes.rb

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

data/lib/paypal_server_sdk/models/apple_pay_attributes_response.rb

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

data/lib/paypal_server_sdk/models/apple_pay_card.rb

@@ -90,5 +90,19 @@ module PaypalServerSdk
                        brand: brand,
                        billing_address: billing_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}, last_digits: #{@last_digits}, type: #{@type}, brand:"\
+      " #{@brand}, billing_address: #{@billing_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}, last_digits: #{@last_digits.inspect}, type:"\
+      " #{@type.inspect}, brand: #{@brand.inspect}, billing_address: #{@billing_address.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/apple_pay_card_response.rb

@@ -51,6 +51,19 @@ module PaypalServerSdk
     # @return [BinDetails]
     attr_accessor :bin_details
 
+    # Provides additional details to process a payment using a `card` that has
+    # been stored or is intended to be stored (also referred to as
+    # 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`. Only one of the parameters -
+    # `previous_transaction_reference` and
+    # `previous_network_transaction_reference` - can be present in the request.
+    # @return [CardStoredCredential]
+    attr_accessor :stored_credential
+
     # The portable international postal address. Maps to
     # [AddressValidationMetadata](https://github.com/googlei18n/libaddressinput/
     # wiki/AddressValidationMetadata) and HTML 5.1 [Autofilling form controls:
@@ -61,11 +74,10 @@ module PaypalServerSdk
     attr_accessor :billing_address
 
     # 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
 
@@ -82,6 +94,7 @@ module PaypalServerSdk
       @_hash['from_request'] = 'from_request'
       @_hash['expiry'] = 'expiry'
       @_hash['bin_details'] = 'bin_details'
+      @_hash['stored_credential'] = 'stored_credential'
       @_hash['billing_address'] = 'billing_address'
       @_hash['country_code'] = 'country_code'
       @_hash
@@ -100,6 +113,7 @@ module PaypalServerSdk
         from_request
         expiry
         bin_details
+        stored_credential
         billing_address
         country_code
       ]
@@ -114,7 +128,8 @@ module PaypalServerSdk
                    available_networks: SKIP, type: SKIP,
                    authentication_result: SKIP, attributes: SKIP,
                    from_request: SKIP, expiry: SKIP, bin_details: SKIP,
-                   billing_address: SKIP, country_code: SKIP)
+                   stored_credential: SKIP, billing_address: SKIP,
+                   country_code: SKIP)
       @name = name unless name == SKIP
       @last_digits = last_digits unless last_digits == SKIP
       @brand = brand unless brand == SKIP
@@ -125,6 +140,7 @@ module PaypalServerSdk
       @from_request = from_request unless from_request == SKIP
       @expiry = expiry unless expiry == SKIP
       @bin_details = bin_details unless bin_details == SKIP
+      @stored_credential = stored_credential unless stored_credential == SKIP
       @billing_address = billing_address unless billing_address == SKIP
       @country_code = country_code unless country_code == SKIP
     end
@@ -146,6 +162,8 @@ module PaypalServerSdk
       from_request = CardFromRequest.from_hash(hash['from_request']) if hash['from_request']
       expiry = hash.key?('expiry') ? hash['expiry'] : SKIP
       bin_details = BinDetails.from_hash(hash['bin_details']) if hash['bin_details']
+      stored_credential = CardStoredCredential.from_hash(hash['stored_credential']) if
+        hash['stored_credential']
       billing_address = Address.from_hash(hash['billing_address']) if hash['billing_address']
       country_code = hash.key?('country_code') ? hash['country_code'] : SKIP
 
@@ -160,8 +178,32 @@ module PaypalServerSdk
                                from_request: from_request,
                                expiry: expiry,
                                bin_details: bin_details,
+                               stored_credential: stored_credential,
                                billing_address: billing_address,
                                country_code: country_code)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} name: #{@name}, last_digits: #{@last_digits}, brand: #{@brand},"\
+      " available_networks: #{@available_networks}, type: #{@type}, authentication_result:"\
+      " #{@authentication_result}, attributes: #{@attributes}, from_request: #{@from_request},"\
+      " expiry: #{@expiry}, bin_details: #{@bin_details}, stored_credential:"\
+      " #{@stored_credential}, billing_address: #{@billing_address}, country_code:"\
+      " #{@country_code}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} name: #{@name.inspect}, last_digits: #{@last_digits.inspect}, brand:"\
+      " #{@brand.inspect}, available_networks: #{@available_networks.inspect}, type:"\
+      " #{@type.inspect}, authentication_result: #{@authentication_result.inspect}, attributes:"\
+      " #{@attributes.inspect}, from_request: #{@from_request.inspect}, expiry:"\
+      " #{@expiry.inspect}, bin_details: #{@bin_details.inspect}, stored_credential:"\
+      " #{@stored_credential.inspect}, billing_address: #{@billing_address.inspect}, country_code:"\
+      " #{@country_code.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/apple_pay_decrypted_token_data.rb

@@ -91,5 +91,21 @@ module PaypalServerSdk
                                      payment_data_type: payment_data_type,
                                      payment_data: payment_data)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} transaction_amount: #{@transaction_amount}, tokenized_card:"\
+      " #{@tokenized_card}, device_manufacturer_id: #{@device_manufacturer_id}, payment_data_type:"\
+      " #{@payment_data_type}, payment_data: #{@payment_data}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} transaction_amount: #{@transaction_amount.inspect}, tokenized_card:"\
+      " #{@tokenized_card.inspect}, device_manufacturer_id: #{@device_manufacturer_id.inspect},"\
+      " payment_data_type: #{@payment_data_type.inspect}, payment_data: #{@payment_data.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/apple_pay_payment_data.rb

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

data/lib/paypal_server_sdk/models/apple_pay_payment_data_type.rb

@@ -8,10 +8,14 @@ module PaypalServerSdk
   # data is 3DSECURE and for China it is EMV.
   class ApplePayPaymentDataType
     APPLE_PAY_PAYMENT_DATA_TYPE = [
-      # TODO: Write general description for ENUM_3DSECURE
+      # The card was authenticated using 3D Secure (3DS) authentication scheme.
+      # While using this value make sure to populate cryptogram and
+      # eci_indicator as part of payment data..
       ENUM_3DSECURE = '3DSECURE'.freeze,
 
-      # TODO: Write general description for EMV
+      # The card was authenticated using EMV method, which is applicable for
+      # China. While using this value make sure to pass emv_data and pin as part
+      # of payment data.
       EMV = 'EMV'.freeze
     ].freeze
 

data/lib/paypal_server_sdk/models/apple_pay_payment_object.rb

@@ -25,11 +25,10 @@ module PaypalServerSdk
     # @return [String]
     attr_accessor :name
 
-    # The internationalized email address.<blockquote><strong>Note:</strong> Up
-    # to 64 characters are allowed before and 255 characters are allowed after
-    # the <code>@</code> sign. However, the generally accepted maximum length
-    # for an email address is 254 characters. The pattern verifies that an
-    # unquoted <code>@</code> sign exists.</blockquote>
+    # 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
 
@@ -46,6 +45,19 @@ module PaypalServerSdk
     # @return [ApplePayAttributesResponse]
     attr_accessor :attributes
 
+    # Provides additional details to process a payment using a `card` that has
+    # been stored or is intended to be stored (also referred to as
+    # 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`. Only one of the parameters -
+    # `previous_transaction_reference` and
+    # `previous_network_transaction_reference` - can be present in the request.
+    # @return [CardStoredCredential]
+    attr_accessor :stored_credential
+
     # A mapping from model property names to API property names.
     def self.names
       @_hash = {} if @_hash.nil?
@@ -56,6 +68,7 @@ module PaypalServerSdk
       @_hash['phone_number'] = 'phone_number'
       @_hash['card'] = 'card'
       @_hash['attributes'] = 'attributes'
+      @_hash['stored_credential'] = 'stored_credential'
       @_hash
     end
 
@@ -69,6 +82,7 @@ module PaypalServerSdk
         phone_number
         card
         attributes
+        stored_credential
       ]
     end
 
@@ -78,7 +92,8 @@ module PaypalServerSdk
     end
 
     def initialize(id: SKIP, token: SKIP, name: SKIP, email_address: SKIP,
-                   phone_number: SKIP, card: SKIP, attributes: SKIP)
+                   phone_number: SKIP, card: SKIP, attributes: SKIP,
+                   stored_credential: SKIP)
       @id = id unless id == SKIP
       @token = token unless token == SKIP
       @name = name unless name == SKIP
@@ -86,6 +101,7 @@ module PaypalServerSdk
       @phone_number = phone_number unless phone_number == SKIP
       @card = card unless card == SKIP
       @attributes = attributes unless attributes == SKIP
+      @stored_credential = stored_credential unless stored_credential == SKIP
     end
 
     # Creates an instance of the object from a hash.
@@ -100,6 +116,8 @@ module PaypalServerSdk
       phone_number = PhoneNumber.from_hash(hash['phone_number']) if hash['phone_number']
       card = ApplePayCardResponse.from_hash(hash['card']) if hash['card']
       attributes = ApplePayAttributesResponse.from_hash(hash['attributes']) if hash['attributes']
+      stored_credential = CardStoredCredential.from_hash(hash['stored_credential']) if
+        hash['stored_credential']
 
       # Create object from extracted values.
       ApplePayPaymentObject.new(id: id,
@@ -108,7 +126,25 @@ module PaypalServerSdk
                                 email_address: email_address,
                                 phone_number: phone_number,
                                 card: card,
-                                attributes: attributes)
+                                attributes: attributes,
+                                stored_credential: stored_credential)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} id: #{@id}, token: #{@token}, name: #{@name}, email_address:"\
+      " #{@email_address}, phone_number: #{@phone_number}, card: #{@card}, attributes:"\
+      " #{@attributes}, stored_credential: #{@stored_credential}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} id: #{@id.inspect}, token: #{@token.inspect}, name: #{@name.inspect},"\
+      " email_address: #{@email_address.inspect}, phone_number: #{@phone_number.inspect}, card:"\
+      " #{@card.inspect}, attributes: #{@attributes.inspect}, stored_credential:"\
+      " #{@stored_credential.inspect}>"
     end
   end
 end

data/lib/paypal_server_sdk/models/apple_pay_payment_token.rb

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

data/lib/paypal_server_sdk/models/apple_pay_request.rb

@@ -19,11 +19,10 @@ module PaypalServerSdk
     # @return [String]
     attr_accessor :name
 
-    # The internationalized email address.<blockquote><strong>Note:</strong> Up
-    # to 64 characters are allowed before and 255 characters are allowed after
-    # the <code>@</code> sign. However, the generally accepted maximum length
-    # for an email address is 254 characters. The pattern verifies that an
-    # unquoted <code>@</code> sign exists.</blockquote>
+    # 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
 
@@ -38,16 +37,14 @@ module PaypalServerSdk
 
     # Provides additional details to process a payment using a `card` 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.
     # @return [CardStoredCredential]
     attr_accessor :stored_credential
 
@@ -133,5 +130,22 @@ module PaypalServerSdk
                           vault_id: vault_id,
                           attributes: attributes)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} id: #{@id}, name: #{@name}, email_address: #{@email_address}, phone_number:"\
+      " #{@phone_number}, decrypted_token: #{@decrypted_token}, stored_credential:"\
+      " #{@stored_credential}, vault_id: #{@vault_id}, attributes: #{@attributes}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} id: #{@id.inspect}, name: #{@name.inspect}, email_address:"\
+      " #{@email_address.inspect}, phone_number: #{@phone_number.inspect}, decrypted_token:"\
+      " #{@decrypted_token.inspect}, stored_credential: #{@stored_credential.inspect}, vault_id:"\
+      " #{@vault_id.inspect}, attributes: #{@attributes.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/apple_pay_tokenized_card.rb

@@ -109,5 +109,20 @@ module PaypalServerSdk
                                 brand: brand,
                                 billing_address: billing_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}, number: #{@number}, expiry: #{@expiry}, card_type:"\
+      " #{@card_type}, type: #{@type}, brand: #{@brand}, billing_address: #{@billing_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}, number: #{@number.inspect}, expiry:"\
+      " #{@expiry.inspect}, card_type: #{@card_type.inspect}, type: #{@type.inspect}, brand:"\
+      " #{@brand.inspect}, billing_address: #{@billing_address.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/assurance_details.rb

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

data/lib/paypal_server_sdk/models/authentication_response.rb

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