apimatic-greendot-sdk 0.0.1

data/lib/gd_bos_v1/models/validate_card_response.rb

@@ -0,0 +1,294 @@
+# gd_bos_v1
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module GdBosV1
+  # Represents the response for a card validation operation.
+  class ValidateCardResponse < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # Unique identifier for the account associated with the card being
+    # validated.
+    # @return [String]
+    attr_accessor :account_identifier
+
+    # Unique identifier for the payment instrument being validated.
+    # @return [String]
+    attr_accessor :payment_instrument_identifier
+
+    # The activation status of the payment instrument.
+    # @return [String]
+    attr_accessor :activation_status
+
+    # The list of identity types associated with the cardholder.
+    # @return [Array[IdentityTypes]]
+    attr_accessor :identity_types
+
+    # Indicates whether the date of birth (DOB) provided matches the record.
+    # @return [TrueClass | FalseClass]
+    attr_accessor :is_dob_matched
+
+    # Indicates whether the date of birth (DOB) has been verified.
+    # @return [TrueClass | FalseClass]
+    attr_accessor :is_dob_verified
+
+    # Indicates whether the user is considered a prospect (not yet a full
+    # customer).
+    # @return [TrueClass | FalseClass]
+    attr_accessor :is_prospect
+
+    # The type of prospect, if the user is a prospect.
+    # @return [String]
+    attr_accessor :prospect_type
+
+    # Unique identifier for the prospect, if applicable.
+    # @return [String]
+    attr_accessor :prospect_identifier
+
+    # The status code of the prospect, if applicable.
+    # @return [Integer]
+    attr_accessor :prospect_status
+
+    # Unique identifier for the retail card, if applicable.
+    # @return [String]
+    attr_accessor :retail_card_identifier
+
+    # Indicates whether the card is a retail card.
+    # @return [TrueClass | FalseClass]
+    attr_accessor :is_retail_card
+
+    # The status code of the retail card, if applicable.
+    # @return [Integer]
+    attr_accessor :retail_card_status
+
+    # The product code associated with the card.
+    # @return [String]
+    attr_accessor :product_code
+
+    # Indicates whether the card is expired.
+    # @return [TrueClass | FalseClass]
+    attr_accessor :is_expired
+
+    # Indicates whether the provided CVV is invalid.
+    # @return [TrueClass | FalseClass]
+    attr_accessor :is_invalid_cvv
+
+    # Indicates whether the cardholder is eligible for direct sign-up.
+    # @return [TrueClass | FalseClass]
+    attr_accessor :is_direct_sign_up
+
+    # Required: A list of response details providing status codes, descriptions,
+    # and additional information about the result of the operation.
+    # @return [Array[ResponseDetail]]
+    attr_accessor :response_details
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['account_identifier'] = 'accountIdentifier'
+      @_hash['payment_instrument_identifier'] = 'paymentInstrumentIdentifier'
+      @_hash['activation_status'] = 'activationStatus'
+      @_hash['identity_types'] = 'identityTypes'
+      @_hash['is_dob_matched'] = 'isDOBMatched'
+      @_hash['is_dob_verified'] = 'isDOBVerified'
+      @_hash['is_prospect'] = 'isProspect'
+      @_hash['prospect_type'] = 'prospectType'
+      @_hash['prospect_identifier'] = 'prospectIdentifier'
+      @_hash['prospect_status'] = 'prospectStatus'
+      @_hash['retail_card_identifier'] = 'retailCardIdentifier'
+      @_hash['is_retail_card'] = 'isRetailCard'
+      @_hash['retail_card_status'] = 'retailCardStatus'
+      @_hash['product_code'] = 'productCode'
+      @_hash['is_expired'] = 'isExpired'
+      @_hash['is_invalid_cvv'] = 'isInvalidCvv'
+      @_hash['is_direct_sign_up'] = 'isDirectSignUp'
+      @_hash['response_details'] = 'responseDetails'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        account_identifier
+        payment_instrument_identifier
+        activation_status
+        identity_types
+        is_dob_matched
+        is_dob_verified
+        is_prospect
+        prospect_type
+        prospect_identifier
+        prospect_status
+        retail_card_identifier
+        is_retail_card
+        retail_card_status
+        product_code
+        is_expired
+        is_invalid_cvv
+        is_direct_sign_up
+        response_details
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      %w[
+        account_identifier
+        payment_instrument_identifier
+        activation_status
+        identity_types
+        is_dob_matched
+        is_dob_verified
+        is_prospect
+        prospect_type
+        prospect_identifier
+        prospect_status
+        retail_card_identifier
+        is_retail_card
+        retail_card_status
+        product_code
+        is_expired
+        is_invalid_cvv
+        is_direct_sign_up
+        response_details
+      ]
+    end
+
+    def initialize(account_identifier: SKIP,
+                   payment_instrument_identifier: SKIP, activation_status: SKIP,
+                   identity_types: SKIP, is_dob_matched: SKIP,
+                   is_dob_verified: SKIP, is_prospect: SKIP,
+                   prospect_type: SKIP, prospect_identifier: SKIP,
+                   prospect_status: SKIP, retail_card_identifier: SKIP,
+                   is_retail_card: SKIP, retail_card_status: SKIP,
+                   product_code: SKIP, is_expired: SKIP, is_invalid_cvv: SKIP,
+                   is_direct_sign_up: SKIP, response_details: SKIP)
+      @account_identifier = account_identifier unless account_identifier == SKIP
+      unless payment_instrument_identifier == SKIP
+        @payment_instrument_identifier =
+          payment_instrument_identifier
+      end
+      @activation_status = activation_status unless activation_status == SKIP
+      @identity_types = identity_types unless identity_types == SKIP
+      @is_dob_matched = is_dob_matched unless is_dob_matched == SKIP
+      @is_dob_verified = is_dob_verified unless is_dob_verified == SKIP
+      @is_prospect = is_prospect unless is_prospect == SKIP
+      @prospect_type = prospect_type unless prospect_type == SKIP
+      @prospect_identifier = prospect_identifier unless prospect_identifier == SKIP
+      @prospect_status = prospect_status unless prospect_status == SKIP
+      @retail_card_identifier = retail_card_identifier unless retail_card_identifier == SKIP
+      @is_retail_card = is_retail_card unless is_retail_card == SKIP
+      @retail_card_status = retail_card_status unless retail_card_status == SKIP
+      @product_code = product_code unless product_code == SKIP
+      @is_expired = is_expired unless is_expired == SKIP
+      @is_invalid_cvv = is_invalid_cvv unless is_invalid_cvv == SKIP
+      @is_direct_sign_up = is_direct_sign_up unless is_direct_sign_up == SKIP
+      @response_details = response_details unless response_details == 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.
+      account_identifier =
+        hash.key?('accountIdentifier') ? hash['accountIdentifier'] : SKIP
+      payment_instrument_identifier =
+        hash.key?('paymentInstrumentIdentifier') ? hash['paymentInstrumentIdentifier'] : SKIP
+      activation_status =
+        hash.key?('activationStatus') ? hash['activationStatus'] : SKIP
+      # Parameter is an array, so we need to iterate through it
+      identity_types = nil
+      unless hash['identityTypes'].nil?
+        identity_types = []
+        hash['identityTypes'].each do |structure|
+          identity_types << (IdentityTypes.from_hash(structure) if structure)
+        end
+      end
+
+      identity_types = SKIP unless hash.key?('identityTypes')
+      is_dob_matched = hash.key?('isDOBMatched') ? hash['isDOBMatched'] : SKIP
+      is_dob_verified =
+        hash.key?('isDOBVerified') ? hash['isDOBVerified'] : SKIP
+      is_prospect = hash.key?('isProspect') ? hash['isProspect'] : SKIP
+      prospect_type = hash.key?('prospectType') ? hash['prospectType'] : SKIP
+      prospect_identifier =
+        hash.key?('prospectIdentifier') ? hash['prospectIdentifier'] : SKIP
+      prospect_status =
+        hash.key?('prospectStatus') ? hash['prospectStatus'] : SKIP
+      retail_card_identifier =
+        hash.key?('retailCardIdentifier') ? hash['retailCardIdentifier'] : SKIP
+      is_retail_card = hash.key?('isRetailCard') ? hash['isRetailCard'] : SKIP
+      retail_card_status =
+        hash.key?('retailCardStatus') ? hash['retailCardStatus'] : SKIP
+      product_code = hash.key?('productCode') ? hash['productCode'] : SKIP
+      is_expired = hash.key?('isExpired') ? hash['isExpired'] : SKIP
+      is_invalid_cvv = hash.key?('isInvalidCvv') ? hash['isInvalidCvv'] : SKIP
+      is_direct_sign_up =
+        hash.key?('isDirectSignUp') ? hash['isDirectSignUp'] : SKIP
+      # Parameter is an array, so we need to iterate through it
+      response_details = nil
+      unless hash['responseDetails'].nil?
+        response_details = []
+        hash['responseDetails'].each do |structure|
+          response_details << (ResponseDetail.from_hash(structure) if structure)
+        end
+      end
+
+      response_details = SKIP unless hash.key?('responseDetails')
+
+      # Create object from extracted values.
+      ValidateCardResponse.new(account_identifier: account_identifier,
+                               payment_instrument_identifier: payment_instrument_identifier,
+                               activation_status: activation_status,
+                               identity_types: identity_types,
+                               is_dob_matched: is_dob_matched,
+                               is_dob_verified: is_dob_verified,
+                               is_prospect: is_prospect,
+                               prospect_type: prospect_type,
+                               prospect_identifier: prospect_identifier,
+                               prospect_status: prospect_status,
+                               retail_card_identifier: retail_card_identifier,
+                               is_retail_card: is_retail_card,
+                               retail_card_status: retail_card_status,
+                               product_code: product_code,
+                               is_expired: is_expired,
+                               is_invalid_cvv: is_invalid_cvv,
+                               is_direct_sign_up: is_direct_sign_up,
+                               response_details: response_details)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} account_identifier: #{@account_identifier}, payment_instrument_identifier:"\
+      " #{@payment_instrument_identifier}, activation_status: #{@activation_status},"\
+      " identity_types: #{@identity_types}, is_dob_matched: #{@is_dob_matched}, is_dob_verified:"\
+      " #{@is_dob_verified}, is_prospect: #{@is_prospect}, prospect_type: #{@prospect_type},"\
+      " prospect_identifier: #{@prospect_identifier}, prospect_status: #{@prospect_status},"\
+      " retail_card_identifier: #{@retail_card_identifier}, is_retail_card: #{@is_retail_card},"\
+      " retail_card_status: #{@retail_card_status}, product_code: #{@product_code}, is_expired:"\
+      " #{@is_expired}, is_invalid_cvv: #{@is_invalid_cvv}, is_direct_sign_up:"\
+      " #{@is_direct_sign_up}, response_details: #{@response_details}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} account_identifier: #{@account_identifier.inspect},"\
+      " payment_instrument_identifier: #{@payment_instrument_identifier.inspect},"\
+      " activation_status: #{@activation_status.inspect}, identity_types:"\
+      " #{@identity_types.inspect}, is_dob_matched: #{@is_dob_matched.inspect}, is_dob_verified:"\
+      " #{@is_dob_verified.inspect}, is_prospect: #{@is_prospect.inspect}, prospect_type:"\
+      " #{@prospect_type.inspect}, prospect_identifier: #{@prospect_identifier.inspect},"\
+      " prospect_status: #{@prospect_status.inspect}, retail_card_identifier:"\
+      " #{@retail_card_identifier.inspect}, is_retail_card: #{@is_retail_card.inspect},"\
+      " retail_card_status: #{@retail_card_status.inspect}, product_code:"\
+      " #{@product_code.inspect}, is_expired: #{@is_expired.inspect}, is_invalid_cvv:"\
+      " #{@is_invalid_cvv.inspect}, is_direct_sign_up: #{@is_direct_sign_up.inspect},"\
+      " response_details: #{@response_details.inspect}>"
+    end
+  end
+end

