Skip to main content

Resources

IndividualApplication

IndividualApplication is a JSON:API resource, top-level fields:

NameTypeDescription
id RequiredstringIdentifier of the application resource.
type RequiredstringType of the application resource. For individual application the value is always individualApplication.
attributes RequiredJSON ObjectJSON object representing the application data.
relationships RequiredJSON:API RelationshipsDescribes relationships between the application resource and other resources (documents).

Attributes

NameTypeDescription
status RequiredstringOne of AwaitingDocuments, PendingReview, Approved, Denied or Pending, see Application Statuses.
message RequiredstringA message describing the IndividualApplication status.
createdAt RequiredRFC3339 Date stringThe date the resource was created.
updatedAt OptionalRFC3339 Date stringThe date the resource was updated.
ssn RequiredstringSSN of the individual (numbers only). Either ssn or passport will be populated.
passport RequiredstringIndividual passport number. Either ssn or passport will be populated.
nationalityISO31661-Alpha2 stringRequired if a passport is used as the main ID and optional when ssn is used. Two letters representing the individual's nationality. (e.g. "US").
fullName RequiredFullNameFull name of the individual.
dateOfBirth RequiredRFC3339 Date stringDate only (e.g. "2001-08-15").
address RequiredAddressAddress of the individual.
phone RequiredPhonePhone of the individual.
email RequiredstringEmail address of the individual.
ip RequiredstringIP address of the end-customer creating the application, if specified.
soleProprietorship OptionalbooleanIndicates whether the individual is a sole proprietor, if specified.
ein OptionalstringIndicates if the individual is a sole proprietor who has an Employer Identification Number, if specified.
dba OptionalstringIndicates if the individual is a sole proprietor who is doing business under a different name, if specified.
archived RequiredbooleanIndicates whether the application has been archived. Archived applications are read-only and no changes can be made to them. Once an application has been archived, a new application with the same SSN (or Passport) may be submitted. An application becomes archived once the corresponding customer is archived.
idTheftScore OptionalnumberScore (0-1000) for ID theft verification, >900 is auto rejected as default (threshold is configurable).
tags RequiredobjectSee Tags.
accountPurpose RequiredaccountPurposeThe primary purpose of the account.
accountPurposeDetailstringRequired if accountPurpose is one of Cryptocurrency,CashHeavyPersonalIncome,InternationalRemittances
sourceOfFunds RequiredsourceOfFundsThe primary source of funds of the business. One of SalaryOrWages,BusinessIncome,InvestmentIncome,RetirementSavings,Inheritance,Gift,SaleOfAssets,LegalSettlement,LoanProceeds
transactionVolume RequiredtransactionVolumeThe expected monthly transaction volume of the business. One of Between1KAnd5K,Between5KAnd15K,Between15KAnd30K,Between30KAnd60K,GreaterThan60K
transactionVolumeDescriptionstringRequired when transactionVolume is $30,001 or higher. Further detail around transaction volume selection.
profession RequiredprofessionThe occupation of the individual.
website OptionalstringA Valid website URL. Present when soleProprietorship is true.
sourceOfFundsDescriptionstringRequired if sourceOfFunds is one of GovernmentContractsOrGrants,DonationsOrFundraising,ImportExportRevenue. Present when soleProprietorship is true.
businessIndustry RequiredbusinessIndustryThe industry of the sole proprietor. Present when soleProprietorship is true.
businessDescription RequiredstringA brief description of the business, including its main products or services and the customers. Present when soleProprietorship is true.
isIncorporated RequiredbooleanIs the business incorporated. Present when soleProprietorship is true.
stateOfIncorporationstringRequired if isIncorporated is true. Two letters representing a US state. Present when soleProprietorship is true.
yearOfIncorporationYear stringRequired if isIncorporated is true. Year of incorporation of the business. Present when soleProprietorship is true.
countriesOfOperation RequiredArray of ISO31661-Alpha2 stringsPresent when soleProprietorship is true.
usNexus Requiredarray of usNexusThe nature of the business's ties to the U.S. Present when soleProprietorship is true.

Relationships

