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 the same as dbaName. |
| legalName | Required. The legal name of the business entity. |
| legalNameExtended | Required. Longer version of the business entity’s legal name. May be the same as legalName. |
| ownershipType | Required. The method of ownership for the business. Populated from a list of ownership types. See the ownership type table for rules on how to set up specific ownership types. |
| mccCode | Required. “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. |
| establishmentYear | Required. The year the business was established. |
| currentOwnershipYears | Required. 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. |
| currentOwnershipMonths | Required. 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. |
| communicationLanguage | Required. The language for communications. Populated from a list of languages. |
| posLanguage | Required. Language for equipment displays, ISO 639-1 standard applies. Populated from a list of languages. |
| bearerShares | Optional. 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. |
| legalStatus | Required. 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). |
| 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. Employer Identification Number (EIN) of the business. |
| taxClassType | Required when ownershipType is LIMITED_COMPANY. Tax classification of the company. Populated from a list of tax class types. |
| taxIDType | Optional. Type of tax identification provided. Populated from a list of tax ID types. Defaults to Federal Tax Id if no value is 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 of tax forms. Defaults to W9 if no value is 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 of exemptions. |
| ownerExemptionType | Required. This field represents beneficial ownership exemption statuses. Populated from a list of exempted owners. |
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.
note
Not required for CIP Exemption (i.e. exemptionType or documentary is No).
| Element | Description |
|---|---|
| documentary | Required. 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. |
| documentType | Required if documentary is yes. The type of document provided. Populated from a list of document types under businessInfo Additional Properties. |
| issuingCountry | Required if documentary is yes. Country of issuance. Use ISO 3166-1 alpha-3 standard (3 letter country code). |
| issuingState | Optional. State/Province of issuance. Populated from a list of states, territories, and provinces. |
| idNumber | Required if documentary is yes. The identification number of the document provided. |
| expiryDate/issueDate | |
| year | Required if documentary is yes. The year the ID defined above expires/was issued. |
| month | Required if documentary is yes. The month the ID defined above expires/was issued. The month is encoded using the first three letters of the month. |
| day | Required if documentary is yes. 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 a site visit, this is ‘true’ and locationType is included. |
| locationType | Optional. Type of location. Populated from a list of locations. |
| 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. |
hempGrowerInfo - Required of businesses that fall under the business type of Hemp/CBD (Merchant Category Code 5912E).
Validation questions for U.S. businesses:
- US Licensed Hemp Grower Operations: Required. Free form field with a maximum length of 200 characters describing the business.
- Does the customer have a US Hemp Grower License: Required. Boolean flag (“Yes” = true, “No” = false).
- If “Yes” is selected, then ask for Issue date and Expiration date (only the latter is mandatory).
- If “No” is selected, hide these fields.
- Does the customer engage in marijuana related (MRB) activity outside of the licensed hemp growing activity: Required. Boolean flag (“Yes” = true, “No” = false).
Validation question for Canadian businesses: If the business falls under one of the following sub-MCCs, then they are required to answer the question, what percentage of the business revenue comes from cannabis/hemp?
List of sub-MCCs
62
71
72
73
80
81
82
89
90
91
92
113
114
115
116
117
118
125
126
127
131
242
244
245
246
248
250
251
252
707
755
756
757
762
763
766
767
867
870
871
920
921
962
1136
1176
1218
1220
1249
1250
1251
4098
4188
4364
4367
4375
4381
4383
4396
4397
4400
4413
4414
4415
4416
4425
4426
4427
4484
4491
4492
4707
4709
4716
4718
4719
4721
4777
5359
5360
5361
5537
5674
5677
5678
5680
5693
5694
5695
5696
5811
5812
5814
5815
5817
5936
5937
5979
5985
5992
6400
6408
6409
6423
7004
7005
7006
7007
7008
7009
7027
7028
7056
What percentage of the business revenue is derived from Canadian Cannabis/Hemp Companies?“ Enumerated values are:
- NONE
- ONE_TO_TEN
- ELEVEN_TO_TWENTY
- TWENTY_ONE_TO_THIRTY
- THIRTY_ONE_TO_FORTY
- FORTY_ONE_TO_FIFTY
- MORE_THAN_FIFTY