paypal-server-sdk 0.6.0 → 0.7.0

data/lib/paypal_server_sdk/models/billing_cycle.rb

@@ -0,0 +1,129 @@
+# paypal_server_sdk
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module PaypalServerSdk
+  # The billing cycle providing details of the billing frequency, amount,
+  # duration and if the billing cycle is a free, discounted or regular billing
+  # cycle. The sequence of the billing cycle will be in the following order -
+  # free trial billing cycle(s), discounted trial billing cycle(s), regular
+  # billing cycle(s).
+  class BillingCycle < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # The tenure type of the billing cycle identifies if the billing cycle is a
+    # trial(free or discounted) or regular billing cycle.
+    # @return [TenureType]
+    attr_accessor :tenure_type
+
+    # The pricing scheme details.
+    # @return [PricingScheme]
+    attr_accessor :pricing_scheme
+
+    # The frequency details for this billing cycle.
+    # @return [Object]
+    attr_accessor :frequency
+
+    # The number of times this billing cycle gets executed. Trial billing cycles
+    # can only be executed a finite number of times (value between 1 and 999 for
+    # total_cycles). Regular billing cycles can be executed infinite times
+    # (value of 0 for total_cycles) or a finite number of times (value between 1
+    # and 999 for total_cycles).
+    # @return [Integer]
+    attr_accessor :total_cycles
+
+    # The order in which this cycle is to run among other billing cycles. For
+    # example, a trial billing cycle has a `sequence` of `1` while a regular
+    # billing cycle has a `sequence` of `2`, so that trial cycle runs before the
+    # regular cycle.
+    # @return [Integer]
+    attr_accessor :sequence
+
+    # The stand-alone date, in [Internet date and time
+    # format](https://tools.ietf.org/html/rfc3339#section-5.6). To represent
+    # special legal values, such as a date of birth, you should use dates with
+    # no associated time or time-zone data. Whenever possible, use the standard
+    # `date_time` type. This regular expression does not validate all dates. For
+    # example, February 31 is valid and nothing is known about leap years.
+    # @return [String]
+    attr_accessor :start_date
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['tenure_type'] = 'tenure_type'
+      @_hash['pricing_scheme'] = 'pricing_scheme'
+      @_hash['frequency'] = 'frequency'
+      @_hash['total_cycles'] = 'total_cycles'
+      @_hash['sequence'] = 'sequence'
+      @_hash['start_date'] = 'start_date'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        pricing_scheme
+        frequency
+        total_cycles
+        sequence
+        start_date
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(tenure_type:, pricing_scheme: SKIP, frequency: SKIP,
+                   total_cycles: 1, sequence: 1, start_date: SKIP)
+      @tenure_type = tenure_type
+      @pricing_scheme = pricing_scheme unless pricing_scheme == SKIP
+      @frequency = frequency unless frequency == SKIP
+      @total_cycles = total_cycles unless total_cycles == SKIP
+      @sequence = sequence unless sequence == SKIP
+      @start_date = start_date unless start_date == SKIP
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      tenure_type = hash.key?('tenure_type') ? hash['tenure_type'] : nil
+      pricing_scheme = PricingScheme.from_hash(hash['pricing_scheme']) if hash['pricing_scheme']
+      frequency = hash.key?('frequency') ? hash['frequency'] : SKIP
+      total_cycles = hash['total_cycles'] ||= 1
+      sequence = hash['sequence'] ||= 1
+      start_date = hash.key?('start_date') ? hash['start_date'] : SKIP
+
+      # Create object from extracted values.
+      BillingCycle.new(tenure_type: tenure_type,
+                       pricing_scheme: pricing_scheme,
+                       frequency: frequency,
+                       total_cycles: total_cycles,
+                       sequence: sequence,
+                       start_date: start_date)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} tenure_type: #{@tenure_type}, pricing_scheme: #{@pricing_scheme},"\
+      " frequency: #{@frequency}, total_cycles: #{@total_cycles}, sequence: #{@sequence},"\
+      " start_date: #{@start_date}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} tenure_type: #{@tenure_type.inspect}, pricing_scheme:"\
+      " #{@pricing_scheme.inspect}, frequency: #{@frequency.inspect}, total_cycles:"\
+      " #{@total_cycles.inspect}, sequence: #{@sequence.inspect}, start_date:"\
+      " #{@start_date.inspect}>"
+    end
+  end
+end

data/lib/paypal_server_sdk/models/bin_details.rb

@@ -20,11 +20,10 @@ module PaypalServerSdk
     attr_accessor :issuing_bank
 
     # 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 :bin_country_code
 
@@ -84,5 +83,19 @@ module PaypalServerSdk
                      bin_country_code: bin_country_code,
                      products: products)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} bin: #{@bin}, issuing_bank: #{@issuing_bank}, bin_country_code:"\
