Menu

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 );