lithic 0.6.0 → 0.8.0

data/lib/lithic/models/account_holder_update_params.rb

@@ -7,548 +7,540 @@ module Lithic
       extend Lithic::Internal::Type::RequestParameters::Converter
       include Lithic::Internal::Type::RequestParameters
 
-      # @!attribute beneficial_owner_entities
-      #   @deprecated
+      # @!attribute account_holder_token
       #
-      #   Deprecated.
-      #
-      #   @return [Array<Lithic::Models::AccountHolderUpdateParams::BeneficialOwnerEntity>, nil]
-      optional :beneficial_owner_entities,
-               -> { Lithic::Internal::Type::ArrayOf[Lithic::AccountHolderUpdateParams::BeneficialOwnerEntity] }
-
-      # @!attribute beneficial_owner_individuals
-      #   You must submit a list of all direct and indirect individuals with 25% or more
-      #   ownership in the company. A maximum of 4 beneficial owners can be submitted. If
-      #   no individual owns 25% of the company you do not need to send beneficial owner
-      #   information. See
-      #   [FinCEN requirements](https://www.fincen.gov/sites/default/files/shared/CDD_Rev6.7_Sept_2017_Certificate.pdf)
-      #   (Section I) for more background on individuals that should be included.
+      #   @return [String]
+      required :account_holder_token, String
+
+      # @!attribute body
+      #   The KYB request payload for updating a business.
       #
-      #   @return [Array<Lithic::Models::AccountHolderUpdateParams::BeneficialOwnerIndividual>, nil]
-      optional :beneficial_owner_individuals,
-               -> { Lithic::Internal::Type::ArrayOf[Lithic::AccountHolderUpdateParams::BeneficialOwnerIndividual] }
+      #   @return [Lithic::Models::AccountHolderUpdateParams::Body::KYBPatchRequest, Lithic::Models::AccountHolderUpdateParams::Body::KYCPatchRequest, Lithic::Models::AccountHolderUpdateParams::Body::PatchRequest]
+      required :body, union: -> { Lithic::AccountHolderUpdateParams::Body }
 
-      # @!attribute business_entity
-      #   Information for business for which the account is being opened and KYB is being
-      #   run.
+      # @!method initialize(account_holder_token:, body:, request_options: {})
+      #   @param account_holder_token [String]
       #
-      #   @return [Lithic::Models::AccountHolderUpdateParams::BusinessEntity, nil]
-      optional :business_entity, -> { Lithic::AccountHolderUpdateParams::BusinessEntity }
-
-      # @!attribute control_person
-      #   An individual with significant responsibility for managing the legal entity
-      #   (e.g., a Chief Executive Officer, Chief Financial Officer, Chief Operating
-      #   Officer, Managing Member, General Partner, President, Vice President, or
-      #   Treasurer). This can be an executive, or someone who will have program-wide
-      #   access to the cards that Lithic will provide. In some cases, this individual
-      #   could also be a beneficial owner listed above. See
-      #   [FinCEN requirements](https://www.fincen.gov/sites/default/files/shared/CDD_Rev6.7_Sept_2017_Certificate.pdf)
-      #   (Section II) for more background.
+      #   @param body [Lithic::Models::AccountHolderUpdateParams::Body::KYBPatchRequest, Lithic::Models::AccountHolderUpdateParams::Body::KYCPatchRequest, Lithic::Models::AccountHolderUpdateParams::Body::PatchRequest] The KYB request payload for updating a business.
       #
-      #   @return [Lithic::Models::AccountHolderUpdateParams::ControlPerson, nil]
-      optional :control_person, -> { Lithic::AccountHolderUpdateParams::ControlPerson }
+      #   @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}]
 
-      # @!attribute external_id
-      #   A user provided id that can be used to link an account holder with an external
-      #   system
-      #
-      #   @return [String, nil]
-      optional :external_id, String
+      # The KYB request payload for updating a business.
+      module Body
+        extend Lithic::Internal::Type::Union
 
-      # @!attribute naics_code
-      #   6-digit North American Industry Classification System (NAICS) code for the
-      #   business.
-      #
-      #   @return [String, nil]
-      optional :naics_code, String
+        # The KYB request payload for updating a business.
+        variant -> { Lithic::AccountHolderUpdateParams::Body::KYBPatchRequest }
 
-      # @!attribute nature_of_business
-      #   Short description of the company's line of business (i.e., what does the company
-      #   do?).
-      #
-      #   @return [String, nil]
-      optional :nature_of_business, String
+        # The KYC request payload for updating an account holder.
+        variant -> { Lithic::AccountHolderUpdateParams::Body::KYCPatchRequest }
 
-      # @!attribute website_url
-      #   Company website URL.
-      #
-      #   @return [String, nil]
-      optional :website_url, String
+        # The legacy request for updating an account holder.
+        variant -> { Lithic::AccountHolderUpdateParams::Body::PatchRequest }
 
-      # @!attribute individual
-      #   Information on the individual for whom the account is being opened and KYC is
-      #   being run.
-      #
-      #   @return [Lithic::Models::AccountHolderUpdateParams::Individual, nil]
-      optional :individual, -> { Lithic::AccountHolderUpdateParams::Individual }
+        class KYBPatchRequest < Lithic::Internal::Type::BaseModel
+          # @!attribute beneficial_owner_individuals
+          #   You must submit a list of all direct and indirect individuals with 25% or more
+          #   ownership in the company. A maximum of 4 beneficial owners can be submitted. If
+          #   no individual owns 25% of the company you do not need to send beneficial owner
+          #   information. See
+          #   [FinCEN requirements](https://www.fincen.gov/sites/default/files/shared/CDD_Rev6.7_Sept_2017_Certificate.pdf)
+          #   (Section I) for more background on individuals that should be included.
+          #
+          #   @return [Array<Lithic::Models::AccountHolderUpdateParams::Body::KYBPatchRequest::BeneficialOwnerIndividual>, nil]
+          optional :beneficial_owner_individuals,
+                   -> { Lithic::Internal::Type::ArrayOf[Lithic::AccountHolderUpdateParams::Body::KYBPatchRequest::BeneficialOwnerIndividual] }
 
