paypal-server-sdk 0.6.1 → 0.7.0

data/lib/paypal_server_sdk/models/apple_pay_attributes.rb

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

data/lib/paypal_server_sdk/models/apple_pay_attributes_response.rb

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

data/lib/paypal_server_sdk/models/apple_pay_card.rb

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

data/lib/paypal_server_sdk/models/apple_pay_card_response.rb

@@ -51,6 +51,19 @@ module PaypalServerSdk
     # @return [BinDetails]
     attr_accessor :bin_details
 
+    # Provides additional details to process a payment using a `card` that has
+    # been stored or is intended to be stored (also referred to as
+    # stored_credential or card-on-file). Parameter compatibility:
+    # `payment_type=ONE_TIME` is compatible only with
+    # `payment_initiator=CUSTOMER`. `usage=FIRST` is compatible only with
+    # `payment_initiator=CUSTOMER`. `previous_transaction_reference` or
+    # `previous_network_transaction_reference` is compatible only with
+    # `payment_initiator=MERCHANT`. Only one of the parameters -
+    # `previous_transaction_reference` and
+    # `previous_network_transaction_reference` - can be present in the request.
+    # @return [CardStoredCredential]
+    attr_accessor :stored_credential
+
     # The portable international postal address. Maps to
     # [AddressValidationMetadata](https://github.com/googlei18n/libaddressinput/
     # wiki/AddressValidationMetadata) and HTML 5.1 [Autofilling form controls:
@@ -61,11 +74,10 @@ module PaypalServerSdk
     attr_accessor :billing_address
 
     # The [two-character ISO 3166-1 code](/api/rest/reference/country-codes/)
-    # that identifies the country or region.<blockquote><strong>Note:</strong>
-    # The country code for Great Britain is <code>GB</code> and not
-    # <code>UK</code> as used in the top-level domain names for that country.
-    # Use the `C2` country code for China worldwide for comparable uncontrolled
-    # price (CUP) method, bank card, and cross-border transactions.</blockquote>
+    # that identifies the country or region. Note: The country code for Great
+    # Britain is GB and not UK as used in the top-level domain names for that
+    # country. Use the `C2` country code for China worldwide for comparable
+    # uncontrolled price (CUP) method, bank card, and cross-border transactions.
     # @return [String]
     attr_accessor :country_code
 
@@ -82,6 +94,7 @@ module PaypalServerSdk
       @_hash['from_request'] = 'from_request'
       @_hash['expiry'] = 'expiry'
       @_hash['bin_details'] = 'bin_details'
+      @_hash['stored_credential'] = 'stored_credential'
       @_hash['billing_address'] = 'billing_address'
       @_hash['country_code'] = 'country_code'
       @_hash
@@ -100,6 +113,7 @@ module PaypalServerSdk
         from_request
         expiry
         bin_details
+        stored_credential
         billing_address
         country_code
       ]
@@ -114,7 +128,8 @@ module PaypalServerSdk
                    available_networks: SKIP, type: SKIP,
                    authentication_result: SKIP, attributes: SKIP,
                    from_request: SKIP, expiry: SKIP, bin_details: SKIP,
-                   billing_address: SKIP, country_code: SKIP)
+                   stored_credential: SKIP, billing_address: SKIP,
+                   country_code: SKIP)
       @name = name unless name == SKIP
       @last_digits = last_digits unless last_digits == SKIP
       @brand = brand unless brand == SKIP
@@ -125,6 +140,7 @@ module PaypalServerSdk
       @from_request = from_request unless from_request == SKIP
       @expiry = expiry unless expiry == SKIP
       @bin_details = bin_details unless bin_details == SKIP
+      @stored_credential = stored_credential unless stored_credential == SKIP
       @billing_address = billing_address unless billing_address == SKIP
       @country_code = country_code unless country_code == SKIP
     end
@@ -146,6 +162,8 @@ module PaypalServerSdk
       from_request = CardFromRequest.from_hash(hash['from_request']) if hash['from_request']
       expiry = hash.key?('expiry') ? hash['expiry'] : SKIP
       bin_details = BinDetails.from_hash(hash['bin_details']) if hash['bin_details']
