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 in the business info additional properties table. |
| taxIDType | Optional. Type of tax identification provided. Populated from a list of tax ID types in the business info additional properties table. 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 in the business info additional properties table. 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 in the business info additional properties table. |
| ownerExemptionType | Required. This field represents beneficial ownership exemption statuses. Populated from a list of owner exemption types in the business info additional properties 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.
error_outline
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 in the business info additional properties table. |
| 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 location types in the business info additional properties table. |
| 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