paypal-server-sdk 0.6.1 → 0.7.0

data/lib/paypal_server_sdk/models/card_brand.rb

@@ -8,79 +8,83 @@ module PaypalServerSdk
   # cards.
   class CardBrand
     CARD_BRAND = [
-      # TODO: Write general description for VISA
+      # Visa card.
       VISA = 'VISA'.freeze,
 
-      # TODO: Write general description for MASTERCARD
+      # Mastecard card.
       MASTERCARD = 'MASTERCARD'.freeze,
 
-      # TODO: Write general description for DISCOVER
+      # Discover card.
       DISCOVER = 'DISCOVER'.freeze,
 
-      # TODO: Write general description for AMEX
+      # American Express card.
       AMEX = 'AMEX'.freeze,
 
-      # TODO: Write general description for SOLO
+      # Solo debit card.
       SOLO = 'SOLO'.freeze,
 
-      # TODO: Write general description for JCB
+      # Japan Credit Bureau card.
       JCB = 'JCB'.freeze,
 
-      # TODO: Write general description for STAR
+      # Military Star card.
       STAR = 'STAR'.freeze,
 
-      # TODO: Write general description for DELTA
+      # Delta Airlines card.
       DELTA = 'DELTA'.freeze,
 
-      # TODO: Write general description for SWITCH
+      # Switch credit card.
       SWITCH = 'SWITCH'.freeze,
 
-      # TODO: Write general description for MAESTRO
+      # Maestro credit card.
       MAESTRO = 'MAESTRO'.freeze,
 
-      # TODO: Write general description for CB_NATIONALE
+      # Carte Bancaire (CB) credit card.
       CB_NATIONALE = 'CB_NATIONALE'.freeze,
 
-      # TODO: Write general description for CONFIGOGA
+      # Configoga credit card.
       CONFIGOGA = 'CONFIGOGA'.freeze,
 
-      # TODO: Write general description for CONFIDIS
+      # Confidis credit card.
       CONFIDIS = 'CONFIDIS'.freeze,
 
-      # TODO: Write general description for ELECTRON
+      # Visa Electron credit card.
       ELECTRON = 'ELECTRON'.freeze,
 
-      # TODO: Write general description for CETELEM
+      # Cetelem credit card.
       CETELEM = 'CETELEM'.freeze,
 
-      # TODO: Write general description for CHINA_UNION_PAY
+      # China union pay credit card.
       CHINA_UNION_PAY = 'CHINA_UNION_PAY'.freeze,
 
-      # TODO: Write general description for DINERS
+      # The Diners Club International banking and payment services capability
+      # network owned by Discover Financial Services (DFS), one of the most
+      # recognized brands in US financial services.
       DINERS = 'DINERS'.freeze,
 
-      # TODO: Write general description for ELO
+      # The Brazilian Elo card payment network.
       ELO = 'ELO'.freeze,
 
-      # TODO: Write general description for HIPER
+      # The Hiper - Ingenico ePayment network.
       HIPER = 'HIPER'.freeze,
 
-      # TODO: Write general description for HIPERCARD
+      # The Brazilian Hipercard payment network that's widely accepted in the
+      # retail market.
       HIPERCARD = 'HIPERCARD'.freeze,
 
-      # TODO: Write general description for RUPAY
+      # The RuPay payment network.
       RUPAY = 'RUPAY'.freeze,
 
-      # TODO: Write general description for GE
+      # The GE Credit Union 3Point card payment network.
       GE = 'GE'.freeze,
 
-      # TODO: Write general description for SYNCHRONY
+      # The Synchrony Financial (SYF) payment network.
       SYNCHRONY = 'SYNCHRONY'.freeze,
 
-      # TODO: Write general description for EFTPOS
+      # The Electronic Fund Transfer At Point of Sale(EFTPOS) Debit card payment
+      # network.
       EFTPOS = 'EFTPOS'.freeze,
 
-      # TODO: Write general description for UNKNOWN
+      # UNKNOWN payment network.
       UNKNOWN = 'UNKNOWN'.freeze
     ].freeze
 

data/lib/paypal_server_sdk/models/card_customer_information.rb

@@ -13,11 +13,10 @@ module PaypalServerSdk
     # @return [String]
     attr_accessor :id
 
-    # 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
 
@@ -81,5 +80,19 @@ module PaypalServerSdk
                                   phone: phone,
                                   merchant_customer_id: merchant_customer_id)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} id: #{@id}, email_address: #{@email_address}, phone: #{@phone},"\
