Handle webhooks

Last updated: December 24, 2025

Before you onboard your sub-entities, configure your webhook server to receive all necessary notifications throughout the onboarding process.

Subscribe to the following webhooks:

Webhook	Description
Sub-entity created	Occurs when a sub-entity is successfully created.
VMSS passed	Occurs when a sub-entity passes due diligence Visa Merchant Screening Service (VMSS) checks.
VMSS failed	Occurs when a sub-entity fails due diligence VMSS checks.
Match passed	Occurs when a sub-entity passes its MATCH check.
Match failed	Occurs when a sub-entity fails its MATCH check.
Payments enabled	Occurs when the sub-entity passes the CSS checks (VMSS and Match) and its payment capabilities are enabled.
Payments disabled	Occurs when payment capabilities are disabled for a sub-entity.
Status changed	Occurs when the status of a sub-entity changes.

Webhook	Description
Sub-entity created	Occurs when a sub-entity is successfully created.
Full DD passed	Occurs when a sub-entity passes its full due diligence checks.
Full DD failed	Occurs when a sub-entity fails its full due diligence checks.
Payouts enabled	Occurs when payout capabilities are enabled for a sub-entity.
Payouts disabled	Occurs when payout capabilities are disabled for a sub-entity.
Payments enabled	Occurs when the sub-entity passes the CSS checks (VMSS and Match) and its payment capabilities are enabled.
Payments disabled	Occurs when payment capabilities are disabled for a sub-entity.
Status changed	Occurs when the status of a sub-entity changes.

The sub-entity status also changes as the process progresses.

Information

For all possible statuses, see Sub-entity status.

You can receive the following sub-entity statuses and webhooks during the onboarding process:

Information

If you update an entity's legal_name, trading_name, or profile.urls later, Checkout.com runs the verification checks again. If any subsequent checks fail, we send the relevant VMSS failed or Match failed webhook, followed by the Payments disabled webhook.