NameTypeDescription
documents OptionalArray of JSON:API RelationshipApplication's documents.
customer OptionalJSON:API RelationshipThe created Customer in case of approved application.
applicationForm OptionalJSON:API RelationshipThe ApplicationForm through which the application has been submitted.
Example IndividualApplication resource:
{
"type": "individualApplication",
"id": "53",
"attributes": {
"createdAt": "2020-01-14T14:05:04.718Z",
"fullName": {
"first": "Peter",
"last": "Parker"
},
"ssn": "721074426",
"address": {
"street": "20 Ingram St",
"street2": null,
"city": "Forest Hills",
"state": "NY",
"postalCode": "11375",
"country": "US"
},
"dateOfBirth": "2001-08-10",
"email": "peter@oscorp.com",
"phone": {
"countryCode": "1",
"number": "1555555578"
},
"status": "AwaitingDocuments",
"message": "Waiting for you to upload the required documents.",
"archived": false,
"soleProprietorship": false,
"accountPurpose": "PayrollOrDirectDeposit",
"sourceOfFunds": "SalaryOrWages",
"transactionVolume": "Between1KAnd5K",
"profession": "Farmer",
"tags": {
"userId": "106a75e9-de77-4e25-9561-faffe59d7814"
}
},
"relationships": {
"org": {
"data": {
"type": "org",
"id": "1"
}
},
"documents": {
"data": [
{
"type": "document",
"id": "1"
},
{
"type": "document",
"id": "2"
}
]
},
"applicationForm": {
"data": {
"type": "applicationForm",
"id": "3"
}
}
}
}

See attribute descriptions above. When soleProprietorship is true, the resource includes sole-proprietor regulatory fields such as website, businessIndustry, and usNexus.

Example Sole Proprietorship IndividualApplication resource:
{
"type": "individualApplication",
"id": "54",
"attributes": {
"createdAt": "2020-01-14T14:05:04.718Z",
"fullName": {
"first": "Peter",
"last": "Parker"
},
"ssn": "721074426",
"address": {
"street": "20 Ingram St",
"street2": null,
"city": "Forest Hills",
"state": "NY",
"postalCode": "11375",
"country": "US"
},
"dateOfBirth": "2001-08-10",
"email": "peter@oscorp.com",
"phone": {
"countryCode": "1",
"number": "1555555578"
},
"status": "Approved",
"message": "Congrats - your application has been approved.",
"archived": false,
"soleProprietorship": true,
"ein": "123456789",
"dba": "Piedpiper Inc",
"website": "https://www.piedpiper.com",
"accountPurpose": "EcommerceSales",
"sourceOfFunds": "SalesOfServices",
"transactionVolume": "LessThan5K",
"usNexus": [
"NotAvailable"
],
"countriesOfOperation": [
"US",
"CA"
],
"isIncorporated": false,
"businessIndustry": "GroceryStoresOrSupermarkets",
"tags": {
"userId": "106a75e9-de77-4e25-9561-faffe59d7814"
}
},
"relationships": {
"org": {
"data": {
"type": "org",
"id": "1"
}
},
"customer": {
"data": {
"type": "individualCustomer",
"id": "8"
}
},
"applicationForm": {
"data": {
"type": "applicationForm",
"id": "3"
}
}
}
}

BusinessApplication

BusinessApplication is a JSON:API resource, top-level fields:

NameTypeDescription
id RequiredstringIdentifier of the application resource.
type RequiredstringType of the application resource, for business application the value is always businessApplication.
attributes RequiredJSON ObjectJSON object representing the application data.
relationships RequiredJSON:API RelationshipsDescribes relationships between the application resource and other resources (documents).

Attributes

