paypal-server-sdk 0.6.0 → 0.7.0

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,8 @@ module PaypalServerSdk
     # @return [CheckoutPaymentIntent]
     attr_accessor :intent
 
-    # The instruction to process an order.
-    # @return [ProcessingInstruction]
-    attr_accessor :processing_instruction
-
-    # The instruction to process an order.
+    # The intent to either capture payment immediately or authorize a payment
+    # for an order after order creation.
     # @return [Payer]
     attr_accessor :payer
 
@@ -58,10 +53,10 @@ module PaypalServerSdk
     attr_accessor :status
 
     # An array of request-related HATEOAS links. To complete payer approval, use
-    # the `approve` link to redirect the payer. The API caller has 3 hours
+    # the `approve` link to redirect the payer. The API caller has 6 hours
     # (default setting, this which can be changed by your account manager to
     # 24/48/72 hours to accommodate your use case) from the time the order is
-    # created, to redirect your payer. Once redirected, the API caller has 3
+    # created, to redirect your payer. Once redirected, the API caller has 6
     # hours for the payer to approve the order and either authorize or capture
     # the order. If you are not using the PayPal JavaScript SDK to initiate
     # PayPal Checkout (in context) ensure that you include
@@ -79,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'
@@ -95,7 +89,6 @@ module PaypalServerSdk
         id
         payment_source
         intent
-        processing_instruction
         payer
         purchase_units
         status
@@ -108,18 +101,14 @@ module PaypalServerSdk
       []
     end
 
-    def initialize(
-      create_time: SKIP, update_time: SKIP, id: SKIP, payment_source: SKIP,
-      intent: SKIP,
-      processing_instruction: ProcessingInstruction::NO_INSTRUCTION,
-      payer: SKIP, purchase_units: SKIP, status: SKIP, links: SKIP
-    )
+    def initialize(create_time: SKIP, update_time: SKIP, id: 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['processing_instruction'] ||= ProcessingInstruction::NO_INSTRUCTION
       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
 

data/lib/paypal_server_sdk/models/order_application_context_shipping_preference.rb

@@ -4,24 +4,28 @@
 # ( https://apimatic.io ).
 
 module PaypalServerSdk
-  # 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.
+  # 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.
+  # `application_context` object., The shipping preference. This only applies to
+  # PayPal payment source., The shipping preference. This only applies to PayPal
+  # payment source.
   class OrderApplicationContextShippingPreference
     ORDER_APPLICATION_CONTEXT_SHIPPING_PREFERENCE = [
-      # TODO: Write general description for GET_FROM_FILE
+      # Use the customer-provided shipping address on the PayPal site.
       GET_FROM_FILE = 'GET_FROM_FILE'.freeze,
 
-      # TODO: Write general description for NO_SHIPPING
+      # Redact the shipping address from the PayPal site. Recommended for
+      # digital goods.
       NO_SHIPPING = 'NO_SHIPPING'.freeze,
 
-      # TODO: Write general description for SET_PROVIDED_ADDRESS
+      # Use the merchant-provided address. The customer cannot change this
+      # address on the PayPal site.
       SET_PROVIDED_ADDRESS = 'SET_PROVIDED_ADDRESS'.freeze
     ].freeze
 

data/lib/paypal_server_sdk/models/order_application_context_user_action.rb

@@ -4,19 +4,24 @@
 # ( https://apimatic.io ).
 
 module PaypalServerSdk
-  # 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.
   class OrderApplicationContextUserAction
     ORDER_APPLICATION_CONTEXT_USER_ACTION = [
-      # TODO: Write general description for CONTINUE
+      # After you redirect the customer to the PayPal payment page, a Continue
+      # button appears. Use this option when the final amount is not known when
+      # the checkout flow is initiated and you want to redirect the customer to
+      # the merchant page without processing the payment.
       CONTINUE = 'CONTINUE'.freeze,
 
-      # TODO: Write general description for PAY_NOW
+      # After you redirect the customer to the PayPal payment page, a Pay Now
+      # button appears. Use this option when the final amount is known when the
+      # checkout is initiated and you want to process the payment immediately
+      # when the customer clicks Pay Now.
       PAY_NOW = 'PAY_NOW'.freeze
     ].freeze
 

data/lib/paypal_server_sdk/models/order_authorize_request.rb

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