A business is the company you onboard for one of your merchants, such as an LLC or a sole proprietor. To approve it, Priority needs to know who owns and runs it, where it operates, where it gets paid and which services it wants. Each of those is a separate part of the business, and you manage each part with its own endpoint.

What a business includes

graph LR
    B([Business])

    B --- PEOPLE[People]
    B --- OPER_STRU[Operating structure]
    B --- BANK[Bank accounts]
    B --- SVC[Services and features]
    B --- AGREE[Documents]

    PEOPLE --- OWN[Owners]
    PEOPLE --- SIG[Signatories]
    OPER_STRU --- ADDR[Addresses]
    OPER_STRU --- LOC[Locations]
    AGREE --- AGR[Agreements]
    AGREE --- SUP[Supporting documents]

    OWN -.- IND([Individual<br/>shared and reusable])
    SIG -.- IND

    classDef business fill:#003E29,stroke:#01271A,color:#FFFFFF,font-weight:bold
    classDef label fill:none,stroke:none,color:#003E29,font-weight:bold
    classDef item fill:#FFFFFF,stroke:#003E29,color:#01271A
    classDef shared fill:#E7E5AA,stroke:#003E29,color:#01271A

    class B business
    class PEOPLE,OPER_STRU,AGREE label
    class OWN,SIG,ADDR,LOC,BANK,SVC,AGR,SUP item
    class IND shared

Owners and signatories each point to an individual. You create a person once and can link them to any business.

Parts and endpoints

Each part is a separate resource with its own endpoint and typed id.

Part	What it is	Endpoint	ID prefix
Business	The legal entity you onboard.	`/v1/businesses/{businessId}`	`bus_`
Owners and signatories	An owner owns part of the business; a signatory can sign for it. Each links to an individual, and one is the control person who runs it, such as the CEO.	`.../owners`, `.../signatories`	`own_`, `sig_`
Individuals	A person that owners and signatories link to.	`/v1/individuals/{individualId}`	`ind_`
Bank accounts	An account for receiving funds or paying fees.	`.../bank-accounts`	`ba_`
Addresses	A registered, mailing, physical or headquarters address.	`.../addresses`	`addr_`
Locations	A place where the business accepts payments, each with its own merchant ID (MID) for processing card payments.	`.../locations`	`loc_`
Services	Something the business turns on, such as Accept Payments. Each service lists what it still needs.	`.../services`	None
Documents	Files the business needs, such as the merchant agreement.	`.../documents`, and `/v1/documents` for your library	None

📘 Base path shorthand

In the table, ... is shorthand for the business base path /v1/businesses/{businessId}. For example, .../owners is /v1/businesses/{businessId}/owners.

Next steps

Create a business

Create a business with everything underwriting needs.

Business validation and KYB rules

Check the rules for each business type.

Businesses

What a business includes

Parts and endpoints

Next steps

See also