NameTypeDescription
status RequiredstringOne of AwaitingDocuments, PendingReview, Approved, Denied or Pending, see Application Statuses.
message RequiredstringA message describing the BusinessApplication status.
createdAt RequiredRFC3339 Date stringThe date the resource was created.
updatedAt OptionalRFC3339 Date stringThe date the resource was updated.
name RequiredstringName of the business.
dba Optionalstring"Doing business as".
address RequiredAddressAddress of the business.
operatingAddressAddressOptional. The operating address of the business. Required when the address is of a registered agent (see Detecting Operating Address Required) or if any beneficial owner or officer is non-US.
phone RequiredPhonePhone of the business.
stateOfIncorporation RequiredstringTwo letters representing a US state.
ein RequiredstringBusiness EIN (numbers only).
website OptionalstringBusiness's website.
contact RequiredBusinessContactPrimary contact of the business.
officer RequiredOfficerOfficer representing the business (must be the CEO, COO, CFO, President, BenefitsAdministrationOfficer, CIO, VP, AVP, Treasurer, Secretary, Controller, Manager, Partner or Member). To successfully onboard a business, provide the officer's personal details.
beneficialOwners RequiredArray of BeneficialOwnerArray of beneficial owners in the business. A beneficial owner is anyone who owns at least 25% of the business. To successfully onboard a business, provide each beneficial owner's personal details. If the business has no beneficial owners, the array should be empty.
attestedNoBeneficialOwners Requiredbooleantrue if no beneficial owners are provided; otherwise - false .
ip OptionalstringIP address of the end-customer creating the application. Both IPv4 and IPv6 formats are supported. Highly recommended as a fraud prevention measure, if the information is available when submitting the application.
archived RequiredbooleanIndicates whether the application has been archived. Archived applications are read-only and no changes can be made to them. An application becomes archived once the corresponding customer is archived.
tags RequiredobjectSee Tags.
sourceOfFunds RequiredsourceOfFundsThe primary source of funds of the business.
sourceOfFundsDescriptionstringRequired if sourceOfFunds is one of GovernmentContractsOrGrants,DonationsOrFundraising,ImportExportRevenue.
businessIndustry RequiredbusinessIndustryThe industry of the business
businessDescription RequiredstringA brief description of the business, including its main products or services and the customers.
isRegulated RequiredbooleanIs the business regulated by a government agency or financial regulator?
regulatorNamestringRequired if isRegulated is true. The name of the regulator if the business is regulated.
usNexus Requiredarray of usNexusThe nature of the business's ties to the U.S. Either NotAvailable or one or more of the other options.
accountPurpose RequiredaccountPurposeThe primary purpose of the account.
accountPurposeDetailstringRequired if accountPurpose is one of CashHeavyIncomeAndOperations,ProfessionalServicesHandlingFunds,CharitableOrNonProfitOrganizationOperations,CommercialCashOperations,ThirdPartyPaymentProcessing.
transactionVolume RequiredtransactionVolumeThe expected monthly transaction volume of the business.
transactionVolumeDescriptionstringRequired when transactionVolume is $1,000,001 or higher. Further detail around transaction volume selection.
stockExchangeNamestringRequired if entityType is PubliclyTradedCorporation. The name of the stock exchange where the business's stock is traded.
stockSymbolstringRequired if entityType is PubliclyTradedCorporation. The stock symbol (ticker) of the business.
countriesOfOperation RequiredArray of ISO31661-Alpha2 strings
yearOfIncorporation RequiredYear stringYear of incorporation of the business.
isIncorporated RequiredbooleanIs the business incorporated.
entityType RequiredstringOne of LLC, Partnership, PubliclyTradedCorporation, PrivatelyHeldCorporation or NotForProfitOrganization, Estate, Trust,ForeignFinancialInstitution, DomesticFinancialInstitution, GovernmentEntityOrAgency, ReligiousOrganization, Charity.

Relationships