data/lib/gd_bos_v1/models/validate_identity_request.rb

@@ -0,0 +1,71 @@
+# gd_bos_v1
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module GdBosV1
+  # Represents a request to validate a user's identity information for
+  # compliance and verification purposes. Contains the user and account
+  # identifiers, along with the identity hash code to be validated. Used in the
+  # Validate Identity API to confirm the user's identity against stored or
+  # provided data as part of KYC (Know Your Customer) or onboarding processes.
+  # Inherits standard request metadata from
+  # Gd.Bos.DataTransfer.Request.RequestBase.
+  class ValidateIdentityRequest < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # The hash code of the user's identity information to be validated.
+    # @return [String]
+    attr_accessor :identity_hash_code
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['identity_hash_code'] = 'identityHashCode'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        identity_hash_code
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      %w[
+        identity_hash_code
+      ]
+    end
+
+    def initialize(identity_hash_code: SKIP)
+      @identity_hash_code = identity_hash_code unless identity_hash_code == 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.
+      identity_hash_code =
+        hash.key?('identityHashCode') ? hash['identityHashCode'] : SKIP
+
+      # Create object from extracted values.
+      ValidateIdentityRequest.new(identity_hash_code: identity_hash_code)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} identity_hash_code: #{@identity_hash_code}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} identity_hash_code: #{@identity_hash_code.inspect}>"
+    end
+  end
+end