+      " merchant_customer_id: #{@merchant_customer_id}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} id: #{@id.inspect}, email_address: #{@email_address.inspect}, phone:"\
+      " #{@phone.inspect}, merchant_customer_id: #{@merchant_customer_id.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/card_experience_context.rb

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

data/lib/paypal_server_sdk/models/card_from_request.rb

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

data/lib/paypal_server_sdk/models/{card_response_entity.rb → card_payment_token_entity.rb}

@@ -5,7 +5,7 @@
 
 module PaypalServerSdk
   # Full representation of a Card Payment Token.
-  class CardResponseEntity < BaseModel
+  class CardPaymentTokenEntity < BaseModel
     SKIP = Object.new
     private_constant :SKIP
 
@@ -28,11 +28,11 @@ module PaypalServerSdk
     attr_accessor :expiry
 
     # Address request details.
-    # @return [AddressDetails]
+    # @return [CardResponseAddress]
     attr_accessor :billing_address
 
     # Verification status of Card.
-    # @return [String]
+    # @return [CardVerificationStatus]
     attr_accessor :verification_status
 
     # Card Verification details including the authorization details and 3D
@@ -125,7 +125,7 @@ module PaypalServerSdk
       last_digits = hash.key?('last_digits') ? hash['last_digits'] : SKIP
       brand = hash.key?('brand') ? hash['brand'] : SKIP
       expiry = hash.key?('expiry') ? hash['expiry'] : SKIP
-      billing_address = AddressDetails.from_hash(hash['billing_address']) if
+      billing_address = CardResponseAddress.from_hash(hash['billing_address']) if
         hash['billing_address']
       verification_status =
         hash.key?('verification_status') ? hash['verification_status'] : SKIP
@@ -140,17 +140,39 @@ module PaypalServerSdk
       type = hash.key?('type') ? hash['type'] : SKIP
 
       # Create object from extracted values.
-      CardResponseEntity.new(name: name,
-                             last_digits: last_digits,
-                             brand: brand,
-                             expiry: expiry,
-                             billing_address: billing_address,
-                             verification_status: verification_status,
-                             verification: verification,
-                             network_transaction_reference: network_transaction_reference,
-                             authentication_result: authentication_result,
-                             bin_details: bin_details,
-                             type: type)
+      CardPaymentTokenEntity.new(name: name,
+                                 last_digits: last_digits,
+                                 brand: brand,
+                                 expiry: expiry,
+                                 billing_address: billing_address,
+                                 verification_status: verification_status,
+                                 verification: verification,
+                                 network_transaction_reference: network_transaction_reference,
+                                 authentication_result: authentication_result,
+                                 bin_details: bin_details,
+                                 type: type)
+    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}, expiry:"\
+      " #{@expiry}, billing_address: #{@billing_address}, verification_status:"\
+      " #{@verification_status}, verification: #{@verification}, network_transaction_reference:"\
+      " #{@network_transaction_reference}, authentication_result: #{@authentication_result},"\
+      " bin_details: #{@bin_details}, type: #{@type}>"
+    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}, expiry: #{@expiry.inspect}, billing_address:"\
+      " #{@billing_address.inspect}, verification_status: #{@verification_status.inspect},"\
+      " verification: #{@verification.inspect}, network_transaction_reference:"\
+      " #{@network_transaction_reference.inspect}, authentication_result:"\
+      " #{@authentication_result.inspect}, bin_details: #{@bin_details.inspect}, type:"\
+      " #{@type.inspect}>"
     end
   end
 end

data/lib/paypal_server_sdk/models/card_request.rb

@@ -4,15 +4,11 @@
 # ( https://apimatic.io ).
 
 module PaypalServerSdk
-  # 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_asse
-  # ssment"> 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*.
   class CardRequest < BaseModel
     SKIP = Object.new
     private_constant :SKIP
@@ -62,16 +58,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
 
@@ -172,5 +166,26 @@ module PaypalServerSdk
                       network_token: network_token,
                       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}, number: #{@number}, expiry: #{@expiry}, security_code:"\
+      " #{@security_code}, billing_address: #{@billing_address}, attributes: #{@attributes},"\
+      " vault_id: #{@vault_id}, single_use_token: #{@single_use_token}, stored_credential:"\
+      " #{@stored_credential}, network_token: #{@network_token}, 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}, number: #{@number.inspect}, expiry:"\
+      " #{@expiry.inspect}, security_code: #{@security_code.inspect}, billing_address:"\
+      " #{@billing_address.inspect}, attributes: #{@attributes.inspect}, vault_id:"\
+      " #{@vault_id.inspect}, single_use_token: #{@single_use_token.inspect}, stored_credential:"\
+      " #{@stored_credential.inspect}, network_token: #{@network_token.inspect},"\
+      " experience_context: #{@experience_context.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/card_response.rb