+      stored_credential = CardStoredCredential.from_hash(hash['stored_credential']) if
+        hash['stored_credential']
       billing_address = Address.from_hash(hash['billing_address']) if hash['billing_address']
       country_code = hash.key?('country_code') ? hash['country_code'] : SKIP
 
@@ -160,8 +178,32 @@ module PaypalServerSdk
                                from_request: from_request,
                                expiry: expiry,
                                bin_details: bin_details,
+                               stored_credential: stored_credential,
                                billing_address: billing_address,
                                country_code: country_code)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} name: #{@name}, last_digits: #{@last_digits}, brand: #{@brand},"\
+      " available_networks: #{@available_networks}, type: #{@type}, authentication_result:"\
+      " #{@authentication_result}, attributes: #{@attributes}, from_request: #{@from_request},"\
+      " expiry: #{@expiry}, bin_details: #{@bin_details}, stored_credential:"\
+      " #{@stored_credential}, billing_address: #{@billing_address}, country_code:"\
+      " #{@country_code}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} name: #{@name.inspect}, last_digits: #{@last_digits.inspect}, brand:"\
+      " #{@brand.inspect}, available_networks: #{@available_networks.inspect}, type:"\
+      " #{@type.inspect}, authentication_result: #{@authentication_result.inspect}, attributes:"\
+      " #{@attributes.inspect}, from_request: #{@from_request.inspect}, expiry:"\
+      " #{@expiry.inspect}, bin_details: #{@bin_details.inspect}, stored_credential:"\
+      " #{@stored_credential.inspect}, billing_address: #{@billing_address.inspect}, country_code:"\
+      " #{@country_code.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/apple_pay_decrypted_token_data.rb

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

data/lib/paypal_server_sdk/models/apple_pay_payment_data.rb

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

data/lib/paypal_server_sdk/models/apple_pay_payment_data_type.rb

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

data/lib/paypal_server_sdk/models/apple_pay_payment_object.rb

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

data/lib/paypal_server_sdk/models/apple_pay_payment_token.rb

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

data/lib/paypal_server_sdk/models/apple_pay_request.rb

@@ -19,11 +19,10 @@ module PaypalServerSdk
     # @return [String]
     attr_accessor :name
 
-    # The internationalized email address.<blockquote><strong>Note:</strong> Up
-    # to 64 characters are allowed before and 255 characters are allowed after
-    # the <code>@</code> sign. However, the generally accepted maximum length
-    # for an email address is 254 characters. The pattern verifies that an
-    # unquoted <code>@</code> sign exists.</blockquote>
+    # The internationalized email address. Note: Up to 64 characters are allowed
+    # before and 255 characters are allowed after the @ sign. However, the
+    # generally accepted maximum length for an email address is 254 characters.
+    # The pattern verifies that an unquoted @ sign exists.
     # @return [String]
     attr_accessor :email_address
 
@@ -38,16 +37,14 @@ module PaypalServerSdk
 
     # Provides additional details to process a payment using a `card` that has
     # been stored or is intended to be stored (also referred to as
-    # stored_credential or card-on-file).<br/>Parameter
-    # compatibility:<br/><ul><li>`payment_type=ONE_TIME` is compatible only with
-    # `payment_initiator=CUSTOMER`.</li><li>`usage=FIRST` is compatible only
-    # with
-    # `payment_initiator=CUSTOMER`.</li><li>`previous_transaction_reference` or
+    # stored_credential or card-on-file). Parameter compatibility:
+    # `payment_type=ONE_TIME` is compatible only with
+    # `payment_initiator=CUSTOMER`. `usage=FIRST` is compatible only with
+    # `payment_initiator=CUSTOMER`. `previous_transaction_reference` or
     # `previous_network_transaction_reference` is compatible only with
-    # `payment_initiator=MERCHANT`.</li><li>Only one of the parameters -
+    # `payment_initiator=MERCHANT`. Only one of the parameters -
     # `previous_transaction_reference` and
-    # `previous_network_transaction_reference` - can be present in the
-    # request.</li></ul>
+    # `previous_network_transaction_reference` - can be present in the request.
     # @return [CardStoredCredential]
     attr_accessor :stored_credential
 
@@ -133,5 +130,22 @@ module PaypalServerSdk
                           vault_id: vault_id,
                           attributes: attributes)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} id: #{@id}, name: #{@name}, email_address: #{@email_address}, phone_number:"\