data/lib/gd_bos_v1/models/validate_identity_response.rb

@@ -0,0 +1,92 @@
+# gd_bos_v1
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module GdBosV1
+  # Represents the response returned after validating a user's identity
+  # information. Inherits standard response metadata and details from
+  # Gd.Bos.DataTransfer.Response.ResponseBase. Contains the mismatch count,
+  # indicating the number of times the provided identity information did not
+  # match the expected value for the user. Used to communicate the result of
+  # identity validation as part of KYC (Know Your Customer) or onboarding
+  # processes.
+  class ValidateIdentityResponse < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # The number of times the provided identity information did not match the
+    # expected value for the user.
+    # @return [Integer]
+    attr_accessor :mismatch_count
+
+    # Required: A list of response details providing status codes, descriptions,
+    # and additional information about the result of the operation.
+    # @return [Array[ResponseDetail]]
+    attr_accessor :response_details
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['mismatch_count'] = 'mismatchCount'
+      @_hash['response_details'] = 'responseDetails'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        mismatch_count
+        response_details
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      %w[
+        response_details
+      ]
+    end
+
+    def initialize(mismatch_count: SKIP, response_details: SKIP)
+      @mismatch_count = mismatch_count unless mismatch_count == SKIP
+      @response_details = response_details unless response_details == 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.
+      mismatch_count = hash.key?('mismatchCount') ? hash['mismatchCount'] : SKIP
+      # Parameter is an array, so we need to iterate through it
+      response_details = nil
+      unless hash['responseDetails'].nil?
+        response_details = []
+        hash['responseDetails'].each do |structure|
+          response_details << (ResponseDetail.from_hash(structure) if structure)
+        end
+      end
+
+      response_details = SKIP unless hash.key?('responseDetails')
+
+      # Create object from extracted values.
+      ValidateIdentityResponse.new(mismatch_count: mismatch_count,
+                                   response_details: response_details)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} mismatch_count: #{@mismatch_count}, response_details:"\
+      " #{@response_details}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} mismatch_count: #{@mismatch_count.inspect}, response_details:"\
+      " #{@response_details.inspect}>"
+    end
+  end
+end