NameTypeDescription
documents OptionalArray of JSON:API RelationshipApplication's documents.
customer OptionalJSON:API RelationshipThe created Customer in case of approved application.
applicationForm OptionalJSON:API RelationshipThe ApplicationForm through which the application has been submitted.
Example BusinessApplication resource:
{
"type": "businessApplication",
"id": "50",
"attributes": {
"createdAt": "2020-01-13T16:01:19.346Z",
"name": "Pied Piper",
"dba": null,
"address": {
"street": "5230 Newell Rd",
"street2": null,
"city": "Palo Alto",
"state": "CA",
"postalCode": "94303",
"country": "US"
},
"phone": {
"countryCode": "1",
"number": "1555555578"
},
"stateOfIncorporation": "DE",
"ein": "123456789",
"entityType": "Corporation",
"contact": {
"fullName": {
"first": "Richard",
"last": "Hendricks"
},
"email": "richard@piedpiper.com",
"phone": {
"countryCode": "1",
"number": "1555555578"
}
},
"officer": {
"fullName": {
"first": "Richard",
"last": "Hendricks"
},
"ssn": "123456789",
"address": {
"street": "5230 Newell Rd",
"street2": null,
"city": "Palo Alto",
"state": "CA",
"postalCode": "94303",
"country": "US"
},
"dateOfBirth": "2001-08-10",
"email": "richard@piedpiper.com",
"phone": {
"countryCode": "1",
"number": "1555555589"
},
"occupation": "ArchitectOrEngineer",
"annualIncome": "Between10kAnd25k",
"sourceOfIncome": "EmploymentOrPayrollIncome",
"status": "Approved"
},
"beneficialOwners": [
{
"fullName": {
"first": "Richard",
"last": "Hendricks"
},
"ssn": "123456789",
"address": {
"street": "5230 Newell Rd",
"street2": null,
"city": "Palo Alto",
"state": "CA",
"postalCode": "94303",
"country": "US"
},
"dateOfBirth": "2001-08-10",
"phone": {
"countryCode": "1",
"number": "1555555589"
},
"email": "richard@piedpiper.com",
"occupation": "ArchitectOrEngineer",
"annualIncome": "Between10kAnd25k",
"sourceOfIncome": "EmploymentOrPayrollIncome",
"status": "Approved"
}
],
"isIncorporated": true,
"yearOfIncorporation": "2014",
"businessIndustry": "TechnologyMediaOrTelecom",
"accountPurpose": "RetailSalesInPerson",
"sourceOfFunds": "SalesOfGoods",
"transactionVolume": "Between1KAnd5K",
"usNexus": [
"NotAvailable"
],
"countriesOfOperation": [
"US",
"CA"
],
"isRegulated": false,
"website": "www.piedpiper.com",
"businessDescription": "We are a technology company that sells technology products to our customers.",
"tags": {
"userId": "106a75e9-de77-4e25-9561-faffe59d7814"
},
"archived": false,
"status": "AwaitingDocuments",
"message": "Waiting for you to upload the required documents."
},
"relationships": {
"org": {
"data": {
"type": "org",
"id": "1"
}
},
"documents": {
"data": [
{
"type": "document",
"id": "1"
},
{
"type": "document",
"id": "2"
},
{
"type": "document",
"id": "3"
}
]
},
"applicationForm": {
"data": {
"type": "applicationForm",
"id": "3"
}
}
}
}

BeneficialOwner

BeneficialOwner is a JSON:API resource, top-level fields:

NameTypeDescription
id RequiredstringIdentifier of the beneficial owner resource.
type RequiredstringAlways beneficialOwner.
attributes RequiredJSON ObjectJSON object representing the beneficial owner's data.

Attributes

NameTypeDescription
status RequiredstringOne of Approved, Denied or PendingReview.
fullName RequiredFullNameFull name of the beneficial owner.
ssnstringSSN of the beneficial owner (numbers only). One of ssn or passport is required.
passportstringPassport of the beneficial owner. One of ssn or passport is required.
nationalityISO31661-Alpha2 stringRequired if a passport is used as the main ID and optional when ssn is used. Two letters representing the beneficial owner's nationality. (e.g. "US").
dateOfBirth RequiredRFC3339 Date stringDate only (e.g. "2001-08-15").
address RequiredAddressThe beneficial owner's address.
phone RequiredPhoneThe beneficial owner's phone number.
email RequiredstringThe beneficial owner's email address.
Example BeneficialOwner resource:
{
"type": "beneficialOwner",
"id": "5",
"attributes": {
"address": {
"street": "20 Ingram St",
"street2": "Apt #10",
"city": "Forest Hills",
"state": "NY",
"postalCode": "11375",
"country": "US"
},
"dateOfBirth": "1990-04-05",
"email": "erlich@piedpiper.com",
"fullName": {
"first": "Erlich",
"last": "Bachman"
},
"phone": {
"countryCode": "1",
"number": "5555555555"
},
"ssn": "721074426",
"status": "Approved"
}
}

IndividualCustomer

IndividualCustomer is a JSON:API resource, top-level fields:

NameTypeDescription
id RequiredstringIdentifier of the customer resource.
type RequiredstringType of the customer resource. For individual customer the value is always individualCustomer.
attributes RequiredJSON ObjectJSON object representing the customer data.
relationships RequiredJSON:API RelationshipsDescribes relationships between the customer resource and other resources.

Attributes

