Entity Onboarding is how you bring a business onto the Priority Commerce Engine (PCE) programmatically. Instead of a portal form or a spreadsheet handed to an operations team, you send one API call that describes the business — its legal details, the people who own and sign for it, its bank accounts, its physical locations, and the services it wants to use — and PCE creates the whole entity graph and starts it down the underwriting path.

This is the first step before any money moves. A business must exist and be approved on PCE before it can accept a payment. Entity Onboarding is where that business is created.

What you can do

How onboarding works

1. Create the business. POST /v1/businesses accepts the full nested graph in one request. You can start with just a legal name and fill in the rest later, or send everything at once. See Create a business.
2. Add the people. Every business needs its beneficial owners and authorized signatories, with exactly one person marked as the control person. People are modelled as shared Individuals that you link into the business.
3. Add bank accounts, addresses, and locations. A funding bank account, a registered address, and at least one location with its processing profile are what acquiring underwriting needs.
4. Enable a service. Onboarding for payments means enabling the acquiring service (and any features it needs). PCE surfaces what's still missing on the service object itself.
5. Underwriting decides. Once requirements are complete, the entity moves to PENDING_UNDERWRITING, then to ACTIVE when approved. Track it with statuses.

Where this fits

Onboarding creates the merchant that then uses the rest of PCE. Once a business is ACTIVE with the acquiring service approved, it can begin accepting payments.