Elavon downloads and stores cookies on your device when you visit our website. We use these cookies to better understand and improve your browsing experience by identifying most visited pages, personalising content, and measuring site performance.

Essential cookies enable core functionality such as page navigation and access to secure areas. The website cannot function properly without these cookies; they can only be disabled by changing your browser preferences.

Performance cookies help us to improve our website by collecting and reporting information on its usage (for example, which of our pages are most frequently visited).

These cookies and similar technologies gather information about your browsing habits. They remember that you've visited a website and share this information with other organisations, such as advertisers and platforms on which we advertise.
They do this in order to provide you with ads that are more relevant to you and your interests. Although these cookies and similar technologies can track your visits to other websites, they don't usually know who you are.
Without these cookies, online advertisements you encounter will be less relevant to you and your interests.


Cookie Settings

Elavon Financial Services DAC. Registered in Ireland – Number 418442.
Registered Office: Block F1, Cherrywood Business Park, Dublin 18, D18 W2X7, Ireland.
Elavon Financial Services DAC, trading as Elavon Merchant Services, is regulated by the Central Bank of Ireland.
 
Elavon Financial Services DAC. Registered in Ireland with Companies Registration Office. The liability of the member is limited. United Kingdom branch registered in England and Wales under the number BR022122.
Elavon Financial Services DAC, trading as Elavon Merchant Services, is a credit institution authorised and regulated by the Central Bank of Ireland.  Authorised by the Prudential Regulation Authority.  Subject to regulation by the Financial Conduct Authority and limited regulation by the Prudential Regulation Authority.  Details about the extent of our regulation by the Prudential Regulation Authority are available from us on request.

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. **"D**oing **B**usiness **A**s" 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 :magic-link[ ownership type table]{id="element-code-tables" anchor="ownership-type-businessinfoownershiptype"} for rules on how to set up specific ownership types. |
| mccCode | Required. **"M**erchant **C**ategory **C**ode" is a code assigned by credit card companies to categorize similar types of businesses/services. Refer to the :magic-link[Merchant Category Codes]{id="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 :magic-link[list of languages]{id="element-code-tables" anchor="language"}. |
| posLanguage | Required. Language for equipment displays, ISO 639-1 standard applies. Populated from a :magic-link[list of languages]{id="element-code-tables" anchor="language"}. |
| 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 :magic-link[list of tax class types]{id="element-code-tables" anchor="taxclasstype"}. |
| taxIDType | Optional. Type of tax identification provided. Populated from a :magic-link[list of tax ID types]{id="element-code-tables" anchor="taxidtype"}. 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 :magic-link[list of tax forms]{id="element-code-tables" anchor="taxformtype"}. 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 :magic-link[list of exemptions]{id="element-code-tables" anchor="exemptiontype"}. |
| ownerExemptionType | Required. This field represents beneficial ownership exemption statuses. Populated from a :magic-link[list of exempted owners]{id="element-code-tables" anchor="ownerexemptiontype"}. |

**businessAddress** and **additionalAddresses** - Follow the same content form as the general address type used in :magic-link[principal]{id="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. 

:::::notice{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 :magic-link[list of document types]{id="element-code-tables" anchor="businessinfo-additional-properties"} 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 :magic-link[list of states, territories, and provinces]{id="element-code-tables" anchor="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 :magic-link[list of locations]{id="element-code-tables" anchor="locationtype"}. |
| 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

businessInfo

Alliance Offers

Data as a Service

Invitation to Apply

Accounts

Bank Holidays

Card Activation

Card Controls

Commercial Credit Cards

Credit Card Account Details

Credit Card Accounts Overview

Credit Card Alerts

Credit Card Application Status

Credit Card APRs

Credit Card Payments

Credit Card Qualified Offers

Credit Card Statements

Credit Card Transactions

Data Sharing for Marketing Purposes

Digital Wallets

Make a Payment - Coming Soon

Rewards Accelerator

Rewards Automatic Redemption

Rewards Balance Summary

Rewards Redemption Coming Soon

Rewards Redemption Accounts

Rewards Redemptions

Rewards Transactions Earned and Redeemed

Travel Notifications

User Profile

3DSecure2

Avvance

CheckoutJs

Commerce SDK

Converge

Disputes Management

Dynamic Currency Conversion

eBoarding

Elavon Cloud Payments Interface

Fusebox

Hosted Payment Page

In Person Payments on Opayo

Leads

Lightbox payment modal

Online Payments on Opayo

Opayo

Opayo Direct

Opayo Forms

Opayo Reporting API

Opayo Server

Opayo Shared API

Payment Method Gateway

Payments Core 365

Simplify

viaconex

XML API

Access Online Transactions

Account Transfers

Account Validation

ACH Originations

Bank Information

Card as a Service

Card as a Service API

Check Payables

Core Banking API

Corporate Account Information

Corporate Credit Cards

Corporate Onboarding

Corporate Statements

Custody

Data Toolbox

Data Toolbox - Accounts

Data Toolbox - Documents

Data Toolbox - Transactions

Disbursements via Zelle

U.S. Bank Flexible Capital Platform

Freight Payment Customer Profiles

Freight Payment Transactions

Instant payments

Investment Accounting

Money Movement API

PaySmart

Payee Choice

Payee Token+

Personal Loans

Positive Pay

Push to Card

Receivables

Reference API

RTP® - Real-Time Payments

Tokenized Payments

Treasury Builder

U.S. Bank FBO Account

Virtual Account Reporting

Virtual Card Payments

Voyager Accounts

Voyager Cards

Voyager Drivers

Voyager Transactions

Voyager Vehicles

Wire Transfers

eBoarding Partner API Overview

Integration by flow type

Prerequisites and tools

Boarding process workflows

Main boarding elements

Passing data to board

Principal applicant

Additional shareholders

Contact information

Financial information

Card pricing

Bank account information

Billing

Fees

Payment processing equipment

Dynamic currency conversion (DCC)

Value added services

Third-party signing

Complementary API calls

API reference

Element code tables

Merchant category codes

Boarding timeouts

Push notifications

Best practices

Release notes

2024

2023

2022

2021

2020