businessInfo

Defines the name, location, and establishment date of the merchant's business.

businessInfo elements

The general elements to the businessInfo section aid in creating an expansive view of the applying business' functionality. Establishing when the business was created, when the current ownership took over, and product description allows the approval process for new businesses to be streamlined and informed.

Top Level - Various identifiers regarding the business' properties.

For data examples, refer to the API Reference.

Element Description
dbaName Required. "Doing Business As" Name or Trading Name
dbaNameExtended Required. Extended version of dbaName. May be same as dbaName
legalName Required. The legal name of the business entity
legalNameExtended Required. Extended version of legalNameExtended. May be same as legalName
ownershipType Required. The method of ownership for the business including Sole Owner.
Populated from a list
mccCode Required. "Merchant Category Code" is a code assigned by credit card companies.
Populated from a list
establishmentYear Required. The year the business was established
currentOwnershipYears Required. How long current owners have owned the business, years element.
**Combine currentOwnershipYears and currentOwnershipMonths to define how long the current owners have owned the business
currentOwnershipMonths Required. How long current owners have owned the business, months element.
**Note:Combine currentOwnershipYears and currentOwnershipMonths to define how long the current owners have owned the business
communicationLanguage Required. The language for communications.
Populated from a list
posLanguage Required. Language for equipment displays, ISO 639-1 standard applies.
Populated from a list
bearerShares Optional. Describes if the business issues bearer shares. If US business, this can default to 'no'
Boolean true if yes, false for no
legalStatus Required. Enum describing document for evidence of legal status.
Populated from a list
**Note:legalStatus is not required if business is CIP-exempt (exemptionType selected) and business "currentOwnershipYears" is greater than than 1
countryOfOrigin Required. Country in which the business headquarters resides.
Use ISO 3166-1 alpha-3 standard (3 letter country code)
countryOfPrimaryOperation Required. Business country of primary operation.
Use ISO 3166-1 alpha-3 standard (3 letter country code)
employerId Optional. EIN of employer
taxClassType Required.* Tax classification of the company.
Populated from a list
**Required when ownershipType is LIMITED\COMPANY
taxIDType Optional. Type of tax identification provided. Populated from a list
Defaults to Federal Tax Id if no value passed
taxId Required. Tax ID of the operating businesses. For testing a valid taxId, use format 78742xxxx where 'xxxx' represents a series of four random, non-repeating, non-sequential numbers.
taxFormType Optional. Type of tax form from which identification is provided.
Populated from a list
Defaults to W9 if no value passed
productDescription Required. A description of the products or services offered
optOut Optional. Flag to set if customer opts out of marketing communications.
**Note:Boolean true if they opt out, false or not sent if they don't
exemptionType Optional. Denotes a customer who qualifies for an exemption from the Anti-Money Laundering (AML) Customer Identification Program.
Populated from a list
ownerExemptionType Required. Enum representing beneficial ownership exemption statuses.
Populated from a list

businessAddress and additionalAddresses - Follow the same content form as the general address type used in principal .

additionalAddresses operates as a map with available enum key values:

  • LEGAL (required)
  • SHIPPING
  • MAILING

verifications - Verification of the business. Elements required only if no CIP Exemption (exemptionType) is chosen or "Documentary" is sent in "documentary" field. Verification is required if monthlyCardSales is equal to or greater than $200,000

error_outline
note

Not required for CIP Exemption (exemptionType or documentary = No)

Element Description
documentary Required. This element describes if documentary infomation is given. Boolean true if yes, false if no.
**Note:Makes document-related fields required if true. Site survey can be conducted as an alternative, in which case the value should be false and site fields given
documentType Required.* The type of document provided.
Populated from a list
issuingCountry Required.* Country of issuance.
Use ISO 3166-1 alpha-3 standard (3 letter country code)
issuingState Optional. State/Province of issuance.
Populated from a list
idNumber Required*. The identification number of the document provided
expiryDate/issueDate
year Required*. The year the ID defined above expires/was issued
month Required*. The month the ID defined above expires/was issued.
Populated from a list
day Required*. The day the ID defined above expires/was issued
siteSurvey - Version of documentary validation
siteSurveyConducted Optional. Has a survey occurred?
Boolean true if yes, false if no
If business verification details are given regarding site visit, this is 'true' and locationType is included
locationType Optional. Type of location.
Populated from a list
sitePersonMet Required if a site survey was conducted. Name of person met with on site.
siteVisitDate Required if a site survey was conducted. Date of visit.