Add KYB business-entity fields for Lead — NAICS, structured source of funds, counterparty countries (ENG-10687)

openapi/components/schemas/customers/BusinessInfo.yaml

@@ -74,3 +74,32 @@ properties:
     description: List of countries where the business expects to send payments (ISO 3166-1 alpha-2)
     example:
       - US
+  naicsCode:
+    type: string
+    pattern: '^\d{2,6}$'
+    description: NAICS code describing the nature of the business (2-6 digits)
+    example: '541511'
+  sourceOfFundsCategories:
+    type: array
+    items:
+      $ref: ./SourceOfFundsCategory.yaml
+    description: Structured source-of-funds categories for the business
+    example:
+      - OPERATING_REVENUE
+  sourceOfFundsOtherDescription:
+    type: string
+    maxLength: 500
+    description: Description of the source of funds when OTHER is selected
+    example: Proceeds from a legal settlement
+  purposeOfAccountOtherDescription:
+    type: string
+    maxLength: 500
+    description: Description of the account purpose when OTHER is selected
+    example: Escrow for equipment leases
+  expectedCounterpartyCountries:
+    type: array
+    items:
+      type: string
+    description: List of countries of the business's expected transaction counterparties (ISO 3166-1 alpha-2)
+    example:
+      - US

openapi/components/schemas/customers/BusinessInfoResponse.yaml

@@ -75,3 +75,32 @@ properties:
     description: List of countries where the business expects to send payments (ISO 3166-1 alpha-2)
     example:
       - US
+  naicsCode:
+    type: string
+    pattern: '^\d{2,6}$'
+    description: NAICS code describing the nature of the business (2-6 digits)
+    example: '541511'
+  sourceOfFundsCategories:
+    type: array
+    items:
+      $ref: ./SourceOfFundsCategory.yaml
+    description: Structured source-of-funds categories for the business
+    example:
+      - OPERATING_REVENUE
+  sourceOfFundsOtherDescription:
+    type: string
+    maxLength: 500
+    description: Description of the source of funds when OTHER is selected
+    example: Proceeds from a legal settlement
+  purposeOfAccountOtherDescription:
+    type: string
+    maxLength: 500
+    description: Description of the account purpose when OTHER is selected
+    example: Escrow for equipment leases
+  expectedCounterpartyCountries:
+    type: array
+    items:
+      type: string
+    description: List of countries of the business's expected transaction counterparties (ISO 3166-1 alpha-2)
+    example:
+      - US

openapi/components/schemas/customers/BusinessInfoUpdate.yaml

@@ -70,3 +70,32 @@ properties:
     description: List of countries where the business expects to send payments (ISO 3166-1 alpha-2)
     example:
       - US
+  naicsCode:
+    type: string
+    pattern: '^\d{2,6}$'
+    description: NAICS code describing the nature of the business (2-6 digits)
+    example: '541511'
+  sourceOfFundsCategories:
+    type: array
+    items:
+      $ref: ./SourceOfFundsCategory.yaml
+    description: Structured source-of-funds categories for the business
+    example:
+      - OPERATING_REVENUE
+  sourceOfFundsOtherDescription:
+    type: string
+    maxLength: 500
+    description: Description of the source of funds when OTHER is selected
+    example: Proceeds from a legal settlement
+  purposeOfAccountOtherDescription:
+    type: string
+    maxLength: 500
+    description: Description of the account purpose when OTHER is selected
+    example: Escrow for equipment leases
+  expectedCounterpartyCountries:
+    type: array
+    items:
+      type: string
+    description: List of countries of the business's expected transaction counterparties (ISO 3166-1 alpha-2)
+    example:
+      - US

openapi/components/schemas/customers/SourceOfFunds.yaml → openapi/components/schemas/customers/SourceOfFundsCategory.yaml

@@ -7,5 +7,5 @@ enum:
   - PERSONAL_SAVINGS
   - DONATIONS
   - OTHER
-description: The primary source of funds for the business
+description: A structured source-of-funds category for the business
 example: OPERATING_REVENUE

openapi/components/schemas/verifications/VerificationErrorType.yaml

@@ -20,6 +20,8 @@ enum:
   - APPLICANT_CRIMINAL_RECORD
   - APPLICANT_REJECTED
   - MISSING_BENEFICIAL_OWNER
+  - MISSING_CONTROL_PERSON
+  - MISSING_GOOD_STANDING_DOCUMENT
 description: >-
   Type of verification error. The category-specific MISSING_*_DOCUMENT types
   indicate which document category is needed. Document quality types