data/lib/gd_bos_v1/models/validate_ssn_request.rb

@@ -0,0 +1,69 @@
+# gd_bos_v1
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module GdBosV1
+  # Represents a request to validate a user's Social Security Number (SSN) for
+  # identity verification and compliance purposes. Contains the user and account
+  # identifiers, along with the SSN hash code to be validated. Used in the
+  # Validate SSN API to confirm the user's SSN against stored or provided data
+  # as part of KYC (Know Your Customer) processes. Inherits standard request
+  # metadata from Gd.Bos.DataTransfer.Request.RequestBase.
+  class ValidateSsnRequest < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # The hash code of the user's Social Security Number (SSN) to be validated.
+    # @return [String]
+    attr_accessor :ssn_hash_code
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['ssn_hash_code'] = 'ssnHashCode'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        ssn_hash_code
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      %w[
+        ssn_hash_code
+      ]
+    end
+
+    def initialize(ssn_hash_code: SKIP)
+      @ssn_hash_code = ssn_hash_code unless ssn_hash_code == 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.
+      ssn_hash_code = hash.key?('ssnHashCode') ? hash['ssnHashCode'] : SKIP
+
+      # Create object from extracted values.
+      ValidateSsnRequest.new(ssn_hash_code: ssn_hash_code)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} ssn_hash_code: #{@ssn_hash_code}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} ssn_hash_code: #{@ssn_hash_code.inspect}>"
+    end
+  end
+end

