paypal-server-sdk 0.6.1 → 0.7.0

data/lib/paypal_server_sdk/models/level3_card_processing_data.rb

@@ -116,5 +116,22 @@ module PaypalServerSdk
                                    ships_from_postal_code: ships_from_postal_code,
                                    line_items: line_items)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} shipping_amount: #{@shipping_amount}, duty_amount: #{@duty_amount},"\
+      " discount_amount: #{@discount_amount}, shipping_address: #{@shipping_address},"\
+      " ships_from_postal_code: #{@ships_from_postal_code}, line_items: #{@line_items}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} shipping_amount: #{@shipping_amount.inspect}, duty_amount:"\
+      " #{@duty_amount.inspect}, discount_amount: #{@discount_amount.inspect}, shipping_address:"\
+      " #{@shipping_address.inspect}, ships_from_postal_code: #{@ships_from_postal_code.inspect},"\
+      " line_items: #{@line_items.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/liability_shift_indicator.rb

@@ -7,13 +7,13 @@ module PaypalServerSdk
   # Liability shift indicator. The outcome of the issuer's authentication.
   class LiabilityShiftIndicator
     LIABILITY_SHIFT_INDICATOR = [
-      # TODO: Write general description for NO
+      # Liability is with the merchant.
       NO = 'NO'.freeze,
 
-      # TODO: Write general description for POSSIBLE
+      # Liability may shift to the card issuer.
       POSSIBLE = 'POSSIBLE'.freeze,
 
-      # TODO: Write general description for UNKNOWN
+      # The authentication system is not available.
       UNKNOWN = 'UNKNOWN'.freeze
     ].freeze
 

data/lib/paypal_server_sdk/models/line_item.rb

@@ -173,5 +173,26 @@ module PaypalServerSdk
                    total_amount: total_amount,
                    unit_of_measure: unit_of_measure)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} name: #{@name}, quantity: #{@quantity}, description: #{@description}, sku:"\
+      " #{@sku}, url: #{@url}, image_url: #{@image_url}, upc: #{@upc}, unit_amount:"\
+      " #{@unit_amount}, tax: #{@tax}, commodity_code: #{@commodity_code}, discount_amount:"\
+      " #{@discount_amount}, total_amount: #{@total_amount}, unit_of_measure:"\
+      " #{@unit_of_measure}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} name: #{@name.inspect}, quantity: #{@quantity.inspect}, description:"\
+      " #{@description.inspect}, sku: #{@sku.inspect}, url: #{@url.inspect}, image_url:"\
+      " #{@image_url.inspect}, upc: #{@upc.inspect}, unit_amount: #{@unit_amount.inspect}, tax:"\
+      " #{@tax.inspect}, commodity_code: #{@commodity_code.inspect}, discount_amount:"\
+      " #{@discount_amount.inspect}, total_amount: #{@total_amount.inspect}, unit_of_measure:"\
+      " #{@unit_of_measure.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/link_description.rb

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

data/lib/paypal_server_sdk/models/money.rb

@@ -15,10 +15,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
@@ -58,5 +58,17 @@ module PaypalServerSdk
       Money.new(currency_code: currency_code,
                 value: value)
     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}>"
+    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}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/mybank_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/mybank_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/name.rb

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

data/lib/paypal_server_sdk/models/net_amount_breakdown_item.rb

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

data/lib/paypal_server_sdk/models/network_token.rb

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

data/lib/paypal_server_sdk/models/network_transaction_reference.rb

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

data/lib/paypal_server_sdk/models/network_transaction_reference_entity.rb

@@ -31,9 +31,8 @@ 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 :time
 
@@ -84,5 +83,18 @@ module PaypalServerSdk
                                             network: network,
                                             time: time)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} id: #{@id}, date: #{@date}, network: #{@network}, time: #{@time}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} id: #{@id.inspect}, date: #{@date.inspect}, network: #{@network.inspect},"\
+      " time: #{@time.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/one_time_charge.rb