-      # @!attribute address
-      #   Allowed for: KYC-Exempt, BYO-KYC, BYO-KYB.
-      #
-      #   @return [Lithic::Models::AddressUpdate, nil]
-      optional :address, -> { Lithic::AddressUpdate }
+          # @!attribute business_entity
+          #   Information for business for which the account is being opened and KYB is being
+          #   run.
+          #
+          #   @return [Lithic::Models::AccountHolderUpdateParams::Body::KYBPatchRequest::BusinessEntity, nil]
+          optional :business_entity, -> { Lithic::AccountHolderUpdateParams::Body::KYBPatchRequest::BusinessEntity }
+
+          # @!attribute control_person
+          #   An individual with significant responsibility for managing the legal entity
+          #   (e.g., a Chief Executive Officer, Chief Financial Officer, Chief Operating
+          #   Officer, Managing Member, General Partner, President, Vice President, or
+          #   Treasurer). This can be an executive, or someone who will have program-wide
+          #   access to the cards that Lithic will provide. In some cases, this individual
+          #   could also be a beneficial owner listed above. See
+          #   [FinCEN requirements](https://www.fincen.gov/sites/default/files/shared/CDD_Rev6.7_Sept_2017_Certificate.pdf)
+          #   (Section II) for more background.
+          #
+          #   @return [Lithic::Models::AccountHolderUpdateParams::Body::KYBPatchRequest::ControlPerson, nil]
+          optional :control_person, -> { Lithic::AccountHolderUpdateParams::Body::KYBPatchRequest::ControlPerson }
 
-      # @!attribute business_account_token
-      #   Allowed for: KYC-Exempt, BYO-KYC. The token of the business account to which the
-      #   account holder is associated.
-      #
-      #   @return [String, nil]
-      optional :business_account_token, String
+          # @!attribute external_id
+          #   A user provided id that can be used to link an account holder with an external
+          #   system
+          #
+          #   @return [String, nil]
+          optional :external_id, String
 
-      # @!attribute email
-      #   Allowed for all Account Holders. Account holder's email address. The primary
-      #   purpose of this field is for cardholder identification and verification during
-      #   the digital wallet tokenization process.
-      #
-      #   @return [String, nil]
-      optional :email, String
+          # @!attribute naics_code
+          #   6-digit North American Industry Classification System (NAICS) code for the
+          #   business.
+          #
+          #   @return [String, nil]
+          optional :naics_code, String
 
-      # @!attribute first_name
-      #   Allowed for KYC-Exempt, BYO-KYC. Account holder's first name.
-      #
-      #   @return [String, nil]
-      optional :first_name, String
+          # @!attribute nature_of_business
+          #   Short description of the company's line of business (i.e., what does the company
+          #   do?).
+          #
+          #   @return [String, nil]
+          optional :nature_of_business, String
 
-      # @!attribute last_name
-      #   Allowed for KYC-Exempt, BYO-KYC. Account holder's last name.
-      #
-      #   @return [String, nil]
-      optional :last_name, String
+          # @!attribute website_url
+          #   Company website URL.
+          #
+          #   @return [String, nil]
+          optional :website_url, String
 
