From d587c85125c254c1122cd975574e6ed2eda130a9 Mon Sep 17 00:00:00 2001
From: Bolt Agent <bolt@lightspark.com>
Date: Wed, 1 Jul 2026 19:25:55 +0000
Subject: [PATCH] feat: add idType/identifier to
 IndividualCustomerCreateRequest (ENG-10686)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Individual account-holder CIP capture — accept the individual's tax
identification (SSN/ITIN) on customer creation so sparkcore can bridge it to
paycore EntUserInfo.tax_identifier for Lead onboarding. Write-only: added to
the create request only (not the shared IndividualCustomerFields), so the SSN
is never echoed in customer responses. Mirrors the flat idType/identifier
shape beneficial owners already use.
---
 mintlify/openapi.yaml                                 |  8 ++++++++
 openapi.yaml                                          |  8 ++++++++
 .../customers/IndividualCustomerCreateRequest.yaml    | 11 +++++++++++
 3 files changed, 27 insertions(+)

diff --git a/mintlify/openapi.yaml b/mintlify/openapi.yaml
index a0caaf16e..84c5c63d1 100644
--- a/mintlify/openapi.yaml
+++ b/mintlify/openapi.yaml
@@ -9954,6 +9954,14 @@ components:
       allOf:
         - $ref: '#/components/schemas/CustomerCreateRequest'
         - $ref: '#/components/schemas/IndividualCustomerFields'
+        - type: object
+          properties:
+            idType:
+              $ref: '#/components/schemas/IdentificationType'
+            identifier:
+              type: string
+              description: The individual's tax identification number (SSN or ITIN for a US account holder). Required to onboard the individual as a US account holder. Write-only — never returned in customer responses.
+              example: 123-45-6789
     BusinessInfo:
       type: object
       description: Additional information required for business entities
diff --git a/openapi.yaml b/openapi.yaml
index a0caaf16e..84c5c63d1 100644
--- a/openapi.yaml
+++ b/openapi.yaml
@@ -9954,6 +9954,14 @@ components:
       allOf:
         - $ref: '#/components/schemas/CustomerCreateRequest'
         - $ref: '#/components/schemas/IndividualCustomerFields'
+        - type: object
+          properties:
+            idType:
+              $ref: '#/components/schemas/IdentificationType'
+            identifier:
+              type: string
+              description: The individual's tax identification number (SSN or ITIN for a US account holder). Required to onboard the individual as a US account holder. Write-only — never returned in customer responses.
+              example: 123-45-6789
     BusinessInfo:
       type: object
       description: Additional information required for business entities
diff --git a/openapi/components/schemas/customers/IndividualCustomerCreateRequest.yaml b/openapi/components/schemas/customers/IndividualCustomerCreateRequest.yaml
index 30531f661..ad3396329 100644
--- a/openapi/components/schemas/customers/IndividualCustomerCreateRequest.yaml
+++ b/openapi/components/schemas/customers/IndividualCustomerCreateRequest.yaml
@@ -2,3 +2,14 @@ title: Individual Customer Create Request
 allOf:
   - $ref: ./CustomerCreateRequest.yaml
   - $ref: ./IndividualCustomerFields.yaml
+  - type: object
+    properties:
+      idType:
+        $ref: ./IdentificationType.yaml
+      identifier:
+        type: string
+        description: >-
+          The individual's tax identification number (SSN or ITIN for a US
+          account holder). Required to onboard the individual as a US account
+          holder. Write-only — never returned in customer responses.
+        example: 123-45-6789