+      " #{@bin_country_code}, products: #{@products}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} bin: #{@bin.inspect}, issuing_bank: #{@issuing_bank.inspect},"\
+      " bin_country_code: #{@bin_country_code.inspect}, products: #{@products.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/blik_experience_context.rb

@@ -118,5 +118,22 @@ module PaypalServerSdk
                                 consumer_ip: consumer_ip,
                                 consumer_user_agent: consumer_user_agent)
     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}, shipping_preference:"\
+      " #{@shipping_preference}, return_url: #{@return_url}, cancel_url: #{@cancel_url},"\
+      " consumer_ip: #{@consumer_ip}, consumer_user_agent: #{@consumer_user_agent}>"
+    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},"\
+      " shipping_preference: #{@shipping_preference.inspect}, return_url: #{@return_url.inspect},"\
+      " cancel_url: #{@cancel_url.inspect}, consumer_ip: #{@consumer_ip.inspect},"\
+      " consumer_user_agent: #{@consumer_user_agent.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/blik_level0_payment_object.rb

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

data/lib/paypal_server_sdk/models/blik_one_click_payment_object.rb

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

data/lib/paypal_server_sdk/models/blik_one_click_payment_request.rb

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

data/lib/paypal_server_sdk/models/blik_payment_object.rb

@@ -14,19 +14,17 @@ 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
 
-    # 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
 
@@ -82,5 +80,19 @@ module PaypalServerSdk
                             email: email,
                             one_click: one_click)
     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}, email: #{@email},"\
+      " one_click: #{@one_click}>"
+    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}, email:"\
+      " #{@email.inspect}, one_click: #{@one_click.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/blik_payment_request.rb

@@ -14,19 +14,17 @@ 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
 
-    # 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
 
@@ -101,5 +99,21 @@ module PaypalServerSdk
                              level_0: level_0,
                              one_click: one_click)
     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}, email: #{@email},"\
+      " experience_context: #{@experience_context}, level_0: #{@level_0}, one_click:"\
+      " #{@one_click}>"
+    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}, email:"\
+      " #{@email.inspect}, experience_context: #{@experience_context.inspect}, level_0:"\
+      " #{@level_0.inspect}, one_click: #{@one_click.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/callback_configuration.rb

@@ -0,0 +1,75 @@
+# paypal_server_sdk
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module PaypalServerSdk
+  # CallBack Configuration that the merchant can provide to PayPal/Venmo.
+  class CallbackConfiguration < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # An array of callback events merchant can subscribe to for the
+    # corresponding callback url. The SHIPPING_ADDRESS callback event is
+    # required.
+    # @return [Array[CallbackEvents]]
+    attr_accessor :callback_events
+
+    # Merchant provided CallBack url.PayPal/Venmo will use this url to call the
+    # merchant back when the events occur .PayPal/Venmo expects a secured url
+    # usually in the https format.merchant can append the cart id or other
+    # params part of the url as query or path params.
+    # @return [String]
+    attr_accessor :callback_url
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['callback_events'] = 'callback_events'
+      @_hash['callback_url'] = 'callback_url'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      []
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(callback_events:, callback_url:)
+      @callback_events = callback_events
+      @callback_url = callback_url
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      callback_events =
+        hash.key?('callback_events') ? hash['callback_events'] : nil
+      callback_url = hash.key?('callback_url') ? hash['callback_url'] : nil
+
+      # Create object from extracted values.
+      CallbackConfiguration.new(callback_events: callback_events,
+                                callback_url: callback_url)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} callback_events: #{@callback_events}, callback_url: #{@callback_url}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} callback_events: #{@callback_events.inspect}, callback_url:"\
+      " #{@callback_url.inspect}>"
+    end
+  end
+end

data/lib/paypal_server_sdk/models/callback_events.rb

@@ -0,0 +1,27 @@
+# paypal_server_sdk
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module PaypalServerSdk
+  # CallBack event.
+  class CallbackEvents
+    CALLBACK_EVENTS = [
+      # When Buyer changes or selects the shipping address on the PayPal/Venmo
+      # buyer approval flow , PayPal/Venmo will call merchant with the callback
+      # URL to update order totals.
+      SHIPPING_ADDRESS = 'SHIPPING_ADDRESS'.freeze,
+
+      # When Buyer changes or selects the shipping options on the PayPal/Venmo
+      # buyer approval flow , PayPal/Venmo will call merchant with the callback
+      # URL to update order totals.
+      SHIPPING_OPTIONS = 'SHIPPING_OPTIONS'.freeze
+    ].freeze
+
+    def self.validate(value)
+      return false if value.nil?
+
+      true
+    end
+  end
+end

data/lib/paypal_server_sdk/models/capture_incomplete_reason.rb

