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.

ElementDescription
dbaNameRequired. “Doing Business As“ Name or Trading Name.
dbaNameExtendedRequired. Extended version of dbaName. May be the same as dbaName.
legalNameRequired. The legal name of the business entity.
legalNameExtendedRequired. Longer version of the business entity’s legal name. May be the same as legalName.
ownershipTypeRequired. The method of ownership for the business including Sole Owner.
Populated from a list of ownership types in the business info table.
mccCodeRequired. “Merchant Category Code“ is a code assigned by credit card companies to categorize similar types of businesses/services.
Refer to the Merchant Category Codes list.
establishmentYearRequired. The year the business was established.
currentOwnershipYearsRequired. How long current owners have owned the business, in years.
Note: Combine currentOwnershipYears and currentOwnershipMonths to define how long the current owners have owned the business.
currentOwnershipMonthsRequired. How long current owners have owned the business, in months.
Note: Combine currentOwnershipYears and currentOwnershipMonths to define how long the current owners have owned the business.
communicationLanguageRequired. The language for communications.
Populated from a list of languages.
posLanguageRequired. Language for equipment displays, ISO 639-1 standard applies.
Populated from a list of languages.
bearerSharesOptional. Describes if the business issues bearer shares. If it’s a U.S. business, this can default to “no.”
Boolean true if yes, false for no.
legalStatusRequired. This field describes the type of document being used for evidence of legal status.
Note: The legalStatus field is not required if the business is CIP-exempt (must be selected in exemptionType) and the business has been owned for more than a year (currentOwnershipYears is greater than 1).
countryOfOriginRequired. Country in which the business headquarters resides.
Use ISO 3166-1 alpha-3 standard (3 letter country code).
countryOfPrimaryOperationRequired. Business country of primary operation.
Use ISO 3166-1 alpha-3 standard (3 letter country code).
employerIdOptional. Employer Identification Number (EIN) of the business.
taxClassTypeRequired when ownershipType is LIMITED_COMPANY. Tax classification of the company.
Populated from the list of tax class types in the business info table.
taxIDTypeOptional. Type of tax identification provided. Populated from a list of tax ID types in the business info table.
Defaults to Federal Tax Id if no value is passed.
taxIdRequired. 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.
taxFormTypeOptional. Type of tax form from which identification is provided.
Populated from a list of tax forms in the business info table.
Defaults to W9 if no value is passed.
productDescriptionRequired. A description of the products or services offered.
optOutOptional. 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.
exemptionTypeOptional. Denotes a customer who qualifies for an exemption from the Anti-Money Laundering (AML) Customer Identification Program.
Populated from a list of exemptions in the business info table.
ownerExemptionTypeRequired. This field represents beneficial ownership exemption statuses.
Populated from a list of owner exemption types in the business info table.

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 the documentary field. Verification is required if monthlyCardSales is equal to or greater than $200,000.

note

Not required for CIP Exemption (i.e.exemptionType or documentary is No).

ElementDescription
documentaryRequired. This element describes if documentary information 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.
documentTypeRequired if documentary is yes. The type of document provided.
Populated from a list of document types in the business info table.
issuingCountryRequired if documentary is yes. Country of issuance. Use ISO 3166-1 alpha-3 standard (3 letter country code).
issuingStateOptional. State/Province of issuance.
Populated from a list of states, territories, and provinces.
idNumberRequired if documentary is yes. The identification number of the document provided.
expiryDate/issueDate
yearRequired if documentary is yes. The year the ID defined above expires/was issued.
monthRequired if documentary is yes. The month the ID defined above expires/was issued.
Populated from a list of months.
dayRequired if documentary is yes. The day the ID defined above expires/was issued.
siteSurvey - Version of documentary validation
siteSurveyConductedOptional. Has a survey occurred?
Boolean true if yes, false if no.
If business verification details are given regarding a site visit, this is ‘true’ and locationType is included.
locationTypeOptional. Type of location.
Populated from a list of location types in the business info table.
sitePersonMetRequired if a site survey was conducted. Name of person met with on site.
siteVisitDateRequired if a site survey was conducted. Date of visit.