IdentifyingInformation
Government-issued IDs and tax identifiers. Used on individual customers, business customers, and each AssociatedPerson on a business.
| Field | Type | Required | Notes |
|---|---|---|---|
type | enum: drivers_license, national_id, passport, + 60+ tax-id types (ssn, itin, nino, rfc, …) | yes | Government IDs and tax identifiers share this array. |
issuing_country | string (ISO 3166-1 alpha-3) | yes | |
number | string | conditional | Required for government IDs. Optional for some tax-id types. |
description | string | conditional | Required when type === "other". |
expiration | string (YYYY-MM-DD) | no | |
image_front | string (base64 data-uri) | no | Min 200×200px, max 15 MB (combined with back: 24 MB). |
image_back | string (base64 data-uri) | no |
Example: US SSN
{
"type": "ssn",
"issuing_country": "USA",
"number": "111-22-3333"
}Example: passport with image
{
"type": "passport",
"issuing_country": "USA",
"number": "A12345678",
"expiration": "2032-06-01",
"image_front": "data:image/jpeg;base64,…"
}