Principal Contact Object
This object will create the Principal Contact / Signer for the account. This object is required on all application submissions.
First Name
Description | The First Name of the Principal Contact. |
|---|---|
JSON String | principal_contact_first_name |
Type | String |
Required | Yes |
Comments | Max Length 40 characters. |
Last Name
Description | The Last Name of the Principal Contact. |
|---|---|
JSON String | principal_contact_last_name |
Type | String |
Required | Yes |
Comments | Max Length 80 characters. |
Mailing Address
Description | Residence associated with the person signing the Merchant Application. |
|---|---|
JSON String | principal_contact_mailing_address |
Type | Object |
Required | Yes |
Comments | XS_MAILING |
Address Line 1
Description | The Street Address portion of the residential mailing address of the signer. |
|---|---|
JSON String | address_line_1 |
Type | String |
Required | Yes |
Address City
Description | The City of the residential mailing address of the signer. |
|---|---|
JSON String | address_city |
Type | String |
Required | Yes |
Address State
Description | The State of the residential mailing address of the signer. |
|---|---|
JSON String | address_state |
Type | String |
Required | Yes |
Comments | Use only the two character state abbreviation. (i.e. AZ, NY) |
Address Zip Code
Description | The 5-digit Zip Code of the residential mailing address of the signer. |
|---|---|
JSON String | address_zipcode |
Type | String |
Required | Yes |
Work Phone Number
Description | Work Phone Number of the person signing the Merchant Application. |
|---|---|
JSON String | principal_contact_phone_number |
Type | String |
Required | Yes |
Comments | Format: (NNN)NNN-NNNN |
Mobile Phone Number
Description | Mobile Phone Number of the person signing the Merchant Application. |
|---|---|
JSON String | principal_contact_mobile_phone_number |
Type | String |
Required | Yes |
Comments | Format: (NNN)NNN-NNNN |
Email Address
Description | Email Address of the person signing the Merchant Application. |
|---|---|
JSON String | principal_contact_email |
Type | String |
Required | Yes |
Title
Description | Title of the person signing the Merchant Application. |
|---|---|
JSON String | principal_contact_title |
Type | String |
Required | Yes |
Birthdate
Description | The Date of Birth of the person signing the Merchant Application. |
|---|---|
JSON String | principal_contact_birthdate |
Type | Date |
Required | Yes |
Ownership Percentage
Description | The Percentage of Ownership the person holds of the company. |
|---|---|
JSON String | principal_contact_ownership_percentage |
Type | Double |
Required | Yes |
Comments | Valid Range 0-100 |
Contact Type
Description | The type of role the Contact has in the company. |
|---|---|
JSON String | principal_contact_contact_type |
Type | String. Static Variables below. |
Required | Yes |
| Comments | Valid Values: XS_CONTACT_TYPE_OWNER = "Owner" XS_CONTACT_TYPE_OFFICER = "Officer" |
SSN
Description | A number assigned to U.S. citizens, unique for each individual, used to track Social Security benefits and for other identification processes. |
|---|---|
JSON String | principal_contact_ssn |
Type | String |
Required | Yes |
Comments | Format: NNN-NN-NNNN |
Is Primary Contact
Description | Indicates that this Principal Contact is the primary contact for the Merchant Application. |
|---|---|
JSON String | principal_contact_is_primary |
Type | Boolean |
Required | Yes |
Comments | True = Primary Contact / False = Additional Contact |
PrincipalContact o_contact = new PrincipalContact();
o_contact.setFirstName( "John" );
o_contact.setLastName( "Doe" );
Address o_mailing = new Address( Address.XS_MAILING );
o_mailing.setLine1( "9876 West 1st St East" );
o_mailing.setCity( "Toontown" );
o_mailing.setState( "AZ" );
o_mailing.setZipcode( "85264" );
o_contact.setMailingAddress( o_mailing );
o_contact.setWorkPhoneNumber( "(480)555-1234" );
o_contact.setMobilePhoneNumber( "(480)555-4789" );
o_contact.setEmail( "John.Doe@email.com" );
o_contact.setTitle( "Owner" );
o_contact.setBirthdate( new Date() );
o_contact.setOwnershipPercentage( 100 );
o_contact.setContactType( PrincipalContact.X_CONTACT_TYPE_OWNER );
o_contact.setSSN( "111-11-1111" );
o_location.addPrincipalContact( o_contact );