-      # @!attribute legal_business_name
-      #   Allowed for BYO-KYB. Legal business name of the account holder.
-      #
-      #   @return [String, nil]
-      optional :legal_business_name, String
+          # @!method initialize(beneficial_owner_individuals: nil, business_entity: nil, control_person: nil, external_id: nil, naics_code: nil, nature_of_business: nil, website_url: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Lithic::Models::AccountHolderUpdateParams::Body::KYBPatchRequest} for more
+          #   details.
+          #
+          #   The KYB request payload for updating a business.
+          #
+          #   @param beneficial_owner_individuals [Array<Lithic::Models::AccountHolderUpdateParams::Body::KYBPatchRequest::BeneficialOwnerIndividual>] You must submit a list of all direct and indirect individuals with 25% or more o
+          #
+          #   @param business_entity [Lithic::Models::AccountHolderUpdateParams::Body::KYBPatchRequest::BusinessEntity] Information for business for which the account is being opened and KYB is being
+          #
+          #   @param control_person [Lithic::Models::AccountHolderUpdateParams::Body::KYBPatchRequest::ControlPerson] An individual with significant responsibility for managing the legal entity (e.g
+          #
+          #   @param external_id [String] A user provided id that can be used to link an account holder with an external s
+          #
+          #   @param naics_code [String] 6-digit North American Industry Classification System (NAICS) code for the busin
+          #
+          #   @param nature_of_business [String] Short description of the company's line of business (i.e., what does the company
+          #
+          #   @param website_url [String] Company website URL.
+
+          class BeneficialOwnerIndividual < Lithic::Internal::Type::BaseModel
+            # @!attribute entity_token
+            #   Globally unique identifier for an entity.
+            #
+            #   @return [String]
+            required :entity_token, String
+
+            # @!attribute address
+            #   Individual's current address - PO boxes, UPS drops, and FedEx drops are not
+            #   acceptable; APO/FPO are acceptable. Only USA addresses are currently supported.
+            #
+            #   @return [Lithic::Models::AddressUpdate, nil]
+            optional :address, -> { Lithic::AddressUpdate }
+
+            # @!attribute dob
+            #   Individual's date of birth, as an RFC 3339 date.
+            #
+            #   @return [String, nil]
+            optional :dob, String
+
+            # @!attribute email
+            #   Individual's email address. If utilizing Lithic for chargeback processing, this
+            #   customer email address may be used to communicate dispute status and resolution.
+            #
+            #   @return [String, nil]
+            optional :email, String
+
+            # @!attribute first_name
+            #   Individual's first name, as it appears on government-issued identity documents.
+            #
+            #   @return [String, nil]
+            optional :first_name, String
+
+            # @!attribute last_name
+            #   Individual's last name, as it appears on government-issued identity documents.
+            #
+            #   @return [String, nil]
+            optional :last_name, String
+
+            # @!attribute phone_number
+            #   Individual's phone number, entered in E.164 format.
+            #
+            #   @return [String, nil]
+            optional :phone_number, String
+
+            request_only do
+              # @!attribute government_id
+              #   Government-issued identification number (required for identity verification and
+              #   compliance with banking regulations). Social Security Numbers (SSN) and
+              #   Individual Taxpayer Identification Numbers (ITIN) are currently supported,
+              #   entered as full nine-digits, with or without hyphens
+              #
+              #   @return [String, nil]
+              optional :government_id, String
+            end
+
+            # @!method initialize(entity_token:, address: nil, dob: nil, email: nil, first_name: nil, government_id: nil, last_name: nil, phone_number: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Lithic::Models::AccountHolderUpdateParams::Body::KYBPatchRequest::BeneficialOwnerIndividual}
+            #   for more details.
+            #
+            #   Individuals associated with a KYB application. Phone number is optional.
+            #
+            #   @param entity_token [String] Globally unique identifier for an entity.
+            #
+            #   @param address [Lithic::Models::AddressUpdate] Individual's current address - PO boxes, UPS drops, and FedEx drops are not acce
+            #
+            #   @param dob [String] Individual's date of birth, as an RFC 3339 date.
+            #
+            #   @param email [String] Individual's email address. If utilizing Lithic for chargeback processing, this
+            #
+            #   @param first_name [String] Individual's first name, as it appears on government-issued identity documents.
+            #
+            #   @param government_id [String] Government-issued identification number (required for identity verification and
+            #
+            #   @param last_name [String] Individual's last name, as it appears on government-issued identity documents.
+            #
+            #   @param phone_number [String] Individual's phone number, entered in E.164 format.
+          end
+
+          # @see Lithic::Models::AccountHolderUpdateParams::Body::KYBPatchRequest#business_entity
+          class BusinessEntity < Lithic::Internal::Type::BaseModel
+            # @!attribute entity_token
+            #   Globally unique identifier for an entity.
+            #
+            #   @return [String]
+            required :entity_token, String
+
+            # @!attribute address
+            #   Business''s physical address - PO boxes, UPS drops, and FedEx drops are not
+            #   acceptable; APO/FPO are acceptable.
+            #
+            #   @return [Lithic::Models::AddressUpdate, nil]
+            optional :address, -> { Lithic::AddressUpdate }
+
+            # @!attribute dba_business_name
+            #   Any name that the business operates under that is not its legal business name
+            #   (if applicable).
+            #
+            #   @return [String, nil]
+            optional :dba_business_name, String
+
+            # @!attribute government_id
+            #   Government-issued identification number. US Federal Employer Identification
+            #   Numbers (EIN) are currently supported, entered as full nine-digits, with or
+            #   without hyphens.
+            #
+            #   @return [String, nil]
+            optional :government_id, String
+
+            # @!attribute legal_business_name
+            #   Legal (formal) business name.
+            #
+            #   @return [String, nil]
+            optional :legal_business_name, String
+
+            # @!attribute parent_company
+            #   Parent company name (if applicable).
+            #
+            #   @return [String, nil]
+            optional :parent_company, String
+
+            # @!attribute phone_numbers
+            #   One or more of the business's phone number(s), entered as a list in E.164
+            #   format.
+            #
+            #   @return [Array<String>, nil]
+            optional :phone_numbers, Lithic::Internal::Type::ArrayOf[String]
+
+            # @!method initialize(entity_token:, address: nil, dba_business_name: nil, government_id: nil, legal_business_name: nil, parent_company: nil, phone_numbers: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Lithic::Models::AccountHolderUpdateParams::Body::KYBPatchRequest::BusinessEntity}
+            #   for more details.
+            #
+            #   Information for business for which the account is being opened and KYB is being
+            #   run.
+            #
+            #   @param entity_token [String] Globally unique identifier for an entity.
+            #
+            #   @param address [Lithic::Models::AddressUpdate] Business''s physical address - PO boxes, UPS drops, and FedEx drops are not acce
+            #
+            #   @param dba_business_name [String] Any name that the business operates under that is not its legal business name (i
+            #
+            #   @param government_id [String] Government-issued identification number. US Federal Employer Identification Numb
+            #
+            #   @param legal_business_name [String] Legal (formal) business name.
+            #
+            #   @param parent_company [String] Parent company name (if applicable).
+            #
+            #   @param phone_numbers [Array<String>] One or more of the business's phone number(s), entered as a list in E.164 format
+          end
+
+          # @see Lithic::Models::AccountHolderUpdateParams::Body::KYBPatchRequest#control_person
+          class ControlPerson < Lithic::Internal::Type::BaseModel
+            # @!attribute entity_token
+            #   Globally unique identifier for an entity.
+            #
+            #   @return [String]
+            required :entity_token, String
+
+            # @!attribute address
+            #   Individual's current address - PO boxes, UPS drops, and FedEx drops are not
+            #   acceptable; APO/FPO are acceptable. Only USA addresses are currently supported.
+            #
+            #   @return [Lithic::Models::AddressUpdate, nil]
+            optional :address, -> { Lithic::AddressUpdate }
+
+            # @!attribute dob
+            #   Individual's date of birth, as an RFC 3339 date.
+            #
+            #   @return [String, nil]
+            optional :dob, String
+
+            # @!attribute email
+            #   Individual's email address. If utilizing Lithic for chargeback processing, this
+            #   customer email address may be used to communicate dispute status and resolution.
+            #
+            #   @return [String, nil]
+            optional :email, String
+
+            # @!attribute first_name
+            #   Individual's first name, as it appears on government-issued identity documents.
+            #
+            #   @return [String, nil]
+            optional :first_name, String
+
+            # @!attribute last_name
+            #   Individual's last name, as it appears on government-issued identity documents.
+            #
+            #   @return [String, nil]
+            optional :last_name, String
+
+            # @!attribute phone_number
+            #   Individual's phone number, entered in E.164 format.
+            #
+            #   @return [String, nil]
+            optional :phone_number, String
+
+            request_only do
+              # @!attribute government_id
+              #   Government-issued identification number (required for identity verification and
+              #   compliance with banking regulations). Social Security Numbers (SSN) and
+              #   Individual Taxpayer Identification Numbers (ITIN) are currently supported,
+              #   entered as full nine-digits, with or without hyphens
+              #
+              #   @return [String, nil]
+              optional :government_id, String
+            end
+
+            # @!method initialize(entity_token:, address: nil, dob: nil, email: nil, first_name: nil, government_id: nil, last_name: nil, phone_number: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Lithic::Models::AccountHolderUpdateParams::Body::KYBPatchRequest::ControlPerson}
+            #   for more details.
+            #
+            #   An individual with significant responsibility for managing the legal entity
+            #   (e.g., a Chief Executive Officer, Chief Financial Officer, Chief Operating
+            #   Officer, Managing Member, General Partner, President, Vice President, or
+            #   Treasurer). This can be an executive, or someone who will have program-wide
+            #   access to the cards that Lithic will provide. In some cases, this individual
+            #   could also be a beneficial owner listed above. See
+            #   [FinCEN requirements](https://www.fincen.gov/sites/default/files/shared/CDD_Rev6.7_Sept_2017_Certificate.pdf)
+            #   (Section II) for more background.
+            #
+            #   @param entity_token [String] Globally unique identifier for an entity.
+            #
+            #   @param address [Lithic::Models::AddressUpdate] Individual's current address - PO boxes, UPS drops, and FedEx drops are not acce
+            #
+            #   @param dob [String] Individual's date of birth, as an RFC 3339 date.
+            #
+            #   @param email [String] Individual's email address. If utilizing Lithic for chargeback processing, this
+            #
+            #   @param first_name [String] Individual's first name, as it appears on government-issued identity documents.
+            #
+            #   @param government_id [String] Government-issued identification number (required for identity verification and
+            #
+            #   @param last_name [String] Individual's last name, as it appears on government-issued identity documents.
+            #
+            #   @param phone_number [String] Individual's phone number, entered in E.164 format.
+          end
+        end
 