NameTypeDescription
createdAt RequiredRFC3339 Date stringThe date the resource was created.
ssn RequiredstringSSN of the individual (numbers only). Either ssn or passport will be populated.
passport RequiredstringIndividual passport number. Either ssn or passport will be populated.
nationalityISO31661-Alpha2 stringRequired if a passport is used as the main ID and optional when ssn is used. Two letters representing the individual's nationality. (e.g. "US").
fullName RequiredFullNameFull name of the individual.
dateOfBirth RequiredRFC3339 Date stringDate only (e.g. "2001-08-15").
address RequiredAddressAddress of the individual.
phone RequiredPhonePhone of the individual.
email RequiredstringEmail address of the individual.
soleProprietorship OptionalbooleanIndicates whether the individual is a sole proprietor, if specified.
ein OptionalstringIndicates if the individual is a sole proprietor who has an Employer Identification Number, if specified.
dba OptionalstringIndicates if the individual is a sole proprietor who is doing business under a different name, if specified.
status RequiredstringStatus of the customer, either Active or Archived. You can't do any write operations on an Archived customer.
eligibleProducts OptionalArray of ProductThe products that the customer is eligible for.
authorizedUsers RequiredArray of AuthorizedUserArray of authorized users.
tags RequiredobjectSee Tags. Inherited from the application tags (see Tag Inheritance).
accountPurpose RequiredaccountPurposeThe primary purpose of the account.
accountPurposeDetailstringRequired if accountPurpose is one of Cryptocurrency,CashHeavyPersonalIncome,InternationalRemittances
sourceOfFunds RequiredsourceOfFundsThe primary source of funds. One of SalaryOrWages,BusinessIncome,InvestmentIncome,RetirementSavings,Inheritance,Gift,SaleOfAssets,LegalSettlement,LoanProceeds
transactionVolume RequiredtransactionVolumeThe expected monthly transaction volume. One of Between1KAnd5K,Between5KAnd15K,Between15KAnd30K,Between30KAnd60K,GreaterThan60K
transactionVolumeDescriptionstringRequired when transactionVolume is $30,001 or higher. Further detail around transaction volume selection.
profession RequiredprofessionThe occupation of the individual.
website OptionalstringA Valid website URL. Present when soleProprietorship is true.
sourceOfFundsDescriptionstringRequired if sourceOfFunds is one of GovernmentContractsOrGrants,DonationsOrFundraising,ImportExportRevenue. Present when soleProprietorship is true.
businessIndustry RequiredbusinessIndustryThe industry of the sole proprietor. Present when soleProprietorship is true.
businessDescription RequiredstringA brief description of the business, including its main products or services and the customers. Present when soleProprietorship is true.
isIncorporated RequiredbooleanIs the business incorporated. Present when soleProprietorship is true.
stateOfIncorporationstringRequired if isIncorporated is true. Two letters representing a US state. Present when soleProprietorship is true.
yearOfIncorporationYear stringRequired if isIncorporated is true. Year of incorporation of the business. Present when soleProprietorship is true.
countriesOfOperation RequiredArray of ISO31661-Alpha2 stringsPresent when soleProprietorship is true.
usNexus Requiredarray of usNexusThe nature of the business's ties to the U.S. Present when soleProprietorship is true.

Relationships

NameTypeDescription
org RequiredJSON:API RelationshipThe Org of the individual.
application RequiredJSON:API RelationshipThe Application that created this individual.
authorizedUserResources RequiredJSON:API RelationshipA list of the related AuthorizedUser.
Example IndividualCustomer resource:
{
"type": "individualCustomer",
"id": "8",
"attributes": {
"createdAt": "2020-05-12T19:41:04.123Z",
"fullName": {
"first": "Peter",
"last": "Parker"
},
"ssn": "721074426",
"address": {
"street": "20 Ingram St",
"street2": null,
"city": "Forest Hills",
"state": "NY",
"postalCode": "11375",
"country": "US"
},
"dateOfBirth": "2001-08-10",
"email": "peter@oscorp.com",
"phone": {
"countryCode": "1",
"number": "1555555578"
},
"status": "Active",
"soleProprietorship": false,
"accountPurpose": "PayrollOrDirectDeposit",
"sourceOfFunds": "SalaryOrWages",
"transactionVolume": "Between1KAnd5K",
"profession": "Farmer",
"eligibleProducts": [
"Banking",
"BillPay"
],
"tags": {
"userId": "106a75e9-de77-4e25-9561-faffe59d7814"
},
"authorizedUsers": [
{
"fullName": {
"first": "Erlich",
"last": "Backman"
},
"email": "erlich-backman@piedpiper.com",
"phone": {
"countryCode": "1",
"number": "1234567890"
},
"canConnectWithAuthVendor": true
},
{
"fullName": {
"first": "Nelson",
"last": "Bighetti"
},
"email": "nelson-bighetti@piedpiper.com",
"phone": {
"countryCode": "1",
"number": "1234567891"
},
"canConnectWithAuthVendor": false
}
]
},
"relationships": {
"org": {
"data": {
"type": "org",
"id": "1"
}
},
"application": {
"data": {
"type": "individualApplication",
"id": "8"
}
},
"authorizedUserResources": {
"data": [
{
"type": "authorizedUserResource",
"id": "1"
},
{
"type": "authorizedUserResource",
"id": "2"
}
]
}
}
}

