paypal-server-sdk 0.6.1 → 0.7.0

data/lib/paypal_server_sdk/models/paypal_wallet.rb

@@ -15,11 +15,10 @@ module PaypalServerSdk
     # @return [String]
     attr_accessor :vault_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
 
@@ -59,10 +58,9 @@ module PaypalServerSdk
     attr_accessor :attributes
 
     # Customizes the payer experience during the approval process for payment
-    # with PayPal.<blockquote><strong>Note:</strong> Partners and Marketplaces
-    # might configure <code>brand_name</code> and
-    # <code>shipping_preference</code> during partner account setup, which
-    # overrides the request values.</blockquote>
+    # with PayPal. Note: Partners and Marketplaces might configure brand_name
+    # and shipping_preference during partner account setup, which overrides the
+    # request values.
     # @return [PaypalWalletExperienceContext]
     attr_accessor :experience_context
 
@@ -71,6 +69,12 @@ module PaypalServerSdk
     # @return [String]
     attr_accessor :billing_agreement_id
 
+    # Provides additional details to process a payment using the PayPal wallet
+    # billing agreement or a vaulted payment method that has been stored or is
+    # intended to be stored.
+    # @return [PaypalWalletStoredCredential]
+    attr_accessor :stored_credential
+
     # A mapping from model property names to API property names.
     def self.names
       @_hash = {} if @_hash.nil?
@@ -84,6 +88,7 @@ module PaypalServerSdk
       @_hash['attributes'] = 'attributes'
       @_hash['experience_context'] = 'experience_context'
       @_hash['billing_agreement_id'] = 'billing_agreement_id'
+      @_hash['stored_credential'] = 'stored_credential'
       @_hash
     end
 
@@ -100,6 +105,7 @@ module PaypalServerSdk
         attributes
         experience_context
         billing_agreement_id
+        stored_credential
       ]
     end
 
@@ -111,7 +117,7 @@ module PaypalServerSdk
     def initialize(vault_id: SKIP, email_address: SKIP, name: SKIP, phone: SKIP,
                    birth_date: SKIP, tax_info: SKIP, address: SKIP,
                    attributes: SKIP, experience_context: SKIP,
-                   billing_agreement_id: SKIP)
+                   billing_agreement_id: SKIP, stored_credential: SKIP)
       @vault_id = vault_id unless vault_id == SKIP
       @email_address = email_address unless email_address == SKIP
       @name = name unless name == SKIP
@@ -122,6 +128,7 @@ module PaypalServerSdk
       @attributes = attributes unless attributes == SKIP
       @experience_context = experience_context unless experience_context == SKIP
       @billing_agreement_id = billing_agreement_id unless billing_agreement_id == SKIP
+      @stored_credential = stored_credential unless stored_credential == SKIP
     end
 
     # Creates an instance of the object from a hash.
@@ -141,6 +148,8 @@ module PaypalServerSdk
         hash['experience_context']
       billing_agreement_id =
         hash.key?('billing_agreement_id') ? hash['billing_agreement_id'] : SKIP
+      stored_credential = PaypalWalletStoredCredential.from_hash(hash['stored_credential']) if
+        hash['stored_credential']
 
       # Create object from extracted values.
       PaypalWallet.new(vault_id: vault_id,
@@ -152,7 +161,28 @@ module PaypalServerSdk
                        address: address,
                        attributes: attributes,
                        experience_context: experience_context,
-                       billing_agreement_id: billing_agreement_id)
+                       billing_agreement_id: billing_agreement_id,
+                       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} vault_id: #{@vault_id}, email_address: #{@email_address}, name: #{@name},"\
+      " phone: #{@phone}, birth_date: #{@birth_date}, tax_info: #{@tax_info}, address:"\
+      " #{@address}, attributes: #{@attributes}, experience_context: #{@experience_context},"\
+      " billing_agreement_id: #{@billing_agreement_id}, 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} vault_id: #{@vault_id.inspect}, email_address: #{@email_address.inspect},"\
+      " name: #{@name.inspect}, phone: #{@phone.inspect}, birth_date: #{@birth_date.inspect},"\
+      " tax_info: #{@tax_info.inspect}, address: #{@address.inspect}, attributes:"\
+      " #{@attributes.inspect}, experience_context: #{@experience_context.inspect},"\
+      " billing_agreement_id: #{@billing_agreement_id.inspect}, stored_credential:"\
+      " #{@stored_credential.inspect}>"
     end
   end
 end