-      # @!attribute phone_number
-      #   Allowed for all Account Holders. Account holder's phone number, entered in E.164
-      #   format. The primary purpose of this field is for cardholder identification and
-      #   verification during the digital wallet tokenization process.
-      #
-      #   @return [String, nil]
-      optional :phone_number, String
+        class KYCPatchRequest < Lithic::Internal::Type::BaseModel
+          # @!attribute external_id
+          #   A user provided id that can be used to link an account holder with an external
+          #   system
+          #
+          #   @return [String, nil]
+          optional :external_id, String
 
-      # @!method initialize(beneficial_owner_entities: nil, beneficial_owner_individuals: nil, business_entity: nil, control_person: nil, external_id: nil, naics_code: nil, nature_of_business: nil, website_url: nil, individual: nil, address: nil, business_account_token: nil, email: nil, first_name: nil, last_name: nil, legal_business_name: nil, phone_number: nil, request_options: {})
-      #   Some parameter documentations has been truncated, see
-      #   {Lithic::Models::AccountHolderUpdateParams} for more details.
-      #
-      #   @param beneficial_owner_entities [Array<Lithic::Models::AccountHolderUpdateParams::BeneficialOwnerEntity>] Deprecated.
-      #
-      #   @param beneficial_owner_individuals [Array<Lithic::Models::AccountHolderUpdateParams::BeneficialOwnerIndividual>] You must submit a list of all direct and indirect individuals with 25% or more o
-      #
-      #   @param business_entity [Lithic::Models::AccountHolderUpdateParams::BusinessEntity] Information for business for which the account is being opened and KYB is being
-      #
-      #   @param control_person [Lithic::Models::AccountHolderUpdateParams::ControlPerson] An individual with significant responsibility for managing the legal entity (e.g
-      #
-      #   @param external_id [String] A user provided id that can be used to link an account holder with an external s
-      #
-      #   @param naics_code [String] 6-digit North American Industry Classification System (NAICS) code for the busin
-      #
-      #   @param nature_of_business [String] Short description of the company's line of business (i.e., what does the company
-      #
-      #   @param website_url [String] Company website URL.
-      #
-      #   @param individual [Lithic::Models::AccountHolderUpdateParams::Individual] Information on the individual for whom the account is being opened and KYC is be
-      #
-      #   @param address [Lithic::Models::AddressUpdate] Allowed for: KYC-Exempt, BYO-KYC, BYO-KYB.
-      #
-      #   @param business_account_token [String] Allowed for: KYC-Exempt, BYO-KYC. The token of the business account to which the
-      #
-      #   @param email [String] Allowed for all Account Holders. Account holder's email address. The primary pur
-      #
-      #   @param first_name [String] Allowed for KYC-Exempt, BYO-KYC. Account holder's first name.
-      #
-      #   @param last_name [String] Allowed for KYC-Exempt, BYO-KYC. Account holder's last name.
-      #
-      #   @param legal_business_name [String] Allowed for BYO-KYB. Legal business name of the account holder.
-      #
-      #   @param phone_number [String] Allowed for all Account Holders. Account holder's phone number, entered in E.164
-      #
-      #   @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}]
+          # @!attribute individual
+          #   Information on the individual for whom the account is being opened and KYC is
+          #   being run.
+          #
+          #   @return [Lithic::Models::AccountHolderUpdateParams::Body::KYCPatchRequest::Individual, nil]
+          optional :individual, -> { Lithic::AccountHolderUpdateParams::Body::KYCPatchRequest::Individual }
 