See attribute descriptions above. When soleProprietorship is true, the resource includes sole-proprietor regulatory fields such as website, businessIndustry, and usNexus.

Example Sole Proprietorship IndividualCustomer resource:
{
"type": "individualCustomer",
"id": "9",
"attributes": {
"createdAt": "2020-05-12T19:41:04.123Z",
"fullName": {
"first": "Peter",
"last": "Parker"
},
"ssn": "721074426",
"address": {
"street": "20 Ingram St",
"street2": null,
"city": "Forest Hills",
"state": "NY",
"postalCode": "11375",
"country": "US"
},
"dateOfBirth": "2001-08-10",
"email": "peter@oscorp.com",
"phone": {
"countryCode": "1",
"number": "1555555578"
},
"status": "Active",
"soleProprietorship": true,
"ein": "123456789",
"dba": "Piedpiper Inc",
"website": "https://www.piedpiper.com",
"accountPurpose": "EcommerceSales",
"sourceOfFunds": "SalesOfServices",
"transactionVolume": "LessThan5K",
"usNexus": [
"NotAvailable"
],
"countriesOfOperation": [
"US",
"CA"
],
"isIncorporated": false,
"businessIndustry": "GroceryStoresOrSupermarkets",
"eligibleProducts": [
"Banking",
"BillPay"
],
"tags": {
"userId": "106a75e9-de77-4e25-9561-faffe59d7814"
}
},
"relationships": {
"org": {
"data": {
"type": "org",
"id": "1"
}
},
"application": {
"data": {
"type": "individualApplication",
"id": "54"
}
},
"authorizedUserResources": {
"data": []
}
}
}

BusinessCustomer

BusinessCustomer is a JSON:API resource, top-level fields:

NameTypeDescription
id RequiredstringIdentifier of the customer resource.
type RequiredstringType of the customer resource. For business customer the value is always businessCustomer.
attributes RequiredJSON ObjectJSON object representing the customer data.
relationships RequiredJSON:API RelationshipsDescribes relationships between the customer resource and other resources.

Attributes