data/lib/paypal_server_sdk/models/paypal_wallet_account_verification_status.rb

@@ -8,10 +8,14 @@ module PaypalServerSdk
   # details associated with their PayPal account.
   class PaypalWalletAccountVerificationStatus
     PAYPAL_WALLET_ACCOUNT_VERIFICATION_STATUS = [
-      # TODO: Write general description for VERIFIED
+      # The buyer has completed the verification of the financial details
+      # associated with this PayPal account. For example: confirming their bank
+      # account.
       VERIFIED = 'VERIFIED'.freeze,
 
-      # TODO: Write general description for UNVERIFIED
+      # The buyer has not completed the verification of the financial details
+      # associated with this PayPal account. For example: confirming their bank
+      # account.
       UNVERIFIED = 'UNVERIFIED'.freeze
     ].freeze
 

data/lib/paypal_server_sdk/models/paypal_wallet_attributes.rb

@@ -55,5 +55,17 @@ module PaypalServerSdk
       PaypalWalletAttributes.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/paypal_wallet_attributes_response.rb

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

data/lib/paypal_server_sdk/models/paypal_wallet_context_shipping_preference.rb

@@ -0,0 +1,31 @@
+# paypal_server_sdk
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module PaypalServerSdk
+  # The location from which the shipping address is derived.
+  class PaypalWalletContextShippingPreference
+    PAYPAL_WALLET_CONTEXT_SHIPPING_PREFERENCE = [
+      # Get the customer-provided shipping address on the PayPal site.
+      GET_FROM_FILE = 'GET_FROM_FILE'.freeze,
+
+      # Removes the shipping address information from the API response and the
+      # Paypal site. However, the shipping.phone_number and
+      # shipping.email_address fields will still be returned to allow for
+      # digital goods delivery.
+      NO_SHIPPING = 'NO_SHIPPING'.freeze,
+
+      # Get the merchant-provided address. The customer cannot change this
+      # address on the PayPal site. If merchant does not pass an address,
+      # customer can choose the address on PayPal pages.
+      SET_PROVIDED_ADDRESS = 'SET_PROVIDED_ADDRESS'.freeze
+    ].freeze
+
+    def self.validate(value)
+      return false if value.nil?
+
+      true
+    end
+  end
+end

data/lib/paypal_server_sdk/models/paypal_wallet_customer.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/paypal_wallet_customer_request.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/paypal_wallet_experience_context.rb

@@ -5,10 +5,9 @@
 
 module PaypalServerSdk
   # Customizes the payer experience during the approval process for 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>
+  # PayPal. Note: Partners and Marketplaces might configure brand_name and
+  # shipping_preference during partner account setup, which overrides the
+  # request values.
   class PaypalWalletExperienceContext < BaseModel
     SKIP = Object.new
     private_constant :SKIP
@@ -31,7 +30,7 @@ module PaypalServerSdk
     attr_accessor :locale
 
     # The location from which the shipping address is derived.
-    # @return [ShippingPreference]
+    # @return [PaypalWalletContextShippingPreference]
     attr_accessor :shipping_preference
 
     # Describes the URL.
@@ -46,8 +45,7 @@ module PaypalServerSdk
     # @return [PaypalExperienceLandingPage]
     attr_accessor :landing_page
 
-    # Configures a <strong>Continue</strong> or <strong>Pay Now</strong>
-    # checkout flow.
+    # Configures a Continue or Pay Now checkout flow.
     # @return [PaypalExperienceUserAction]
     attr_accessor :user_action
 
@@ -55,6 +53,10 @@ module PaypalServerSdk
     # @return [PayeePaymentMethodPreference]
     attr_accessor :payment_method_preference
 