@@ -0,0 +1,118 @@
+# paypal_server_sdk
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module PaypalServerSdk
+  # The one-time charge info at the time of checkout.
+  class OneTimeCharge < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # The currency and amount for a financial transaction, such as a balance or
+    # payment due.
+    # @return [Money]
+    attr_accessor :setup_fee
+
+    # The currency and amount for a financial transaction, such as a balance or
+    # payment due.
+    # @return [Money]
+    attr_accessor :shipping_amount
+
+    # The currency and amount for a financial transaction, such as a balance or
+    # payment due.
+    # @return [Money]
+    attr_accessor :taxes
+
+    # The currency and amount for a financial transaction, such as a balance or
+    # payment due.
+    # @return [Money]
+    attr_accessor :product_price
+
+    # The currency and amount for a financial transaction, such as a balance or
+    # payment due.
+    # @return [Money]
+    attr_accessor :subtotal
+
+    # The currency and amount for a financial transaction, such as a balance or
+    # payment due.
+    # @return [Money]
+    attr_accessor :total_amount
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['setup_fee'] = 'setup_fee'
+      @_hash['shipping_amount'] = 'shipping_amount'
+      @_hash['taxes'] = 'taxes'
+      @_hash['product_price'] = 'product_price'
+      @_hash['subtotal'] = 'subtotal'
+      @_hash['total_amount'] = 'total_amount'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        setup_fee
+        shipping_amount
+        taxes
+        product_price
+        subtotal
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(total_amount:, setup_fee: SKIP, shipping_amount: SKIP,
+                   taxes: SKIP, product_price: SKIP, subtotal: SKIP)
+      @setup_fee = setup_fee unless setup_fee == SKIP
+      @shipping_amount = shipping_amount unless shipping_amount == SKIP
+      @taxes = taxes unless taxes == SKIP
+      @product_price = product_price unless product_price == SKIP
+      @subtotal = subtotal unless subtotal == SKIP
+      @total_amount = total_amount
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      total_amount = Money.from_hash(hash['total_amount']) if hash['total_amount']
+      setup_fee = Money.from_hash(hash['setup_fee']) if hash['setup_fee']
+      shipping_amount = Money.from_hash(hash['shipping_amount']) if hash['shipping_amount']
+      taxes = Money.from_hash(hash['taxes']) if hash['taxes']
+      product_price = Money.from_hash(hash['product_price']) if hash['product_price']
+      subtotal = Money.from_hash(hash['subtotal']) if hash['subtotal']
+
+      # Create object from extracted values.
+      OneTimeCharge.new(total_amount: total_amount,
+                        setup_fee: setup_fee,
+                        shipping_amount: shipping_amount,
+                        taxes: taxes,
+                        product_price: product_price,
+                        subtotal: subtotal)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} setup_fee: #{@setup_fee}, shipping_amount: #{@shipping_amount}, taxes:"\
+      " #{@taxes}, product_price: #{@product_price}, subtotal: #{@subtotal}, total_amount:"\
+      " #{@total_amount}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} setup_fee: #{@setup_fee.inspect}, shipping_amount:"\
+      " #{@shipping_amount.inspect}, taxes: #{@taxes.inspect}, product_price:"\
+      " #{@product_price.inspect}, subtotal: #{@subtotal.inspect}, total_amount:"\
+      " #{@total_amount.inspect}>"
+    end
+  end
+end

data/lib/paypal_server_sdk/models/order.rb

@@ -11,17 +11,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
 
@@ -38,11 +36,6 @@ module PaypalServerSdk
     # @return [CheckoutPaymentIntent]
     attr_accessor :intent
 
-    # The intent to either capture payment immediately or authorize a payment
-    # for an order after order creation.
-    # @return [Object]
-    attr_accessor :processing_instruction
-
     # The intent to either capture payment immediately or authorize a payment
     # for an order after order creation.
     # @return [Payer]
@@ -81,7 +74,6 @@ module PaypalServerSdk
       @_hash['id'] = 'id'
       @_hash['payment_source'] = 'payment_source'
       @_hash['intent'] = 'intent'
-      @_hash['processing_instruction'] = 'processing_instruction'
       @_hash['payer'] = 'payer'
       @_hash['purchase_units'] = 'purchase_units'
       @_hash['status'] = 'status'
@@ -97,7 +89,6 @@ module PaypalServerSdk
         id
         payment_source
         intent
-        processing_instruction
         payer
         purchase_units
         status
@@ -111,15 +102,13 @@ module PaypalServerSdk
     end
 
     def initialize(create_time: SKIP, update_time: SKIP, id: SKIP,
-                   payment_source: SKIP, intent: SKIP,
-                   processing_instruction: SKIP, payer: SKIP,
+                   payment_source: SKIP, intent: SKIP, payer: SKIP,
                    purchase_units: SKIP, status: SKIP, links: SKIP)
       @create_time = create_time unless create_time == SKIP
       @update_time = update_time unless update_time == SKIP
       @id = id unless id == SKIP
       @payment_source = payment_source unless payment_source == SKIP
       @intent = intent unless intent == SKIP
-      @processing_instruction = processing_instruction unless processing_instruction == SKIP
       @payer = payer unless payer == SKIP
       @purchase_units = purchase_units unless purchase_units == SKIP
       @status = status unless status == SKIP
@@ -137,8 +126,6 @@ module PaypalServerSdk
       payment_source = PaymentSourceResponse.from_hash(hash['payment_source']) if
         hash['payment_source']
       intent = hash.key?('intent') ? hash['intent'] : SKIP
-      processing_instruction =
-        hash.key?('processing_instruction') ? hash['processing_instruction'] : SKIP
       payer = Payer.from_hash(hash['payer']) if hash['payer']
       # Parameter is an array, so we need to iterate through it
       purchase_units = nil
@@ -168,11 +155,27 @@ module PaypalServerSdk
                 id: id,
                 payment_source: payment_source,
                 intent: intent,
-                processing_instruction: processing_instruction,
                 payer: payer,
                 purchase_units: purchase_units,
                 status: status,
                 links: links)
     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}, id: #{@id},"\