-      class BeneficialOwnerEntity < Lithic::Internal::Type::BaseModel
-        # @!attribute entity_token
-        #   Globally unique identifier for an entity.
-        #
-        #   @return [String]
-        required :entity_token, String
-
-        # @!attribute address
-        #   Business''s physical address - PO boxes, UPS drops, and FedEx drops are not
-        #   acceptable; APO/FPO are acceptable.
-        #
-        #   @return [Lithic::Models::AddressUpdate, nil]
-        optional :address, -> { Lithic::AddressUpdate }
-
-        # @!attribute dba_business_name
-        #   Any name that the business operates under that is not its legal business name
-        #   (if applicable).
-        #
-        #   @return [String, nil]
-        optional :dba_business_name, String
-
-        # @!attribute government_id
-        #   Government-issued identification number. US Federal Employer Identification
-        #   Numbers (EIN) are currently supported, entered as full nine-digits, with or
-        #   without hyphens.
-        #
-        #   @return [String, nil]
-        optional :government_id, String
-
-        # @!attribute legal_business_name
-        #   Legal (formal) business name.
-        #
-        #   @return [String, nil]
-        optional :legal_business_name, String
-
-        # @!attribute parent_company
-        #   Parent company name (if applicable).
-        #
-        #   @return [String, nil]
-        optional :parent_company, String
-
-        # @!attribute phone_numbers
-        #   One or more of the business's phone number(s), entered as a list in E.164
-        #   format.
-        #
-        #   @return [Array<String>, nil]
-        optional :phone_numbers, Lithic::Internal::Type::ArrayOf[String]
-
-        # @!method initialize(entity_token:, address: nil, dba_business_name: nil, government_id: nil, legal_business_name: nil, parent_company: nil, phone_numbers: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {Lithic::Models::AccountHolderUpdateParams::BeneficialOwnerEntity} for more
-        #   details.
-        #
-        #   @param entity_token [String] Globally unique identifier for an entity.
-        #
-        #   @param address [Lithic::Models::AddressUpdate] Business''s physical address - PO boxes, UPS drops, and FedEx drops are not acce
-        #
-        #   @param dba_business_name [String] Any name that the business operates under that is not its legal business name (i
-        #
-        #   @param government_id [String] Government-issued identification number. US Federal Employer Identification Numb
-        #
-        #   @param legal_business_name [String] Legal (formal) business name.
-        #
-        #   @param parent_company [String] Parent company name (if applicable).
-        #
-        #   @param phone_numbers [Array<String>] One or more of the business's phone number(s), entered as a list in E.164 format
-      end
+          # @!method initialize(external_id: nil, individual: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Lithic::Models::AccountHolderUpdateParams::Body::KYCPatchRequest} for more
+          #   details.
+          #
+          #   The KYC request payload for updating an account holder.
+          #
+          #   @param external_id [String] A user provided id that can be used to link an account holder with an external s
+          #
+          #   @param individual [Lithic::Models::AccountHolderUpdateParams::Body::KYCPatchRequest::Individual] Information on the individual for whom the account is being opened and KYC is be
+
+          # @see Lithic::Models::AccountHolderUpdateParams::Body::KYCPatchRequest#individual
+          class Individual < Lithic::Internal::Type::BaseModel
+            # @!attribute entity_token
+            #   Globally unique identifier for an entity.
+            #
+            #   @return [String]
+            required :entity_token, String
+
+            # @!attribute address
+            #   Individual's current address - PO boxes, UPS drops, and FedEx drops are not
+            #   acceptable; APO/FPO are acceptable. Only USA addresses are currently supported.
+            #
+            #   @return [Lithic::Models::AddressUpdate, nil]
+            optional :address, -> { Lithic::AddressUpdate }
+
+            # @!attribute dob
+            #   Individual's date of birth, as an RFC 3339 date.
+            #
+            #   @return [String, nil]
+            optional :dob, String
+
+            # @!attribute email
+            #   Individual's email address. If utilizing Lithic for chargeback processing, this
+            #   customer email address may be used to communicate dispute status and resolution.
+            #
+            #   @return [String, nil]
+            optional :email, String
+
+            # @!attribute first_name
+            #   Individual's first name, as it appears on government-issued identity documents.
+            #
+            #   @return [String, nil]
+            optional :first_name, String
+
+            # @!attribute last_name
+            #   Individual's last name, as it appears on government-issued identity documents.
+            #
+            #   @return [String, nil]
+            optional :last_name, String
+
+            # @!attribute phone_number
+            #   Individual's phone number, entered in E.164 format.
+            #
+            #   @return [String, nil]
+            optional :phone_number, String
+
+            request_only do
+              # @!attribute government_id
+              #   Government-issued identification number (required for identity verification and
+              #   compliance with banking regulations). Social Security Numbers (SSN) and
+              #   Individual Taxpayer Identification Numbers (ITIN) are currently supported,
+              #   entered as full nine-digits, with or without hyphens
+              #
+              #   @return [String, nil]
+              optional :government_id, String
+            end
+
+            # @!method initialize(entity_token:, address: nil, dob: nil, email: nil, first_name: nil, government_id: nil, last_name: nil, phone_number: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Lithic::Models::AccountHolderUpdateParams::Body::KYCPatchRequest::Individual}
+            #   for more details.
+            #
+            #   Information on the individual for whom the account is being opened and KYC is
+            #   being run.
+            #
+            #   @param entity_token [String] Globally unique identifier for an entity.
+            #
+            #   @param address [Lithic::Models::AddressUpdate] Individual's current address - PO boxes, UPS drops, and FedEx drops are not acce
+            #
+            #   @param dob [String] Individual's date of birth, as an RFC 3339 date.
+            #
+            #   @param email [String] Individual's email address. If utilizing Lithic for chargeback processing, this
+            #
+            #   @param first_name [String] Individual's first name, as it appears on government-issued identity documents.
+            #
+            #   @param government_id [String] Government-issued identification number (required for identity verification and
+            #
+            #   @param last_name [String] Individual's last name, as it appears on government-issued identity documents.
+            #
+            #   @param phone_number [String] Individual's phone number, entered in E.164 format.
+          end
+        end
+
+        class PatchRequest < Lithic::Internal::Type::BaseModel
+          # @!attribute address
+          #   Allowed for: KYC-Exempt, BYO-KYC, BYO-KYB.
+          #
+          #   @return [Lithic::Models::AddressUpdate, nil]
+          optional :address, -> { Lithic::AddressUpdate }
 
