paypal-server-sdk 0.6.1 → 0.7.0

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

data/lib/paypal_server_sdk/models/order_authorize_request_payment_source.rb

@@ -9,15 +9,11 @@ module PaypalServerSdk
     SKIP = Object.new
     private_constant :SKIP
 
-    # The payment card to use to fund a payment. Can be a credit or debit
-    # card.<blockquote><strong>Note:</strong> Passing card number, cvv and
-    # expiry directly via the API requires <a
-    # href="https://www.pcisecuritystandards.org/pci_security/completing_self_as
-    # sessment"> PCI SAQ D compliance</a>. <br>*PayPal offers a mechanism by
-    # which you do not have to take on the <strong>PCI SAQ D</strong> burden by
-    # using hosted fields - refer to <a
-    # href="https://developer.paypal.com/docs/checkout/advanced/integrate/">this
-    # Integration Guide</a>*.</blockquote>
+    # The payment card to use to fund a payment. Can be a credit or debit card.
+    # Note: Passing card number, cvv and expiry directly via the API requires
+    # PCI SAQ D compliance. *PayPal offers a mechanism by which you do not have
+    # to take on the PCI SAQ D burden by using hosted fields - refer to this
+    # Integration Guide*.
     # @return [CardRequest]
     attr_accessor :card
 
@@ -100,5 +96,20 @@ module PaypalServerSdk
                                              google_pay: google_pay,
                                              venmo: venmo)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} card: #{@card}, token: #{@token}, paypal: #{@paypal}, apple_pay:"\
+      " #{@apple_pay}, google_pay: #{@google_pay}, venmo: #{@venmo}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} card: #{@card.inspect}, token: #{@token.inspect}, paypal:"\
+      " #{@paypal.inspect}, apple_pay: #{@apple_pay.inspect}, google_pay: #{@google_pay.inspect},"\
+      " venmo: #{@venmo.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/order_authorize_response.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]
@@ -74,7 +67,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'
@@ -90,7 +82,6 @@ module PaypalServerSdk
         id
         payment_source
         intent
-        processing_instruction
         payer
         purchase_units
         status
@@ -104,15 +95,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
@@ -130,8 +119,6 @@ module PaypalServerSdk
       payment_source = OrderAuthorizeResponsePaymentSource.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
@@ -161,11 +148,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_authorize_response_payment_source.rb

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

data/lib/paypal_server_sdk/models/order_capture_request.rb

@@ -47,5 +47,17 @@ module PaypalServerSdk
       # Create object from extracted values.
       OrderCaptureRequest.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

data/lib/paypal_server_sdk/models/order_capture_request_payment_source.rb

@@ -9,15 +9,11 @@ module PaypalServerSdk
     SKIP = Object.new
     private_constant :SKIP
 
-    # The payment card to use to fund a payment. Can be a credit or debit
-    # card.<blockquote><strong>Note:</strong> Passing card number, cvv and
-    # expiry directly via the API requires <a
-    # href="https://www.pcisecuritystandards.org/pci_security/completing_self_as
-    # sessment"> PCI SAQ D compliance</a>. <br>*PayPal offers a mechanism by
-    # which you do not have to take on the <strong>PCI SAQ D</strong> burden by
-    # using hosted fields - refer to <a
-    # href="https://developer.paypal.com/docs/checkout/advanced/integrate/">this
-    # Integration Guide</a>*.</blockquote>
+    # The payment card to use to fund a payment. Can be a credit or debit card.
+    # Note: Passing card number, cvv and expiry directly via the API requires
+    # PCI SAQ D compliance. *PayPal offers a mechanism by which you do not have
+    # to take on the PCI SAQ D burden by using hosted fields - refer to this
+    # Integration Guide*.
     # @return [CardRequest]
     attr_accessor :card
 
@@ -100,5 +96,20 @@ module PaypalServerSdk
                                            google_pay: google_pay,
                                            venmo: venmo)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} card: #{@card}, token: #{@token}, paypal: #{@paypal}, apple_pay:"\
+      " #{@apple_pay}, google_pay: #{@google_pay}, venmo: #{@venmo}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} card: #{@card.inspect}, token: #{@token.inspect}, paypal:"\
+      " #{@paypal.inspect}, apple_pay: #{@apple_pay.inspect}, google_pay: #{@google_pay.inspect},"\
+      " venmo: #{@venmo.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/order_confirm_application_context.rb

@@ -37,16 +37,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
 
@@ -105,5 +103,20 @@ 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}, 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}, 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_request.rb

@@ -30,10 +30,9 @@ module PaypalServerSdk
     attr_accessor :payment_source
 
     # 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>
+    # payment with PayPal. Note: Partners and Marketplaces might configure
+    # brand_name and shipping_preference during partner account setup, which
+    # overrides the request values.
     # @return [OrderApplicationContext]
     attr_accessor :application_context
 
@@ -99,5 +98,20 @@ module PaypalServerSdk
                        payment_source: payment_source,
                        application_context: application_context)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} intent: #{@intent}, payer: #{@payer}, purchase_units: #{@purchase_units},"\
+      " payment_source: #{@payment_source}, application_context: #{@application_context}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} intent: #{@intent.inspect}, payer: #{@payer.inspect}, purchase_units:"\
+      " #{@purchase_units.inspect}, payment_source: #{@payment_source.inspect},"\
+      " application_context: #{@application_context.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/order_status.rb