+      " payment_source: #{@payment_source}, intent: #{@intent}, payer: #{@payer}, purchase_units:"\
+      " #{@purchase_units}, status: #{@status}, links: #{@links}>"
+    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},"\
+      " id: #{@id.inspect}, payment_source: #{@payment_source.inspect}, intent:"\
+      " #{@intent.inspect}, payer: #{@payer.inspect}, purchase_units: #{@purchase_units.inspect},"\
+      " status: #{@status.inspect}, links: #{@links.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/order_application_context.rb

@@ -5,10 +5,9 @@
 
 module PaypalServerSdk
   # Customizes the payer experience during the approval process for the payment
-  # with PayPal.<blockquote><strong>Note:</strong> Partners and Marketplaces
-  # might configure <code>brand_name</code> and <code>shipping_preference</code>
-  # during partner account setup, which overrides the request
-  # values.</blockquote>
+  # with PayPal. Note: Partners and Marketplaces might configure brand_name and
+  # shipping_preference during partner account setup, which overrides the
+  # request values.
   class OrderApplicationContext < BaseModel
     SKIP = Object.new
     private_constant :SKIP
@@ -44,22 +43,21 @@ module PaypalServerSdk
     # @return [OrderApplicationContextLandingPage]
     attr_accessor :landing_page
 
-    # DEPRECATED. DEPRECATED. The shipping preference:<ul><li>Displays the
-    # shipping address to the customer.</li><li>Enables the customer to choose
-    # an address on the PayPal site.</li><li>Restricts the customer from
-    # changing the address during the payment-approval process.</li></ul>.  The
-    # fields in `application_context` are now available in the
-    # `experience_context` object under the `payment_source` which supports them
-    # (eg. `payment_source.paypal.experience_context.shipping_preference`).
-    # Please specify this field in the `experience_context` object instead of
-    # the `application_context` object.
+    # DEPRECATED. DEPRECATED. The shipping preference: Displays the shipping
+    # address to the customer. Enables the customer to choose an address on the
+    # PayPal site. Restricts the customer from changing the address during the
+    # payment-approval process. .  The fields in `application_context` are now
+    # available in the `experience_context` object under the `payment_source`
+    # which supports them (eg.
+    # `payment_source.paypal.experience_context.shipping_preference`). Please
+    # specify this field in the `experience_context` object instead of the
+    # `application_context` object.
     # @return [OrderApplicationContextShippingPreference]
     attr_accessor :shipping_preference
 
-    # DEPRECATED. Configures a <strong>Continue</strong> or <strong>Pay
-    # Now</strong> checkout flow.  The fields in `application_context` are now
-    # available in the `experience_context` object under the `payment_source`
-    # which supports them (eg.
+    # DEPRECATED. Configures a Continue or Pay Now checkout flow.  The fields in
+    # `application_context` are now available in the `experience_context` object
+    # under the `payment_source` which supports them (eg.
     # `payment_source.paypal.experience_context.user_action`). Please specify
     # this field in the `experience_context` object instead of the
     # `application_context` object.
@@ -91,16 +89,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.
     # @return [StoredPaymentSource]
     attr_accessor :stored_payment_source
 
@@ -189,5 +185,24 @@ module PaypalServerSdk
                                   cancel_url: cancel_url,
                                   stored_payment_source: stored_payment_source)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} brand_name: #{@brand_name}, locale: #{@locale}, landing_page:"\
+      " #{@landing_page}, shipping_preference: #{@shipping_preference}, user_action:"\
+      " #{@user_action}, payment_method: #{@payment_method}, return_url: #{@return_url},"\
+      " cancel_url: #{@cancel_url}, stored_payment_source: #{@stored_payment_source}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} brand_name: #{@brand_name.inspect}, locale: #{@locale.inspect},"\
+      " landing_page: #{@landing_page.inspect}, shipping_preference:"\
+      " #{@shipping_preference.inspect}, user_action: #{@user_action.inspect}, payment_method:"\
+      " #{@payment_method.inspect}, return_url: #{@return_url.inspect}, cancel_url:"\
+      " #{@cancel_url.inspect}, stored_payment_source: #{@stored_payment_source.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/order_application_context_landing_page.rb

@@ -13,13 +13,20 @@ module PaypalServerSdk
   # `application_context` object.
   class OrderApplicationContextLandingPage
     ORDER_APPLICATION_CONTEXT_LANDING_PAGE = [
-      # TODO: Write general description for LOGIN
+      # When the customer clicks PayPal Checkout, the customer is redirected to
+      # a page to log in to PayPal and approve the payment.
       LOGIN = 'LOGIN'.freeze,
 
-      # TODO: Write general description for BILLING
+      # When the customer clicks PayPal Checkout, the customer is redirected to
+      # a page to enter credit or debit card and other relevant billing
+      # information required to complete the purchase.
       BILLING = 'BILLING'.freeze,
 
-      # TODO: Write general description for NO_PREFERENCE
+      # When the customer clicks PayPal Checkout, the customer is redirected to
+      # either a page to log in to PayPal and approve the payment or to a page
+      # to enter credit or debit card and other relevant billing information
+      # required to complete the purchase, depending on their previous
+      # interaction with PayPal.
       NO_PREFERENCE = 'NO_PREFERENCE'.freeze
     ].freeze