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, 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.

Resources and Endpoints

Everything in one view: what each resource is, where it lives, and the id prefix PCE returns for it.

Resource	What it is	Path	Id Prefix
Business	The legal entity	`/v1/businesses/{businessId}`	`bus_`
Individual	A person you can reuse across businesses	`/v1/individuals/{individualId}`	`ind_`
Owner	Links an Individual to a business as a beneficial owner	`…/{businessId}/owners`	`own_`
Signatory	Links an Individual to a business as an authorized signer	`…/{businessId}/signatories`	`sig_`
Bank account	An account for receiving funds or paying fee	`…/{businessId}/bank-accounts`	`ba_`
Address	A registered, mailing, physical or headquarters address	`…/{businessId}/addresses`	`addr_`
Location	A place where the business accepts payments, with its own MID	`…/{businessId}/locations`	`loc_`
Services and features	Capabilities the business turns on, such as Accept Payments etc.	`…/{businessId}/services`	(none)
Documents	Files the business needs, such as the merchant agreement	`…{businessId}/documents` Note: Use `/v1/documents` to hold documents you reuse across businesses, such as the merchant agreement. Attach one to a business by sending its ID in documents when you create or update the business.	`doc_`

Note: in above endpoints, ... is /v1/businesses/

Next Steps

Create a business with everything underwriting needs. Check the rules for each business type.

Create a Business

Create the business and, optionally, its owners, bank accounts, addresses, locations, and services in one request.

Owners & Signatories

Add the beneficial owners and authorized signers, each backed by a shared Individual.

Businesses

What a business includes

Resources and Endpoints

Next Steps

See also