@@ -52,6 +52,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
+
     # A mapping from model property names to API property names.
     def self.names
       @_hash = {} if @_hash.nil?
@@ -65,6 +78,7 @@ module PaypalServerSdk
       @_hash['from_request'] = 'from_request'
       @_hash['expiry'] = 'expiry'
       @_hash['bin_details'] = 'bin_details'
+      @_hash['stored_credential'] = 'stored_credential'
       @_hash
     end
 
@@ -81,6 +95,7 @@ module PaypalServerSdk
         from_request
         expiry
         bin_details
+        stored_credential
       ]
     end
 
@@ -92,7 +107,8 @@ module PaypalServerSdk
     def initialize(name: SKIP, last_digits: SKIP, brand: SKIP,
                    available_networks: SKIP, type: SKIP,
                    authentication_result: SKIP, attributes: SKIP,
-                   from_request: SKIP, expiry: SKIP, bin_details: SKIP)
+                   from_request: SKIP, expiry: SKIP, bin_details: SKIP,
+                   stored_credential: SKIP)
       @name = name unless name == SKIP
       @last_digits = last_digits unless last_digits == SKIP
       @brand = brand unless brand == SKIP
@@ -103,6 +119,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
     end
 
     # Creates an instance of the object from a hash.
@@ -122,6 +139,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']
 
       # Create object from extracted values.
       CardResponse.new(name: name,
@@ -133,7 +152,29 @@ module PaypalServerSdk
                        attributes: attributes,
                        from_request: from_request,
                        expiry: expiry,
-                       bin_details: bin_details)
+                       bin_details: bin_details,
+                       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} 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}>"
+    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}>"
     end
   end
 end

data/lib/paypal_server_sdk/models/{portable_postal_address_medium_grained.rb → card_response_address.rb}

@@ -4,13 +4,8 @@
 # ( https://apimatic.io ).
 
 module PaypalServerSdk
-  # The portable international postal address. Maps to
-  # [AddressValidationMetadata](https://github.com/googlei18n/libaddressinput/wi
-  # ki/AddressValidationMetadata) and HTML 5.1 [Autofilling form controls: the
-  # autocomplete
-  # attribute](https://www.w3.org/TR/html51/sec-forms.html#autofilling-form-cont
-  # rols-the-autocomplete-attribute).
-  class PortablePostalAddressMediumGrained < BaseModel
+  # Address request details.
+  class CardResponseAddress < BaseModel
     SKIP = Object.new
     private_constant :SKIP
 
@@ -30,10 +25,9 @@ module PaypalServerSdk
 
     # The highest-level sub-division in a country, which is usually a province,
     # state, or ISO-3166-2 subdivision. This data is formatted for postal
-    # delivery, for example, `CA` and not `California`. Value, by country,
-    # is:<ul><li>UK. A county.</li><li>US. A state.</li><li>Canada. A
-    # province.</li><li>Japan. A prefecture.</li><li>Switzerland. A
-    # *kanton*.</li></ul>
+    # delivery, for example, `CA` and not `California`. Value, by country, is:
+    # UK. A county. US. A state. Canada. A province. Japan. A prefecture.
+    # Switzerland. A *kanton*.
     # @return [String]
     attr_accessor :admin_area_1
 
@@ -44,14 +38,17 @@ module PaypalServerSdk
     attr_accessor :postal_code
 
     # The [2-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>
+    # 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 resource ID of the address.
+    # @return [String]
+    attr_accessor :id
+
     # A mapping from model property names to API property names.
     def self.names
       @_hash = {} if @_hash.nil?
@@ -61,6 +58,7 @@ module PaypalServerSdk
       @_hash['admin_area_1'] = 'admin_area_1'
       @_hash['postal_code'] = 'postal_code'
       @_hash['country_code'] = 'country_code'
+      @_hash['id'] = 'id'
       @_hash
     end
 
@@ -72,6 +70,7 @@ module PaypalServerSdk
         admin_area_2
         admin_area_1
         postal_code
+        id
       ]
     end
 
@@ -81,13 +80,15 @@ module PaypalServerSdk
     end
 
     def initialize(country_code:, address_line_1: SKIP, address_line_2: SKIP,
-                   admin_area_2: SKIP, admin_area_1: SKIP, postal_code: SKIP)
+                   admin_area_2: SKIP, admin_area_1: SKIP, postal_code: SKIP,
+                   id: SKIP)
       @address_line_1 = address_line_1 unless address_line_1 == SKIP
       @address_line_2 = address_line_2 unless address_line_2 == SKIP
       @admin_area_2 = admin_area_2 unless admin_area_2 == SKIP
       @admin_area_1 = admin_area_1 unless admin_area_1 == SKIP
       @postal_code = postal_code unless postal_code == SKIP
       @country_code = country_code
