lithic 0.1.0.pre.alpha.1

data/lib/lithic/models/account_holder_create_params.rb

@@ -0,0 +1,615 @@
+# frozen_string_literal: true
+
+module Lithic
+  module Models
+    class AccountHolderCreateParams < Lithic::BaseModel
+      # @!parse
+      #   extend Lithic::RequestParameters::Converter
+      include Lithic::RequestParameters
+
+      # @!attribute beneficial_owner_entities
+      #   List of all entities with >25% ownership in the company. If no entity or
+      #     individual owns >25% of the company, and the largest shareholder is an entity,
+      #     please identify them in this field. See
+      #     [FinCEN requirements](https://www.fincen.gov/sites/default/files/shared/CDD_Rev6.7_Sept_2017_Certificate.pdf)
+      #     (Section I) for more background. If no business owner is an entity, pass in an
+      #     empty list. However, either this parameter or `beneficial_owner_individuals`
+      #     must be populated. on entities that should be included.
+      #
+      #   @return [Array<Lithic::Models::AccountHolderCreateParams::BeneficialOwnerEntity>]
+      required :beneficial_owner_entities,
+               -> { Lithic::ArrayOf[Lithic::Models::AccountHolderCreateParams::BeneficialOwnerEntity] }
+
+      # @!attribute beneficial_owner_individuals
+      #   List of all direct and indirect individuals with >25% ownership in the company.
+      #     If no entity or individual owns >25% of the company, and the largest shareholder
+      #     is an individual, please identify them in this field. 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. If no
+      #     individual is an entity, pass in an empty list. However, either this parameter
+      #     or `beneficial_owner_entities` must be populated.
+      #
+      #   @return [Array<Lithic::Models::AccountHolderCreateParams::BeneficialOwnerIndividual>]
+      required :beneficial_owner_individuals,
+               -> { Lithic::ArrayOf[Lithic::Models::AccountHolderCreateParams::BeneficialOwnerIndividual] }
+
+      # @!attribute business_entity
+      #   Information for business for which the account is being opened and KYB is being
+      #     run.
+      #
+      #   @return [Lithic::Models::AccountHolderCreateParams::BusinessEntity]
+      required :business_entity, -> { Lithic::Models::AccountHolderCreateParams::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::AccountHolderCreateParams::ControlPerson]
+      required :control_person, -> { Lithic::Models::AccountHolderCreateParams::ControlPerson }
+
+      # @!attribute nature_of_business
+      #   Short description of the company's line of business (i.e., what does the company
+      #     do?).
+      #
+      #   @return [String]
+      required :nature_of_business, String
+
+      # @!attribute tos_timestamp
+      #   An RFC 3339 timestamp indicating when the account holder accepted the applicable
+      #     legal agreements (e.g., cardholder terms) as agreed upon during API customer's
+      #     implementation with Lithic.
+      #
+      #   @return [String]
+      required :tos_timestamp, String
+
+      # @!attribute workflow
+      #   Specifies the workflow type. This must be 'KYC_EXEMPT'
+      #
+      #   @return [Symbol, Lithic::Models::AccountHolderCreateParams::Workflow]
+      required :workflow, enum: -> { Lithic::Models::AccountHolderCreateParams::Workflow }
+
+      # @!attribute [r] 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
+
+      # @!parse
+      #   # @return [String]
+      #   attr_writer :external_id
+
+      # @!attribute [r] kyb_passed_timestamp
+      #   An RFC 3339 timestamp indicating when precomputed KYC was completed on the
+      #     business with a pass result.
+      #
+      #     This field is required only if workflow type is `KYB_BYO`.
+      #
+      #   @return [String, nil]
+      optional :kyb_passed_timestamp, String
+
+      # @!parse
+      #   # @return [String]
+      #   attr_writer :kyb_passed_timestamp
+
+      # @!attribute [r] website_url
+      #   Company website URL.
+      #
+      #   @return [String, nil]
+      optional :website_url, String
+
+      # @!parse
+      #   # @return [String]
+      #   attr_writer :website_url
+
+      # @!attribute individual
+      #   Information on individual for whom the account is being opened and KYC is being
+      #     run.
+      #
+      #   @return [Lithic::Models::AccountHolderCreateParams::Individual]
+      required :individual, -> { Lithic::Models::AccountHolderCreateParams::Individual }
+
+      # @!attribute [r] kyc_passed_timestamp
+      #   An RFC 3339 timestamp indicating when precomputed KYC was completed on the
+      #     individual with a pass result.
+      #
+      #     This field is required only if workflow type is `KYC_BYO`.
+      #
+      #   @return [String, nil]
+      optional :kyc_passed_timestamp, String
+
+      # @!parse
+      #   # @return [String]
+      #   attr_writer :kyc_passed_timestamp
+
+      # @!attribute address
+      #   KYC Exempt user's current address - PO boxes, UPS drops, and FedEx drops are not
+      #     acceptable; APO/FPO are acceptable.
+      #
+      #   @return [Lithic::Models::Address]
+      required :address, -> { Lithic::Models::Address }
+
+      # @!attribute email
+      #   The KYC Exempt user's email
+      #
+      #   @return [String]
+      required :email, String
+
+      # @!attribute first_name
+      #   The KYC Exempt user's first name
+      #
+      #   @return [String]
+      required :first_name, String
+
+      # @!attribute kyc_exemption_type
+      #   Specifies the type of KYC Exempt user
+      #
+      #   @return [Symbol, Lithic::Models::AccountHolderCreateParams::KYCExemptionType]
+      required :kyc_exemption_type, enum: -> { Lithic::Models::AccountHolderCreateParams::KYCExemptionType }
+
+      # @!attribute last_name
+      #   The KYC Exempt user's last name
+      #
+      #   @return [String]
+      required :last_name, String
+
+      # @!attribute phone_number
+      #   The KYC Exempt user's phone number, entered in E.164 format.
+      #
+      #   @return [String]
+      required :phone_number, String
+
+      # @!attribute [r] business_account_token
+      #   Only applicable for customers using the KYC-Exempt workflow to enroll authorized
+      #     users of businesses. Pass the account_token of the enrolled business associated
+      #     with the AUTHORIZED_USER in this field.
+      #
+      #   @return [String, nil]
+      optional :business_account_token, String
+
+      # @!parse
+      #   # @return [String]
+      #   attr_writer :business_account_token
+
+      # @!parse
+      #   # @param beneficial_owner_entities [Array<Lithic::Models::AccountHolderCreateParams::BeneficialOwnerEntity>]
+      #   # @param beneficial_owner_individuals [Array<Lithic::Models::AccountHolderCreateParams::BeneficialOwnerIndividual>]
+      #   # @param business_entity [Lithic::Models::AccountHolderCreateParams::BusinessEntity]
+      #   # @param control_person [Lithic::Models::AccountHolderCreateParams::ControlPerson]
+      #   # @param nature_of_business [String]
+      #   # @param tos_timestamp [String]
+      #   # @param workflow [Symbol, Lithic::Models::AccountHolderCreateParams::Workflow]
+      #   # @param individual [Lithic::Models::AccountHolderCreateParams::Individual]
+      #   # @param address [Lithic::Models::Address]
+      #   # @param email [String]
+      #   # @param first_name [String]
+      #   # @param kyc_exemption_type [Symbol, Lithic::Models::AccountHolderCreateParams::KYCExemptionType]
+      #   # @param last_name [String]
+      #   # @param phone_number [String]
+      #   # @param external_id [String]
+      #   # @param kyb_passed_timestamp [String]
+      #   # @param website_url [String]
+      #   # @param kyc_passed_timestamp [String]
+      #   # @param business_account_token [String]
+      #   # @param request_options [Lithic::RequestOptions, Hash{Symbol=>Object}]
+      #   #
+      #   def initialize(
+      #     beneficial_owner_entities:,
+      #     beneficial_owner_individuals:,
+      #     business_entity:,
+      #     control_person:,
+      #     nature_of_business:,
+      #     tos_timestamp:,
+      #     workflow:,
+      #     individual:,
+      #     address:,
+      #     email:,
+      #     first_name:,
+      #     kyc_exemption_type:,
+      #     last_name:,
+      #     phone_number:,
+      #     external_id: nil,
+      #     kyb_passed_timestamp: nil,
+      #     website_url: nil,
+      #     kyc_passed_timestamp: nil,
+      #     business_account_token: nil,
+      #     request_options: {},
+      #     **
+      #   )
+      #     super
+      #   end
+
+      # def initialize: (Hash | Lithic::BaseModel) -> void
+
+      class BeneficialOwnerEntity < Lithic::BaseModel
+        # @!attribute address
+        #   Business's physical address - PO boxes, UPS drops, and FedEx drops are not
+        #     acceptable; APO/FPO are acceptable.
+        #
+        #   @return [Lithic::Models::Address]
+        required :address, -> { Lithic::Models::Address }
+
+        # @!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]
+        required :government_id, String
+
+        # @!attribute legal_business_name
+        #   Legal (formal) business name.
+        #
+        #   @return [String]
+        required :legal_business_name, 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>]
+        required :phone_numbers, Lithic::ArrayOf[String]
+
+        # @!attribute [r] 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
+
+        # @!parse
+        #   # @return [String]
+        #   attr_writer :dba_business_name
+
+        # @!attribute [r] parent_company
+        #   Parent company name (if applicable).
+        #
+        #   @return [String, nil]
+        optional :parent_company, String
+
+        # @!parse
+        #   # @return [String]
+        #   attr_writer :parent_company
+
+        # @!parse
+        #   # @param address [Lithic::Models::Address]
+        #   # @param government_id [String]
+        #   # @param legal_business_name [String]
+        #   # @param phone_numbers [Array<String>]
+        #   # @param dba_business_name [String]
+        #   # @param parent_company [String]
+        #   #
+        #   def initialize(
+        #     address:,
+        #     government_id:,
+        #     legal_business_name:,
+        #     phone_numbers:,
+        #     dba_business_name: nil,
+        #     parent_company: nil,
+        #     **
+        #   )
+        #     super
+        #   end
+
+        # def initialize: (Hash | Lithic::BaseModel) -> void
+      end
+
+      class BeneficialOwnerIndividual < Lithic::BaseModel
+        # @!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::Address]
+        required :address, -> { Lithic::Models::Address }
+
+        # @!attribute dob
+        #   Individual's date of birth, as an RFC 3339 date.
+        #
+        #   @return [String]
+        required :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]
+        required :email, String
+
+        # @!attribute first_name
+        #   Individual's first name, as it appears on government-issued identity documents.
+        #
+        #   @return [String]
+        required :first_name, String
+
+        # @!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]
+        required :government_id, String
+
+        # @!attribute last_name
+        #   Individual's last name, as it appears on government-issued identity documents.
+        #
+        #   @return [String]
+        required :last_name, String
+
+        # @!attribute [r] phone_number
+        #   Individual's phone number, entered in E.164 format.
+        #
+        #   @return [String, nil]
+        optional :phone_number, String
+
+        # @!parse
+        #   # @return [String]
+        #   attr_writer :phone_number
+
+        # @!parse
+        #   # Individuals associated with a KYB application. Phone number is optional.
+        #   #
+        #   # @param address [Lithic::Models::Address]
+        #   # @param dob [String]
+        #   # @param email [String]
+        #   # @param first_name [String]
+        #   # @param government_id [String]
+        #   # @param last_name [String]
+        #   # @param phone_number [String]
+        #   #
+        #   def initialize(address:, dob:, email:, first_name:, government_id:, last_name:, phone_number: nil, **) = super
+
+        # def initialize: (Hash | Lithic::BaseModel) -> void
+      end
+
+      class BusinessEntity < Lithic::BaseModel
+        # @!attribute address
+        #   Business's physical address - PO boxes, UPS drops, and FedEx drops are not
+        #     acceptable; APO/FPO are acceptable.
+        #
+        #   @return [Lithic::Models::Address]
+        required :address, -> { Lithic::Models::Address }
+
+        # @!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]
+        required :government_id, String
+
+        # @!attribute legal_business_name
+        #   Legal (formal) business name.
+        #
+        #   @return [String]
+        required :legal_business_name, 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>]
+        required :phone_numbers, Lithic::ArrayOf[String]
+
+        # @!attribute [r] 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
+
+        # @!parse
+        #   # @return [String]
+        #   attr_writer :dba_business_name
+
+        # @!attribute [r] parent_company
+        #   Parent company name (if applicable).
+        #
+        #   @return [String, nil]
+        optional :parent_company, String
+
+        # @!parse
+        #   # @return [String]
+        #   attr_writer :parent_company
+
+        # @!parse
+        #   # Information for business for which the account is being opened and KYB is being
+        #   #   run.
+        #   #
+        #   # @param address [Lithic::Models::Address]
+        #   # @param government_id [String]
+        #   # @param legal_business_name [String]
+        #   # @param phone_numbers [Array<String>]
+        #   # @param dba_business_name [String]
+        #   # @param parent_company [String]
+        #   #
+        #   def initialize(
+        #     address:,
+        #     government_id:,
+        #     legal_business_name:,
+        #     phone_numbers:,
+        #     dba_business_name: nil,
+        #     parent_company: nil,
+        #     **
+        #   )
+        #     super
+        #   end
+
+        # def initialize: (Hash | Lithic::BaseModel) -> void
+      end
+
+      class ControlPerson < Lithic::BaseModel
+        # @!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::Address]
+        required :address, -> { Lithic::Models::Address }
+
+        # @!attribute dob
+        #   Individual's date of birth, as an RFC 3339 date.
+        #
+        #   @return [String]
+        required :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]
+        required :email, String
+
+        # @!attribute first_name
+        #   Individual's first name, as it appears on government-issued identity documents.
+        #
+        #   @return [String]
+        required :first_name, String
+
+        # @!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]
+        required :government_id, String
+
+        # @!attribute last_name
+        #   Individual's last name, as it appears on government-issued identity documents.
+        #
+        #   @return [String]
+        required :last_name, String
+
+        # @!attribute [r] phone_number
+        #   Individual's phone number, entered in E.164 format.
+        #
+        #   @return [String, nil]
+        optional :phone_number, String
+
+        # @!parse
+        #   # @return [String]
+        #   attr_writer :phone_number
+
+        # @!parse
+        #   # 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 address [Lithic::Models::Address]
+        #   # @param dob [String]
+        #   # @param email [String]
+        #   # @param first_name [String]
+        #   # @param government_id [String]
+        #   # @param last_name [String]
+        #   # @param phone_number [String]
+        #   #
+        #   def initialize(address:, dob:, email:, first_name:, government_id:, last_name:, phone_number: nil, **) = super
+
+        # def initialize: (Hash | Lithic::BaseModel) -> void
+      end
+
+      # Specifies the workflow type. This must be 'KYC_EXEMPT'
+      module Workflow
+        extend Lithic::Enum
+
+        KYC_EXEMPT = :KYC_EXEMPT
+
+        finalize!
+
+        # @!parse
+        #   # @return [Array<Symbol>]
+        #   def self.values; end
+      end
+
+      class Individual < Lithic::BaseModel
+        # @!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::Address]
+        required :address, -> { Lithic::Models::Address }
+
+        # @!attribute dob
+        #   Individual's date of birth, as an RFC 3339 date.
+        #
+        #   @return [String]
+        required :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]
+        required :email, String
+
+        # @!attribute first_name
+        #   Individual's first name, as it appears on government-issued identity documents.
+        #
+        #   @return [String]
+        required :first_name, String
+
+        # @!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]
+        required :government_id, String
+
+        # @!attribute last_name
+        #   Individual's last name, as it appears on government-issued identity documents.
+        #
+        #   @return [String]
+        required :last_name, String
+
+        # @!attribute phone_number
+        #   Individual's phone number, entered in E.164 format.
+        #
+        #   @return [String]
+        required :phone_number, String
+
+        # @!parse
+        #   # Information on individual for whom the account is being opened and KYC is being
+        #   #   run.
+        #   #
+        #   # @param address [Lithic::Models::Address]
+        #   # @param dob [String]
+        #   # @param email [String]
+        #   # @param first_name [String]
+        #   # @param government_id [String]
+        #   # @param last_name [String]
+        #   # @param phone_number [String]
+        #   #
+        #   def initialize(address:, dob:, email:, first_name:, government_id:, last_name:, phone_number:, **) = super
+
+        # def initialize: (Hash | Lithic::BaseModel) -> void
+      end
+
+      # Specifies the type of KYC Exempt user
+      module KYCExemptionType
+        extend Lithic::Enum
+
+        AUTHORIZED_USER = :AUTHORIZED_USER
+        PREPAID_CARD_USER = :PREPAID_CARD_USER
+
+        finalize!
+
+        # @!parse
+        #   # @return [Array<Symbol>]
+        #   def self.values; end
+      end
+    end
+  end
+end