# Merchant Onboarding

Create, manage, verify, and activate merchants using hosted or API-based onboarding.

Merchant Onboarding enables platforms to create, manage, verify, and activate merchants through either:

- Hosted Merchant Onboarding (Blaze)
- Merchant Onboarding APIs


Merchant onboarding is the process of collecting the information required to establish a merchant account, validate business and ownership details, configure payment processing, and prepare the merchant to accept payments.

Depending on your integration model, onboarding workflows can include:

- Business setup
- Business classification
- Ownership collection
- Identity verification
- Banking setup
- Consent collection
- Merchant activation


### Merchant Onboarding Options

#### Hosted Merchant Onboarding

Best for:

- Faster implementation
- Minimal onboarding development
- Deluxe-managed merchant experience


Hosted onboarding uses onboarding templates, predefined workflows, fee disclosures, and merchant acceptance experiences configured through Blaze onboarding.

#### API Merchant Onboarding

Best for:

- Embedded platform experiences
- White-label onboarding
- Custom merchant workflows


The Merchant Onboarding APIs provide application management, classification services, identity verification, acceptance handling, and merchant submission workflows.

### Platform Responsibilities

Regardless of onboarding model, platforms are responsible for:

| Responsibility | Required |
|  --- | --- |
| Merchant tracking | Yes |
| Merchant identification mapping | Yes |
| Webhook processing | Yes |
| Merchant status management | Yes |
| Merchant support workflows | Yes |
| Audit history retention | Recommended |


### Merchant Onboarding Lifecycle

Merchant onboarding progresses through several stages before a merchant becomes active.

The merchant onboarding journey shows how onboarding moves from customer setup through application and verification, application submission, and review and enablement on the ISV platform. Merchant webhooks provide onboarding status updates to the ISV platform throughout the process, and the completed journey results in the merchant being enabled for payment processing.

**Configure Onboarding Setup**
Use the Template APIs to configure the onboarding templates required for the merchant onboarding process.

**Complete Application and Verification**
Use the Application APIs and Classification APIs to collect application information and complete identity verification.

**Submit Application**
Use the Rates & Fees APIs and Classification APIs to complete the required application details and submit the merchant application.

**Review and Enable Merchant**
Complete the boarding review to determine whether the merchant can be enabled for payment processing.

**Enable Merchant**
After the onboarding requirements are successfully completed, the ISV platform enables the merchant for payment processing.

**Merchant Webhooks**
Onboarding status updates are delivered to the ISV platform through merchant webhooks, including `Merchant Boarded`, `Merchant Updated`, and `Merchant Status Changes`.

### Platform-Specific Considerations

#### Merchant Identifier Management

Store all platform merchant identifiers and Deluxe merchant identifiers.

This enables proper routing of:

- Merchant Updated events
- Merchant Boarded events
- Merchant status changes


Supported merchant onboarding webhooks include:

- Merchant Updated
- Merchant Boarded


See [**Webhooks**](/products/merchant-services/platforms/platform-services/webhooks) for additional information about merchant lifecycle events and webhook processing.

#### Compliance Requirements

For API-based onboarding experiences, merchants must be presented:

- Rates and fees
- Acceptance language
- Terms and conditions


Leadership certification requirements require that rates, fees, terms, and acceptance language be visible to merchants without requiring additional clicks or expanded menus.

The onboarding experience must provide an auditable acceptance experience.

### Ready to Implement?

Implement Merchant Onboarding
Build a custom merchant onboarding experience using the Merchant Onboarding APIs.

Webhooks
Process Merchant Updated and Merchant Boarded events within your platform.

Merchant Onboarding API
Review endpoints, schemas, objects, and API operations.