+    # CallBack Configuration that the merchant can provide to PayPal/Venmo.
+    # @return [CallbackConfiguration]
+    attr_accessor :order_update_callback_config
+
     # A mapping from model property names to API property names.
     def self.names
       @_hash = {} if @_hash.nil?
@@ -66,6 +68,7 @@ module PaypalServerSdk
       @_hash['landing_page'] = 'landing_page'
       @_hash['user_action'] = 'user_action'
       @_hash['payment_method_preference'] = 'payment_method_preference'
+      @_hash['order_update_callback_config'] = 'order_update_callback_config'
       @_hash
     end
 
@@ -80,6 +83,7 @@ module PaypalServerSdk
         landing_page
         user_action
         payment_method_preference
+        order_update_callback_config
       ]
     end
 
@@ -90,11 +94,12 @@ module PaypalServerSdk
 
     def initialize(
       brand_name: SKIP, locale: SKIP,
-      shipping_preference: ShippingPreference::GET_FROM_FILE, return_url: SKIP,
-      cancel_url: SKIP,
+      shipping_preference: PaypalWalletContextShippingPreference::GET_FROM_FILE,
+      return_url: SKIP, cancel_url: SKIP,
       landing_page: PaypalExperienceLandingPage::NO_PREFERENCE,
       user_action: PaypalExperienceUserAction::CONTINUE,
-      payment_method_preference: PayeePaymentMethodPreference::UNRESTRICTED
+      payment_method_preference: PayeePaymentMethodPreference::UNRESTRICTED,
+      order_update_callback_config: SKIP
     )
       @brand_name = brand_name unless brand_name == SKIP
       @locale = locale unless locale == SKIP
@@ -107,6 +112,10 @@ module PaypalServerSdk
         @payment_method_preference =
           payment_method_preference
       end
+      unless order_update_callback_config == SKIP
+        @order_update_callback_config =
+          order_update_callback_config
+      end
     end
 
     # Creates an instance of the object from a hash.
@@ -117,7 +126,7 @@ module PaypalServerSdk
       brand_name = hash.key?('brand_name') ? hash['brand_name'] : SKIP
       locale = hash.key?('locale') ? hash['locale'] : SKIP
       shipping_preference =
-        hash['shipping_preference'] ||= ShippingPreference::GET_FROM_FILE
+        hash['shipping_preference'] ||= PaypalWalletContextShippingPreference::GET_FROM_FILE
       return_url = hash.key?('return_url') ? hash['return_url'] : SKIP
       cancel_url = hash.key?('cancel_url') ? hash['cancel_url'] : SKIP
       landing_page =
@@ -125,6 +134,9 @@ module PaypalServerSdk
       user_action = hash['user_action'] ||= PaypalExperienceUserAction::CONTINUE
       payment_method_preference =
         hash['payment_method_preference'] ||= PayeePaymentMethodPreference::UNRESTRICTED
+      if hash['order_update_callback_config']
+        order_update_callback_config = CallbackConfiguration.from_hash(hash['order_update_callback_config'])
+      end
 
       # Create object from extracted values.
       PaypalWalletExperienceContext.new(brand_name: brand_name,
@@ -134,7 +146,28 @@ module PaypalServerSdk
                                         cancel_url: cancel_url,
                                         landing_page: landing_page,
                                         user_action: user_action,
-                                        payment_method_preference: payment_method_preference)
+                                        payment_method_preference: payment_method_preference,
+                                        order_update_callback_config: order_update_callback_config)
+    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},"\
+      " landing_page: #{@landing_page}, user_action: #{@user_action}, payment_method_preference:"\
+      " #{@payment_method_preference}, order_update_callback_config:"\
+      " #{@order_update_callback_config}>"
+    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}, landing_page: #{@landing_page.inspect}, user_action:"\
+      " #{@user_action.inspect}, payment_method_preference: #{@payment_method_preference.inspect},"\
+      " order_update_callback_config: #{@order_update_callback_config.inspect}>"
     end
   end
 end