@@ -7,42 +7,50 @@ module PaypalServerSdk
   # The reason why the captured payment status is `PENDING` or `DENIED`.
   class CaptureIncompleteReason
     CAPTURE_INCOMPLETE_REASON = [
-      # TODO: Write general description for BUYER_COMPLAINT
+      # The payer initiated a dispute for this captured payment with PayPal.
       BUYER_COMPLAINT = 'BUYER_COMPLAINT'.freeze,
 
-      # TODO: Write general description for CHARGEBACK
+      # The captured funds were reversed in response to the payer disputing this
+      # captured payment with the issuer of the financial instrument used to pay
+      # for this captured payment.
       CHARGEBACK = 'CHARGEBACK'.freeze,
 
-      # TODO: Write general description for ECHECK
+      # The payer paid by an eCheck that has not yet cleared.
       ECHECK = 'ECHECK'.freeze,
 
-      # TODO: Write general description for INTERNATIONAL_WITHDRAWAL
+      # Visit your online account. In your **Account Overview**, accept and deny
+      # this payment.
       INTERNATIONAL_WITHDRAWAL = 'INTERNATIONAL_WITHDRAWAL'.freeze,
 
-      # TODO: Write general description for OTHER
+      # No additional specific reason can be provided. For more information
+      # about this captured payment, visit your account online or contact
+      # PayPal.
       OTHER = 'OTHER'.freeze,
 
-      # TODO: Write general description for PENDING_REVIEW
+      # The captured payment is pending manual review.
       PENDING_REVIEW = 'PENDING_REVIEW'.freeze,
 
-      # TODO: Write general description for
-      # RECEIVING_PREFERENCE_MANDATES_MANUAL_ACTION
+      # The payee has not yet set up appropriate receiving preferences for their
+      # account. For more information about how to accept or deny this payment,
+      # visit your account online. This reason is typically offered in scenarios
+      # such as when the currency of the captured payment is different from the
+      # primary holding currency of the payee.
       RECEIVING_PREFERENCE_MANDATES_MANUAL_ACTION = 'RECEIVING_PREFERENCE_MANDATES_MANUAL_ACTION'.freeze,
 
-      # TODO: Write general description for REFUNDED
+      # The captured funds were refunded.
       REFUNDED = 'REFUNDED'.freeze,
 
-      # TODO: Write general description for
-      # TRANSACTION_APPROVED_AWAITING_FUNDING
+      # The payer must send the funds for this captured payment. This code
+      # generally appears for manual EFTs.
       TRANSACTION_APPROVED_AWAITING_FUNDING = 'TRANSACTION_APPROVED_AWAITING_FUNDING'.freeze,
 
-      # TODO: Write general description for UNILATERAL
+      # The payee does not have a PayPal account.
       UNILATERAL = 'UNILATERAL'.freeze,
 
-      # TODO: Write general description for VERIFICATION_REQUIRED
+      # The payee's PayPal account is not verified.
       VERIFICATION_REQUIRED = 'VERIFICATION_REQUIRED'.freeze,
 
-      # TODO: Write general description for DECLINED_BY_RISK_FRAUD_FILTERS
+      # Risk Filter set by the payee failed for the transaction.
       DECLINED_BY_RISK_FRAUD_FILTERS = 'DECLINED_BY_RISK_FRAUD_FILTERS'.freeze
     ].freeze
 

data/lib/paypal_server_sdk/models/capture_payment_instruction.rb

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

data/lib/paypal_server_sdk/models/capture_request.rb

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

data/lib/paypal_server_sdk/models/capture_status.rb

@@ -7,22 +7,26 @@ module PaypalServerSdk
   # The status of the captured payment.
   class CaptureStatus
     CAPTURE_STATUS = [
-      # TODO: Write general description for COMPLETED
+      # The funds for this captured payment were credited to the payee's PayPal
+      # account.
       COMPLETED = 'COMPLETED'.freeze,
 
-      # TODO: Write general description for DECLINED
+      # The funds could not be captured.
       DECLINED = 'DECLINED'.freeze,
 
-      # TODO: Write general description for PARTIALLY_REFUNDED
+      # An amount less than this captured payment's amount was partially
+      # refunded to the payer.
       PARTIALLY_REFUNDED = 'PARTIALLY_REFUNDED'.freeze,
 
-      # TODO: Write general description for PENDING
+      # The funds for this captured payment was not yet credited to the payee's
+      # PayPal account. For more information, see status.details.
       PENDING = 'PENDING'.freeze,
 
-      # TODO: Write general description for REFUNDED
+      # An amount greater than or equal to this captured payment's amount was
+      # refunded to the payer.
       REFUNDED = 'REFUNDED'.freeze,
 
-      # TODO: Write general description for FAILED
+      # There was an error while capturing payment.
       FAILED = 'FAILED'.freeze
     ].freeze
 

data/lib/paypal_server_sdk/models/capture_status_details.rb

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

data/lib/paypal_server_sdk/models/capture_status_with_details.rb

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