-      class BeneficialOwnerIndividual < Lithic::Internal::Type::BaseModel
-        # @!attribute entity_token
-        #   Globally unique identifier for an entity.
-        #
-        #   @return [String]
-        required :entity_token, String
-
-        # @!attribute address
-        #   Individual's current address - PO boxes, UPS drops, and FedEx drops are not
-        #   acceptable; APO/FPO are acceptable. Only USA addresses are currently supported.
-        #
-        #   @return [Lithic::Models::AddressUpdate, nil]
-        optional :address, -> { Lithic::AddressUpdate }
-
-        # @!attribute dob
-        #   Individual's date of birth, as an RFC 3339 date.
-        #
-        #   @return [String, nil]
-        optional :dob, String
-
-        # @!attribute email
-        #   Individual's email address. If utilizing Lithic for chargeback processing, this
-        #   customer email address may be used to communicate dispute status and resolution.
-        #
-        #   @return [String, nil]
-        optional :email, String
-
-        # @!attribute first_name
-        #   Individual's first name, as it appears on government-issued identity documents.
-        #
-        #   @return [String, nil]
-        optional :first_name, String
-
-        # @!attribute last_name
-        #   Individual's last name, as it appears on government-issued identity documents.
-        #
-        #   @return [String, nil]
-        optional :last_name, String
-
-        # @!attribute phone_number
-        #   Individual's phone number, entered in E.164 format.
-        #
-        #   @return [String, nil]
-        optional :phone_number, String
-
-        request_only do
-          # @!attribute government_id
-          #   Government-issued identification number (required for identity verification and
-          #   compliance with banking regulations). Social Security Numbers (SSN) and
-          #   Individual Taxpayer Identification Numbers (ITIN) are currently supported,
-          #   entered as full nine-digits, with or without hyphens
+          # @!attribute business_account_token
+          #   Allowed for: KYC-Exempt, BYO-KYC. The token of the business account to which the
+          #   account holder is associated.
           #
           #   @return [String, nil]
-          optional :government_id, String
-        end
+          optional :business_account_token, String
 
-        # @!method initialize(entity_token:, address: nil, dob: nil, email: nil, first_name: nil, government_id: nil, last_name: nil, phone_number: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {Lithic::Models::AccountHolderUpdateParams::BeneficialOwnerIndividual} for more
-        #   details.
-        #
-        #   Individuals associated with a KYB application. Phone number is optional.
-        #
-        #   @param entity_token [String] Globally unique identifier for an entity.
-        #
-        #   @param address [Lithic::Models::AddressUpdate] Individual's current address - PO boxes, UPS drops, and FedEx drops are not acce
-        #
-        #   @param dob [String] Individual's date of birth, as an RFC 3339 date.
-        #
-        #   @param email [String] Individual's email address. If utilizing Lithic for chargeback processing, this
-        #
-        #   @param first_name [String] Individual's first name, as it appears on government-issued identity documents.
-        #
-        #   @param government_id [String] Government-issued identification number (required for identity verification and
-        #
-        #   @param last_name [String] Individual's last name, as it appears on government-issued identity documents.
-        #
-        #   @param phone_number [String] Individual's phone number, entered in E.164 format.
-      end
+          # @!attribute email
+          #   Allowed for all Account Holders. Account holder's email address. The primary
+          #   purpose of this field is for cardholder identification and verification during
+          #   the digital wallet tokenization process.
+          #
+          #   @return [String, nil]
+          optional :email, String
 