data/lib/paypal_server_sdk/models/paypal_wallet_response.rb

@@ -9,11 +9,10 @@ module PaypalServerSdk
     SKIP = Object.new
     private_constant :SKIP
 
-    # 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
 
@@ -74,6 +73,12 @@ module PaypalServerSdk
     # @return [PaypalWalletAttributesResponse]
     attr_accessor :attributes
 
+    # Provides additional details to process a payment using the PayPal wallet
+    # billing agreement or a vaulted payment method that has been stored or is
+    # intended to be stored.
+    # @return [PaypalWalletStoredCredential]
+    attr_accessor :stored_credential
+
     # A mapping from model property names to API property names.
     def self.names
       @_hash = {} if @_hash.nil?
@@ -88,6 +93,7 @@ module PaypalServerSdk
       @_hash['tax_info'] = 'tax_info'
       @_hash['address'] = 'address'
       @_hash['attributes'] = 'attributes'
+      @_hash['stored_credential'] = 'stored_credential'
       @_hash
     end
 
@@ -105,6 +111,7 @@ module PaypalServerSdk
         tax_info
         address
         attributes
+        stored_credential
       ]
     end
 
@@ -116,7 +123,7 @@ module PaypalServerSdk
     def initialize(email_address: SKIP, account_id: SKIP, account_status: SKIP,
                    name: SKIP, phone_type: SKIP, phone_number: SKIP,
                    birth_date: SKIP, business_name: SKIP, tax_info: SKIP,
-                   address: SKIP, attributes: SKIP)
+                   address: SKIP, attributes: SKIP, stored_credential: SKIP)
       @email_address = email_address unless email_address == SKIP
       @account_id = account_id unless account_id == SKIP
       @account_status = account_status unless account_status == SKIP
@@ -128,6 +135,7 @@ module PaypalServerSdk
       @tax_info = tax_info unless tax_info == SKIP
       @address = address unless address == SKIP
       @attributes = attributes unless attributes == SKIP
+      @stored_credential = stored_credential unless stored_credential == SKIP
     end
 
     # Creates an instance of the object from a hash.
@@ -148,6 +156,8 @@ module PaypalServerSdk
       address = Address.from_hash(hash['address']) if hash['address']
       attributes = PaypalWalletAttributesResponse.from_hash(hash['attributes']) if
         hash['attributes']
+      stored_credential = PaypalWalletStoredCredential.from_hash(hash['stored_credential']) if
+        hash['stored_credential']
 
       # Create object from extracted values.
       PaypalWalletResponse.new(email_address: email_address,
@@ -160,7 +170,29 @@ module PaypalServerSdk
                                business_name: business_name,
                                tax_info: tax_info,
                                address: address,
-                               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} email_address: #{@email_address}, account_id: #{@account_id},"\
+      " account_status: #{@account_status}, name: #{@name}, phone_type: #{@phone_type},"\
+      " phone_number: #{@phone_number}, birth_date: #{@birth_date}, business_name:"\
+      " #{@business_name}, tax_info: #{@tax_info}, address: #{@address}, 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} email_address: #{@email_address.inspect}, account_id:"\
+      " #{@account_id.inspect}, account_status: #{@account_status.inspect}, name:"\
+      " #{@name.inspect}, phone_type: #{@phone_type.inspect}, phone_number:"\
+      " #{@phone_number.inspect}, birth_date: #{@birth_date.inspect}, business_name:"\
+      " #{@business_name.inspect}, tax_info: #{@tax_info.inspect}, address: #{@address.inspect},"\
+      " attributes: #{@attributes.inspect}, stored_credential: #{@stored_credential.inspect}>"
     end
   end
 end

data/lib/paypal_server_sdk/models/paypal_wallet_stored_credential.rb