+      " #{@phone_number}, decrypted_token: #{@decrypted_token}, stored_credential:"\
+      " #{@stored_credential}, vault_id: #{@vault_id}, attributes: #{@attributes}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} id: #{@id.inspect}, name: #{@name.inspect}, email_address:"\
+      " #{@email_address.inspect}, phone_number: #{@phone_number.inspect}, decrypted_token:"\
+      " #{@decrypted_token.inspect}, stored_credential: #{@stored_credential.inspect}, vault_id:"\
+      " #{@vault_id.inspect}, attributes: #{@attributes.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/apple_pay_tokenized_card.rb

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

data/lib/paypal_server_sdk/models/assurance_details.rb

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

data/lib/paypal_server_sdk/models/authentication_response.rb

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

data/lib/paypal_server_sdk/models/authorization.rb

@@ -51,9 +51,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 :expiration_time
 
@@ -64,17 +63,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
 
@@ -188,5 +185,27 @@ 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} status: #{@status}, status_details: #{@status_details}, id: #{@id}, amount:"\
+      " #{@amount}, invoice_id: #{@invoice_id}, custom_id: #{@custom_id},"\
+      " network_transaction_reference: #{@network_transaction_reference}, seller_protection:"\
+      " #{@seller_protection}, expiration_time: #{@expiration_time}, 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} status: #{@status.inspect}, status_details: #{@status_details.inspect}, id:"\
+      " #{@id.inspect}, amount: #{@amount.inspect}, invoice_id: #{@invoice_id.inspect}, custom_id:"\
+      " #{@custom_id.inspect}, network_transaction_reference:"\
+      " #{@network_transaction_reference.inspect}, seller_protection:"\
+      " #{@seller_protection.inspect}, expiration_time: #{@expiration_time.inspect}, links:"\
+      " #{@links.inspect}, create_time: #{@create_time.inspect}, update_time:"\
+      " #{@update_time.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/authorization_incomplete_reason.rb

@@ -7,10 +7,10 @@ module PaypalServerSdk
   # The reason why the authorized status is `PENDING`.
   class AuthorizationIncompleteReason
     AUTHORIZATION_INCOMPLETE_REASON = [
-      # TODO: Write general description for PENDING_REVIEW
+      # Authorization is pending manual review.
       PENDING_REVIEW = 'PENDING_REVIEW'.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/authorization_status.rb

@@ -7,22 +7,28 @@ module PaypalServerSdk
   # The status for the authorized payment.
   class AuthorizationStatus
     AUTHORIZATION_STATUS = [
-      # TODO: Write general description for CREATED
+      # The authorized payment is created. No captured payments have been made
+      # for this authorized payment.
       CREATED = 'CREATED'.freeze,
 
-      # TODO: Write general description for CAPTURED
+      # The authorized payment has one or more captures against it. The sum of
+      # these captured payments is greater than the amount of the original
+      # authorized payment.
       CAPTURED = 'CAPTURED'.freeze,
 
-      # TODO: Write general description for DENIED
+      # PayPal cannot authorize funds for this authorized payment.
       DENIED = 'DENIED'.freeze,
 
-      # TODO: Write general description for PARTIALLY_CAPTURED
+      # A captured payment was made for the authorized payment for an amount
+      # that is less than the amount of the original authorized payment.
       PARTIALLY_CAPTURED = 'PARTIALLY_CAPTURED'.freeze,
 
-      # TODO: Write general description for VOIDED
+      # The authorized payment was voided. No more captured payments can be made
+      # against this authorized payment.
       VOIDED = 'VOIDED'.freeze,
 
-      # TODO: Write general description for PENDING
+      # The created authorization is in pending state. For more information, see
+      # status.details.
       PENDING = 'PENDING'.freeze
     ].freeze
 

data/lib/paypal_server_sdk/models/authorization_status_details.rb

@@ -46,5 +46,17 @@ module PaypalServerSdk
       # Create object from extracted values.
       AuthorizationStatusDetails.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/authorization_status_with_details.rb

@@ -56,5 +56,17 @@ module PaypalServerSdk
       AuthorizationStatusWithDetails.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