Person

Overview

A person represents an individual with distinct legal identity and rights, typically associated with consumer deposit account products. This entity captures all necessary legal and identification details required for regulatory compliance, identity verification, and role assignment within a business context.
This section defines the required fields and data specifications for person records.

Person data includes:

  • Unique identifiers for the person and associated business
  • Primary and secondary government-issued identification details
  • Role designation and associated start/end dates
  • Legal name and ID issuance/expiration metadata

Field Definitions

FIELDS

REQUIRED

DESCRIPTION

CHARACTER LENGTH

EXAMPLE

PERSON ID

Y

A unique identifier for the PERSON.

35

CUST123456

BUSINESS ID

Y

A unique identifier for the business associated with the PERSON

20

BUS789012

PERSON FIRST ID TYPE

Y

Please select one of the following values PERSON identification.

SSN (Social Security Number) - Required for US Citizens.
DRIVERSLICENSENO (Driver's License Number)
MATRICULACONSNO (Matricula Consular Number)
PASSPORT (Passport)
VISA (Visa)
ALIENREG (Alien Reg. (Green Card))
STATEID (State ID)
GOVERNMENTID (Government ID)
OTHERID (Other Identification)
USTAXID (US Tax ID)

16

SSN

PERSON FIRST ID NUMBER

Y

The ID Number associated with the ID type.

40

123-45-6789

PERSON FIRST ID ISSUE DATE

N

Date when the identification was issued.

Date(YYYYMMDD)

20200101

PERSON FIRST ID EXPIRATION DATE

N

Date when the identification expires.

Date(YYYYMMDD)

20230101

PERSON SECOND ID TYPE

N

Codes used to identify PERSON identification value.
Cannot be the same id as the first.

DRIVERSLICENSENO (Driver's License Number)
MATRICULACONSNO (Matricula Consular Number)
PASSPORT (Passport)
VISA (Visa)
ALIENREG (Alien Reg. (Green Card))
STATEID (State ID)
GOVERNMENTID (Government ID)
OTHERID (Other Identification)
USTAXID (US Tax ID)

16

DRIVERSLICENSENO

PERSON SECOND ID NUMBER

N

Value used to identify the PERSON ID.

40

123-45-6789

PERSON SECOND ID ISSUE DATE

N

Date when the identification was issued.

Date(YYYYMMDD)

20200101

PERSON SECOND ID EXPIRATION DATE

N

Date when the identification expires.

Date(YYYYMMDD)

20300101

PERSON ROLE

Y

A PERSON role can be primary user or authorized user. Please enter either ‘Primary’ or ‘Authorized User’

30

 Primary

PERSON ROLE START DATE

N

The date the role started

Date(YYYYMMDD)

20200101

PERSON ROLE END DATE

N

Date that the role end or changed.

Date(YYYYMMDD)

20230101

PERSON STATUS

Y

Code used to identify status. Can be ‘Active’ or ‘Inactive’

10

Active

RESIDENCY STATUS

N

Only required for Primary Account Holders(Customers) and not Authorized Users.

US = US Citizen,
RA = Resident Alien,
NA = Non-resident Alien

3

 US

PERSON FIRST NAME

Y

First name of the primary PERSON.

50

John

PERSON MIDDLE NAME

N

Middle name of the PERSON.

50

James

PERSON LAST NAME

Y

Last name of the primary PERSON.

50

Doe

DATE OF BIRTH

Y

Date of birth of the PERSON.

Date(YYYYMMDD)

19800101

ADDRESS LINE 1

Y

Address line 1 (cannot be a PO BOX address).

100

123 Main St

ADDRESS LINE 2

N

Address line 2.

100

Apt 4B

CITY

Y

City of the PERSON.

50

New York

STATE

N

State of the PERSON (required for US addresses).

2

NY

ZIP CODE

N

ZIP code of the PERSON (required for US addresses).

10

10001

COUNTRY

Y

Country code of the PERSON (ISO 3166-1).

2

US

PRIMARY PHONE NUMBER

N

Primary phone number of the PERSON.

15

1-555-555-5555

EMAIL ADDRESS

N

Email address of the PERSON.

100

[email protected]