@@ -0,0 +1,98 @@
+# paypal_server_sdk
+#
+# This file was automatically generated by APIMATIC v2.0
+# ( https://apimatic.io ).
+
+module PaypalServerSdk
+  # Provides additional details to process a payment using the PayPal wallet
+  # billing agreement or a vaulted payment method that has been stored or is
+  # intended to be stored.
+  class PaypalWalletStoredCredential < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # The person or party who initiated or triggered the payment.
+    # @return [PaymentInitiator]
+    attr_accessor :payment_initiator
+
+    # Expected business/pricing model for the billing agreement.
+    # @return [UsagePattern]
+    attr_accessor :charge_pattern
+
+    # Expected business/pricing model for the billing agreement.
+    # @return [UsagePattern]
+    attr_accessor :usage_pattern
+
+    # Indicates if this is a `first` or `subsequent` payment using a stored
+    # payment source (also referred to as stored credential or card on file).
+    # @return [StoredPaymentSourceUsageType]
+    attr_accessor :usage
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['payment_initiator'] = 'payment_initiator'
+      @_hash['charge_pattern'] = 'charge_pattern'
+      @_hash['usage_pattern'] = 'usage_pattern'
+      @_hash['usage'] = 'usage'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        charge_pattern
+        usage_pattern
+        usage
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(payment_initiator:, charge_pattern: SKIP,
+                   usage_pattern: SKIP,
+                   usage: StoredPaymentSourceUsageType::DERIVED)
+      @payment_initiator = payment_initiator
+      @charge_pattern = charge_pattern unless charge_pattern == SKIP
+      @usage_pattern = usage_pattern unless usage_pattern == SKIP
+      @usage = usage unless usage == 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.
+      payment_initiator =
+        hash.key?('payment_initiator') ? hash['payment_initiator'] : nil
+      charge_pattern =
+        hash.key?('charge_pattern') ? hash['charge_pattern'] : SKIP
+      usage_pattern = hash.key?('usage_pattern') ? hash['usage_pattern'] : SKIP
+      usage = hash['usage'] ||= StoredPaymentSourceUsageType::DERIVED
+
+      # Create object from extracted values.
+      PaypalWalletStoredCredential.new(payment_initiator: payment_initiator,
+                                       charge_pattern: charge_pattern,
+                                       usage_pattern: usage_pattern,
+                                       usage: usage)
+    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}, charge_pattern:"\
+      " #{@charge_pattern}, usage_pattern: #{@usage_pattern}, usage: #{@usage}>"
+    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}, charge_pattern:"\
+      " #{@charge_pattern.inspect}, usage_pattern: #{@usage_pattern.inspect}, usage:"\
+      " #{@usage.inspect}>"
+    end
+  end
+end

data/lib/paypal_server_sdk/models/paypal_wallet_vault_instruction.rb

@@ -20,7 +20,7 @@ module PaypalServerSdk
     attr_accessor :description
 
     # Expected business/pricing model for the billing agreement.
-    # @return [PaypalPaymentTokenUsagePattern]
+    # @return [UsagePattern]
     attr_accessor :usage_pattern
 
     # The usage type associated with the PayPal payment token.
@@ -111,5 +111,22 @@ module PaypalServerSdk
                                        customer_type: customer_type,
                                        permit_multiple_payment_tokens: permit_multiple_payment_tokens)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} store_in_vault: #{@store_in_vault}, description: #{@description},"\
+      " usage_pattern: #{@usage_pattern}, usage_type: #{@usage_type}, customer_type:"\
+      " #{@customer_type}, permit_multiple_payment_tokens: #{@permit_multiple_payment_tokens}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} store_in_vault: #{@store_in_vault.inspect}, description:"\
+      " #{@description.inspect}, usage_pattern: #{@usage_pattern.inspect}, usage_type:"\
+      " #{@usage_type.inspect}, customer_type: #{@customer_type.inspect},"\
+      " permit_multiple_payment_tokens: #{@permit_multiple_payment_tokens.inspect}>"
+    end
   end
 end

data/lib/paypal_server_sdk/models/paypal_wallet_vault_response.rb

@@ -82,5 +82,18 @@ module PaypalServerSdk
                                     links: links,
                                     customer: customer)
     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}, links: #{@links}, customer: #{@customer}>"
+    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}, links: #{@links.inspect},"\
+      " customer: #{@customer.inspect}>"
+    end
   end
 end