NameTypeDescription
createdAt RequiredRFC3339 Date stringThe date the resource was created.
name RequiredstringName of the business.
dba Optionalstring"Doing business as".
address RequiredAddressAddress of the business.
operatingAddress OptionalAddressThe operating address of the business.
phone RequiredPhonePhone of the business.
stateOfIncorporation RequiredstringTwo letters representing a US state.
ein RequiredstringBusiness EIN (numbers only).
website OptionalstringBusiness's website.
contact RequiredBusinessContactPrimary contact of the business.
authorizedUsers RequiredArray of AuthorizedUserArray of authorized users.
status RequiredstringStatus of the customer, either Active or Archived. You can't do any write operations on an Archived customer.
eligibleProducts OptionalArray of ProductThe products that the customer is eligible for.
tags RequiredobjectSee Tags. Inherited from the application tags (see Tag Inheritance).
sourceOfFunds RequiredsourceOfFundsThe primary source of funds of the business.
sourceOfFundsDescriptionstringRequired if sourceOfFunds is one of GovernmentContractsOrGrants,DonationsOrFundraising,ImportExportRevenue.
businessIndustry RequiredbusinessIndustryThe industry of the business.
businessDescription RequiredstringA brief description of the business, including its main products or services and the customers.
isRegulated RequiredbooleanIs the business regulated by a government agency or financial regulator?
regulatorNamestringRequired if isRegulated is true. The name of the regulator if the business is regulated.
usNexus Requiredarray of usNexusThe nature of the business's ties to the U.S. Either NotAvailable or one or more of the other options.
accountPurpose RequiredaccountPurposeThe primary purpose of the account.
accountPurposeDetailstringRequired if accountPurpose is one of CashHeavyIncomeAndOperations,ProfessionalServicesHandlingFunds,CharitableOrNonProfitOrganizationOperations,CommercialCashOperations,ThirdPartyPaymentProcessing.
transactionVolume RequiredtransactionVolumeThe expected monthly transaction volume of the business.
transactionVolumeDescriptionstringRequired when transactionVolume is $1,000,001 or higher. Further detail around transaction volume selection.
stockExchangeNamestringRequired if entityType is PubliclyTradedCorporation. The name of the stock exchange where the business's stock is traded.
stockSymbolstringRequired if entityType is PubliclyTradedCorporation. The stock symbol (ticker) of the business.
countriesOfOperation RequiredArray of ISO31661-Alpha2 strings
yearOfIncorporation RequiredYear stringYear of incorporation of the business.
isIncorporated RequiredbooleanIs the business incorporated.
entityType RequiredstringOne of LLC, Partnership, PubliclyTradedCorporation, PrivatelyHeldCorporation or NotForProfitOrganization, Estate, Trust,ForeignFinancialInstitution, DomesticFinancialInstitution, GovernmentEntityOrAgency, ReligiousOrganization, Charity.

Relationships

NameTypeDescription
org RequiredJSON:API RelationshipThe Org of the business.
application RequiredJSON:API RelationshipThe Application that created this business.
authorizedUserResources RequiredJSON:API RelationshipA list of the related AuthorizedUser.
officer RequiredOptional, JSON:API RelationshipThe related Officer resource for this business customer.
beneficialOwners RequiredOptional, array of JSON:API RelationshipThe related BeneficialOwner resources for this business customer.
Example BusinessCustomer resource:
{
"type": "businessCustomer",
"id": "1",
"attributes": {
"createdAt": "2020-05-10T12:28:37.698Z",
"name": "Pied Piper",
"address": {
"street": "5230 Newell Rd",
"street2": null,
"city": "Palo Alto",
"state": "CA",
"postalCode": "94303",
"country": "US"
},
"phone": {
"countryCode": "1",
"number": "1555555578"
},
"stateOfIncorporation": "DE",
"ein": "123456789",
"entityType": "Corporation",
"contact": {
"fullName": {
"first": "Richard",
"last": "Hendricks"
},
"email": "richard@piedpiper.com",
"phone": {
"countryCode": "1",
"number": "1555555578"
}
},
"authorizedUsers": [
{
"fullName": {
"first": "Jared",
"last": "Dunn"
},
"email": "jared@piedpiper.com",
"phone": {
"countryCode": "1",
"number": "1555555590"
},
"canConnectWithAuthVendor": true
},
{
"fullName": {
"first": "Nelson",
"last": "Bighetti"
},
"email": "nelson-bighetti@piedpiper.com",
"phone": {
"countryCode": "1",
"number": "1234567891"
},
"canConnectWithAuthVendor": true
}
],
"isIncorporated": true,
"yearOfIncorporation": "2014",
"businessIndustry": "TechnologyMediaOrTelecom",
"accountPurpose": "RetailSalesInPerson",
"sourceOfFunds": "SalesOfGoods",
"transactionVolume": "Between1KAnd5K",
"usNexus": [
"NotAvailable"
],
"countriesOfOperation": [
"US",
"CA"
],
"isRegulated": false,
"website": "www.piedpiper.com",
"businessDescription": "We are a technology company that sells technology products to our customers.",
"status": "Active",
"eligibleProducts": [
"Banking",
"BillPay"
],
"tags": {
"userId": "106a75e9-de77-4e25-9561-faffe59d7814"
}
},
"relationships": {
"org": {
"data": {
"type": "org",
"id": "1"
}
},
"application": {
"data": {
"type": "businessApplication",
"id": "1"
}
},
"authorizedUserResources": {
"data": [
{
"type": "authorizedUserResource",
"id": "1"
},
{
"type": "authorizedUserResource",
"id": "2"
}
]
}
}
}