@@ -7,22 +7,35 @@ module PaypalServerSdk
   # The order status.
   class OrderStatus
     ORDER_STATUS = [
-      # TODO: Write general description for CREATED
+      # The order was created with the specified context.
       CREATED = 'CREATED'.freeze,
 
-      # TODO: Write general description for SAVED
+      # The order was saved and persisted. The order status continues to be in
+      # progress until a capture is made with final_capture = true for all
+      # purchase units within the order.
       SAVED = 'SAVED'.freeze,
 
-      # TODO: Write general description for APPROVED
+      # The customer approved the payment through the PayPal wallet or another
+      # form of guest or unbranded payment. For example, a card, bank account,
+      # or so on.
       APPROVED = 'APPROVED'.freeze,
 
-      # TODO: Write general description for VOIDED
+      # All purchase units in the order are voided.
       VOIDED = 'VOIDED'.freeze,
 
-      # TODO: Write general description for COMPLETED
+      # The intent of the Order was completed and a `payments` resource was
+      # created. A completed Order may have authorized a payment, captured an
+      # authorized payment, or in some cases, the payment may have been
+      # declined. Please verify the payment status under
+      # purchase_unitsArray.payments before proceeding with Order fulfillment.
       COMPLETED = 'COMPLETED'.freeze,
 
-      # TODO: Write general description for PAYER_ACTION_REQUIRED
+      # The order requires an action from the payer (e.g. 3DS authentication).
+      # Redirect the payer to the "rel":"payer-action" HATEOAS link returned as
+      # part of the response prior to authorizing or capturing the order. Some
+      # payment sources may not return a payer-action HATEOAS link (eg. MB WAY).
+      # For these payment sources the payer-action is managed by the scheme
+      # itself (eg. through SMS, email, in-app notification, etc).
       PAYER_ACTION_REQUIRED = 'PAYER_ACTION_REQUIRED'.freeze
     ].freeze
 

data/lib/paypal_server_sdk/models/order_tracker_item.rb

@@ -95,5 +95,20 @@ module PaypalServerSdk
                            image_url: image_url,
                            upc: upc)
     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}, sku: #{@sku}, url: #{@url},"\
+      " image_url: #{@image_url}, upc: #{@upc}>"
+    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}, sku:"\
+      " #{@sku.inspect}, url: #{@url.inspect}, image_url: #{@image_url.inspect}, upc:"\
+      " #{@upc.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/order_tracker_request.rb

@@ -19,8 +19,7 @@ module PaypalServerSdk
     # your country. If the carrier is not available for your country, choose the
     # global version of the carrier. If your carrier name is not in the list,
     # set `carrier` to `OTHER` and set carrier name in `carrier_name_other`. For
-    # allowed values, see <a
-    # href="/docs/tracking/reference/carriers/">Carriers</a>.
+    # allowed values, see Carriers.
     # @return [ShipmentCarrier]
     attr_accessor :carrier
 
@@ -33,9 +32,11 @@ module PaypalServerSdk
     # @return [String]
     attr_accessor :capture_id
 
-    # If true, sends an email notification to the payer of the PayPal
-    # transaction. The email contains the tracking information that was uploaded
-    # through the API.
+    # If true, PayPal will send an email notification to the payer of the PayPal
+    # transaction. The email contains the tracking details provided through the
+    # Orders tracking API request. Independent of any value passed for
+    # `notify_payer`, the payer may receive tracking notifications within the
+    # PayPal app, based on the user's notification preferences.
     # @return [TrueClass | FalseClass]
     attr_accessor :notify_payer
 
@@ -112,5 +113,21 @@ module PaypalServerSdk
                               notify_payer: notify_payer,
                               items: items)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} tracking_number: #{@tracking_number}, carrier: #{@carrier},"\
+      " carrier_name_other: #{@carrier_name_other}, capture_id: #{@capture_id}, notify_payer:"\
+      " #{@notify_payer}, items: #{@items}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} tracking_number: #{@tracking_number.inspect}, carrier: #{@carrier.inspect},"\
+      " carrier_name_other: #{@carrier_name_other.inspect}, capture_id: #{@capture_id.inspect},"\
+      " notify_payer: #{@notify_payer.inspect}, items: #{@items.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/order_tracker_response.rb

@@ -27,17 +27,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
 
@@ -118,5 +116,20 @@ module PaypalServerSdk
                                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} id: #{@id}, status: #{@status}, items: #{@items}, links: #{@links},"\
+      " 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} id: #{@id.inspect}, status: #{@status.inspect}, items: #{@items.inspect},"\
+      " links: #{@links.inspect}, create_time: #{@create_time.inspect}, update_time:"\
+      " #{@update_time.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/order_tracker_status.rb

@@ -7,10 +7,13 @@ module PaypalServerSdk
   # The status of the item shipment.
   class OrderTrackerStatus
     ORDER_TRACKER_STATUS = [
-      # TODO: Write general description for CANCELLED
+      # The shipment was cancelled and the tracking number no longer applies.
       CANCELLED = 'CANCELLED'.freeze,
 
-      # TODO: Write general description for SHIPPED
+      # The merchant has assigned a tracking number to the items being shipped
+      # from the Order. This does not correspond to the carrier's actual status
+      # for the shipment. The latest status of the parcel must be retrieved from
+      # the carrier.
       SHIPPED = 'SHIPPED'.freeze
     ].freeze