+      @id = id unless id == SKIP
     end
 
     # Creates an instance of the object from a hash.
@@ -103,14 +104,33 @@ module PaypalServerSdk
       admin_area_2 = hash.key?('admin_area_2') ? hash['admin_area_2'] : SKIP
       admin_area_1 = hash.key?('admin_area_1') ? hash['admin_area_1'] : SKIP
       postal_code = hash.key?('postal_code') ? hash['postal_code'] : SKIP
+      id = hash.key?('id') ? hash['id'] : SKIP
 
       # Create object from extracted values.
-      PortablePostalAddressMediumGrained.new(country_code: country_code,
-                                             address_line_1: address_line_1,
-                                             address_line_2: address_line_2,
-                                             admin_area_2: admin_area_2,
-                                             admin_area_1: admin_area_1,
-                                             postal_code: postal_code)
+      CardResponseAddress.new(country_code: country_code,
+                              address_line_1: address_line_1,
+                              address_line_2: address_line_2,
+                              admin_area_2: admin_area_2,
+                              admin_area_1: admin_area_1,
+                              postal_code: postal_code,
+                              id: id)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} address_line_1: #{@address_line_1}, address_line_2: #{@address_line_2},"\
+      " admin_area_2: #{@admin_area_2}, admin_area_1: #{@admin_area_1}, postal_code:"\
+      " #{@postal_code}, country_code: #{@country_code}, id: #{@id}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} address_line_1: #{@address_line_1.inspect}, address_line_2:"\
+      " #{@address_line_2.inspect}, admin_area_2: #{@admin_area_2.inspect}, admin_area_1:"\
+      " #{@admin_area_1.inspect}, postal_code: #{@postal_code.inspect}, country_code:"\
+      " #{@country_code.inspect}, id: #{@id.inspect}>"
     end
   end
 end

data/lib/paypal_server_sdk/models/card_stored_credential.rb

@@ -6,15 +6,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.
   class CardStoredCredential < BaseModel
     SKIP = Object.new
     private_constant :SKIP
@@ -91,5 +90,22 @@ module PaypalServerSdk
                                usage: usage,
                                previous_network_transaction_reference: previous_network_transaction_reference)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} payment_initiator: #{@payment_initiator}, payment_type: #{@payment_type},"\
+      " usage: #{@usage}, previous_network_transaction_reference:"\
+      " #{@previous_network_transaction_reference}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} payment_initiator: #{@payment_initiator.inspect}, payment_type:"\
+      " #{@payment_type.inspect}, usage: #{@usage.inspect},"\
+      ' previous_network_transaction_reference:'\
+      " #{@previous_network_transaction_reference.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/card_supplementary_data.rb

@@ -6,11 +6,7 @@
 module PaypalServerSdk
   # Merchants and partners can add Level 2 and 3 data to payments to reduce risk
   # and payment processing costs. For more information about processing
-  # payments, see <a
-  # href="https://developer.paypal.com/docs/checkout/advanced/processing/">check
-  # out</a> or <a
-  # href="https://developer.paypal.com/docs/multiparty/checkout/advanced/process
-  # ing/">multiparty checkout</a>.
+  # payments, see checkout or multiparty checkout.
   class CardSupplementaryData < BaseModel
     SKIP = Object.new
     private_constant :SKIP
@@ -67,5 +63,17 @@ module PaypalServerSdk
       CardSupplementaryData.new(level_2: level_2,
                                 level_3: level_3)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} level_2: #{@level_2}, level_3: #{@level_3}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} level_2: #{@level_2.inspect}, level_3: #{@level_3.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/card_type.rb

@@ -7,19 +7,19 @@ module PaypalServerSdk
   # Type of card. i.e Credit, Debit and so on.
   class CardType
     CARD_TYPE = [
-      # TODO: Write general description for CREDIT
+      # A credit card.
       CREDIT = 'CREDIT'.freeze,
 
-      # TODO: Write general description for DEBIT
+      # A debit card.
       DEBIT = 'DEBIT'.freeze,
 
-      # TODO: Write general description for PREPAID
+      # A Prepaid card.
       PREPAID = 'PREPAID'.freeze,
 
-      # TODO: Write general description for STORE
+      # A store card.
       STORE = 'STORE'.freeze,
 
-      # TODO: Write general description for UNKNOWN
+      # Card type cannot be determined.
       UNKNOWN = 'UNKNOWN'.freeze
     ].freeze