-      class BusinessEntity < Lithic::Internal::Type::BaseModel
-        # @!attribute entity_token
-        #   Globally unique identifier for an entity.
-        #
-        #   @return [String]
-        required :entity_token, String
-
-        # @!attribute address
-        #   Business''s physical address - PO boxes, UPS drops, and FedEx drops are not
-        #   acceptable; APO/FPO are acceptable.
-        #
-        #   @return [Lithic::Models::AddressUpdate, nil]
-        optional :address, -> { Lithic::AddressUpdate }
-
-        # @!attribute dba_business_name
-        #   Any name that the business operates under that is not its legal business name
-        #   (if applicable).
-        #
-        #   @return [String, nil]
-        optional :dba_business_name, String
-
-        # @!attribute government_id
-        #   Government-issued identification number. US Federal Employer Identification
-        #   Numbers (EIN) are currently supported, entered as full nine-digits, with or
-        #   without hyphens.
-        #
-        #   @return [String, nil]
-        optional :government_id, String
-
-        # @!attribute legal_business_name
-        #   Legal (formal) business name.
-        #
-        #   @return [String, nil]
-        optional :legal_business_name, String
-
-        # @!attribute parent_company
-        #   Parent company name (if applicable).
-        #
-        #   @return [String, nil]
-        optional :parent_company, String
-
-        # @!attribute phone_numbers
-        #   One or more of the business's phone number(s), entered as a list in E.164
-        #   format.
-        #
-        #   @return [Array<String>, nil]
-        optional :phone_numbers, Lithic::Internal::Type::ArrayOf[String]
-
-        # @!method initialize(entity_token:, address: nil, dba_business_name: nil, government_id: nil, legal_business_name: nil, parent_company: nil, phone_numbers: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {Lithic::Models::AccountHolderUpdateParams::BusinessEntity} for more details.
-        #
-        #   Information for business for which the account is being opened and KYB is being
-        #   run.
-        #
-        #   @param entity_token [String] Globally unique identifier for an entity.
-        #
-        #   @param address [Lithic::Models::AddressUpdate] Business''s physical address - PO boxes, UPS drops, and FedEx drops are not acce
-        #
-        #   @param dba_business_name [String] Any name that the business operates under that is not its legal business name (i
-        #
-        #   @param government_id [String] Government-issued identification number. US Federal Employer Identification Numb
-        #
-        #   @param legal_business_name [String] Legal (formal) business name.
-        #
-        #   @param parent_company [String] Parent company name (if applicable).
-        #
-        #   @param phone_numbers [Array<String>] One or more of the business's phone number(s), entered as a list in E.164 format
-      end
+          # @!attribute first_name
+          #   Allowed for KYC-Exempt, BYO-KYC. Account holder's first name.
+          #
+          #   @return [String, nil]
+          optional :first_name, String
 
-      class ControlPerson < Lithic::Internal::Type::BaseModel
-        # @!attribute entity_token
-        #   Globally unique identifier for an entity.
-        #
-        #   @return [String]
-        required :entity_token, String
-
-        # @!attribute address
-        #   Individual's current address - PO boxes, UPS drops, and FedEx drops are not
-        #   acceptable; APO/FPO are acceptable. Only USA addresses are currently supported.
-        #
-        #   @return [Lithic::Models::AddressUpdate, nil]
-        optional :address, -> { Lithic::AddressUpdate }
-
-        # @!attribute dob
-        #   Individual's date of birth, as an RFC 3339 date.
-        #
-        #   @return [String, nil]
-        optional :dob, String
-
-        # @!attribute email
-        #   Individual's email address. If utilizing Lithic for chargeback processing, this
-        #   customer email address may be used to communicate dispute status and resolution.
-        #
-        #   @return [String, nil]
-        optional :email, String
-
-        # @!attribute first_name
-        #   Individual's first name, as it appears on government-issued identity documents.
-        #
-        #   @return [String, nil]
-        optional :first_name, String
-
-        # @!attribute last_name
-        #   Individual's last name, as it appears on government-issued identity documents.
-        #
-        #   @return [String, nil]
-        optional :last_name, String
-
-        # @!attribute phone_number
-        #   Individual's phone number, entered in E.164 format.
-        #
-        #   @return [String, nil]
-        optional :phone_number, String
-
-        request_only do
-          # @!attribute government_id
-          #   Government-issued identification number (required for identity verification and
-          #   compliance with banking regulations). Social Security Numbers (SSN) and
-          #   Individual Taxpayer Identification Numbers (ITIN) are currently supported,
-          #   entered as full nine-digits, with or without hyphens
+          # @!attribute last_name
+          #   Allowed for KYC-Exempt, BYO-KYC. Account holder's last name.
           #
           #   @return [String, nil]
-          optional :government_id, String
-        end
+          optional :last_name, String
 
-        # @!method initialize(entity_token:, address: nil, dob: nil, email: nil, first_name: nil, government_id: nil, last_name: nil, phone_number: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {Lithic::Models::AccountHolderUpdateParams::ControlPerson} for more details.
-        #
-        #   An individual with significant responsibility for managing the legal entity
-        #   (e.g., a Chief Executive Officer, Chief Financial Officer, Chief Operating
-        #   Officer, Managing Member, General Partner, President, Vice President, or
-        #   Treasurer). This can be an executive, or someone who will have program-wide
-        #   access to the cards that Lithic will provide. In some cases, this individual
-        #   could also be a beneficial owner listed above. See
-        #   [FinCEN requirements](https://www.fincen.gov/sites/default/files/shared/CDD_Rev6.7_Sept_2017_Certificate.pdf)
-        #   (Section II) for more background.
-        #
-        #   @param entity_token [String] Globally unique identifier for an entity.
-        #
-        #   @param address [Lithic::Models::AddressUpdate] Individual's current address - PO boxes, UPS drops, and FedEx drops are not acce
-        #
-        #   @param dob [String] Individual's date of birth, as an RFC 3339 date.
-        #
-        #   @param email [String] Individual's email address. If utilizing Lithic for chargeback processing, this
-        #
-        #   @param first_name [String] Individual's first name, as it appears on government-issued identity documents.
-        #
-        #   @param government_id [String] Government-issued identification number (required for identity verification and
-        #
-        #   @param last_name [String] Individual's last name, as it appears on government-issued identity documents.
-        #
-        #   @param phone_number [String] Individual's phone number, entered in E.164 format.
-      end
+          # @!attribute legal_business_name
+          #   Allowed for BYO-KYB. Legal business name of the account holder.
+          #
+          #   @return [String, nil]
+          optional :legal_business_name, String
 