data/lib/gd_bos_v1/models/validate_ssn_response.rb

@@ -0,0 +1,91 @@
+# gd_bos_v1
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module GdBosV1
+  # Represents the response returned after validating a user's Social Security
+  # Number (SSN). Inherits standard response metadata and details from
+  # Gd.Bos.DataTransfer.Response.ResponseBase. Contains the mismatch count,
+  # indicating the number of times the provided SSN did not match the expected
+  # value for the user. Used to communicate the result of SSN validation as part
+  # of KYC (Know Your Customer) or identity verification processes.
+  class ValidateSsnResponse < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # The number of times the provided SSN did not match the expected value for
+    # the user.
+    # @return [Integer]
+    attr_accessor :mismatch_count
+
+    # Required: A list of response details providing status codes, descriptions,
+    # and additional information about the result of the operation.
+    # @return [Array[ResponseDetail]]
+    attr_accessor :response_details
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['mismatch_count'] = 'mismatchCount'
+      @_hash['response_details'] = 'responseDetails'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        mismatch_count
+        response_details
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      %w[
+        response_details
+      ]
+    end
+
+    def initialize(mismatch_count: SKIP, response_details: SKIP)
+      @mismatch_count = mismatch_count unless mismatch_count == SKIP
+      @response_details = response_details unless response_details == 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.
+      mismatch_count = hash.key?('mismatchCount') ? hash['mismatchCount'] : SKIP
+      # Parameter is an array, so we need to iterate through it
+      response_details = nil
+      unless hash['responseDetails'].nil?
+        response_details = []
+        hash['responseDetails'].each do |structure|
+          response_details << (ResponseDetail.from_hash(structure) if structure)
+        end
+      end
+
+      response_details = SKIP unless hash.key?('responseDetails')
+
+      # Create object from extracted values.
+      ValidateSsnResponse.new(mismatch_count: mismatch_count,
+                              response_details: response_details)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} mismatch_count: #{@mismatch_count}, response_details:"\
+      " #{@response_details}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} mismatch_count: #{@mismatch_count.inspect}, response_details:"\
+      " #{@response_details.inspect}>"
+    end
+  end
+end

data/lib/gd_bos_v1/models/verify_pin_request_encrypted.rb

@@ -0,0 +1,68 @@
+# gd_bos_v1
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module GdBosV1
+  # Represents a request to verify the ATM PIN for a payment instrument using an
+  # encrypted PIN value.
+  class VerifyPinRequestEncrypted < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # Represents a container for encrypted data used in secure data transfer
+    # operations.
+    # Contains the encrypted payload and associated cryptographic metadata,
+    # including encryption version, ephemeral public key, and public key hash.
+    # Used to securely transmit sensitive information such as user data,
+    # ensuring confidentiality and integrity during transport.
+    # @return [EncryptedData]
+    attr_accessor :encrypted_pin
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['encrypted_pin'] = 'encryptedPin'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        encrypted_pin
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(encrypted_pin: SKIP)
+      @encrypted_pin = encrypted_pin unless encrypted_pin == 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.
+      encrypted_pin = EncryptedData.from_hash(hash['encryptedPin']) if hash['encryptedPin']
+
+      # Create object from extracted values.
+      VerifyPinRequestEncrypted.new(encrypted_pin: encrypted_pin)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} encrypted_pin: #{@encrypted_pin}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} encrypted_pin: #{@encrypted_pin.inspect}>"
+    end
+  end
+end