-      class Individual < Lithic::Internal::Type::BaseModel
-        # @!attribute entity_token
-        #   Globally unique identifier for an entity.
-        #
-        #   @return [String]
-        required :entity_token, String
-
-        # @!attribute address
-        #   Individual's current address - PO boxes, UPS drops, and FedEx drops are not
-        #   acceptable; APO/FPO are acceptable. Only USA addresses are currently supported.
-        #
-        #   @return [Lithic::Models::AddressUpdate, nil]
-        optional :address, -> { Lithic::AddressUpdate }
-
-        # @!attribute dob
-        #   Individual's date of birth, as an RFC 3339 date.
-        #
-        #   @return [String, nil]
-        optional :dob, String
-
-        # @!attribute email
-        #   Individual's email address. If utilizing Lithic for chargeback processing, this
-        #   customer email address may be used to communicate dispute status and resolution.
-        #
-        #   @return [String, nil]
-        optional :email, String
-
-        # @!attribute first_name
-        #   Individual's first name, as it appears on government-issued identity documents.
-        #
-        #   @return [String, nil]
-        optional :first_name, String
-
-        # @!attribute last_name
-        #   Individual's last name, as it appears on government-issued identity documents.
-        #
-        #   @return [String, nil]
-        optional :last_name, String
-
-        # @!attribute phone_number
-        #   Individual's phone number, entered in E.164 format.
-        #
-        #   @return [String, nil]
-        optional :phone_number, String
-
-        request_only do
-          # @!attribute government_id
-          #   Government-issued identification number (required for identity verification and
-          #   compliance with banking regulations). Social Security Numbers (SSN) and
-          #   Individual Taxpayer Identification Numbers (ITIN) are currently supported,
-          #   entered as full nine-digits, with or without hyphens
+          # @!attribute phone_number
+          #   Allowed for all Account Holders. Account holder's phone number, entered in E.164
+          #   format. The primary purpose of this field is for cardholder identification and
+          #   verification during the digital wallet tokenization process.
           #
           #   @return [String, nil]
-          optional :government_id, String
+          optional :phone_number, String
+
+          # @!method initialize(address: nil, business_account_token: nil, email: nil, first_name: nil, last_name: nil, legal_business_name: nil, phone_number: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Lithic::Models::AccountHolderUpdateParams::Body::PatchRequest} for more
+          #   details.
+          #
+          #   The legacy request for updating an account holder.
+          #
+          #   @param address [Lithic::Models::AddressUpdate] Allowed for: KYC-Exempt, BYO-KYC, BYO-KYB.
+          #
+          #   @param business_account_token [String] Allowed for: KYC-Exempt, BYO-KYC. The token of the business account to which the
+          #
+          #   @param email [String] Allowed for all Account Holders. Account holder's email address. The primary pur
+          #
+          #   @param first_name [String] Allowed for KYC-Exempt, BYO-KYC. Account holder's first name.
+          #
+          #   @param last_name [String] Allowed for KYC-Exempt, BYO-KYC. Account holder's last name.
+          #
+          #   @param legal_business_name [String] Allowed for BYO-KYB. Legal business name of the account holder.
+          #
+          #   @param phone_number [String] Allowed for all Account Holders. Account holder's phone number, entered in E.164
         end
 
-        # @!method initialize(entity_token:, address: nil, dob: nil, email: nil, first_name: nil, government_id: nil, last_name: nil, phone_number: nil)
-        #   Some parameter documentations has been truncated, see
-        #   {Lithic::Models::AccountHolderUpdateParams::Individual} for more details.
-        #
-        #   Information on the individual for whom the account is being opened and KYC is
-        #   being run.
-        #
-        #   @param entity_token [String] Globally unique identifier for an entity.
-        #
-        #   @param address [Lithic::Models::AddressUpdate] Individual's current address - PO boxes, UPS drops, and FedEx drops are not acce
-        #
-        #   @param dob [String] Individual's date of birth, as an RFC 3339 date.
-        #
-        #   @param email [String] Individual's email address. If utilizing Lithic for chargeback processing, this
-        #
-        #   @param first_name [String] Individual's first name, as it appears on government-issued identity documents.
-        #
-        #   @param government_id [String] Government-issued identification number (required for identity verification and
-        #
-        #   @param last_name [String] Individual's last name, as it appears on government-issued identity documents.
-        #
-        #   @param phone_number [String] Individual's phone number, entered in E.164 format.
+        # @!method self.variants
+        #   @return [Array(Lithic::Models::AccountHolderUpdateParams::Body::KYBPatchRequest, Lithic::Models::AccountHolderUpdateParams::Body::KYCPatchRequest, Lithic::Models::AccountHolderUpdateParams::Body::PatchRequest)]
       end
     end
   end