Sell Events

This page documents the webhook events and payload fields relevant to Entri Sell. For the payload envelope and signature verification, see Webhooks Overview.

Webhook event types

"domain.purchased": Indicates that the domain order creation has been completed.
"domain.transfer.in.initiated": Only applicable for Entri Sell Enterprise. An inbound domain transfer has been initiated by the user.
"domain.transfer.in.started": Only applicable for Entri Sell Enterprise. The inbound domain transfer has been accepted and is now in progress at the registry level.
"domain.transfer.in.ack": Only applicable for Entri Sell Enterprise. The inbound domain transfer has been acknowledged by the registry.
"domain.transfer.in.failed": Only applicable for Entri Sell Enterprise. The inbound domain transfer has failed.
"domain.transfer.out.initiated": Only applicable for Entri Sell Enterprise. An outbound domain transfer away from Entri has been initiated.
"purchase.error": Indicates an error during the domain purchase process.
"purchase.confirmation.expired": The purchase confirmation has expired (abandoned flow).

Payload fields

purchased_domains: An array of domains that were purchased during the transaction. This field is only relevant for Entri Sell. Example:
["domain1.com", "domain2.com", "domainN.com"]
free_domain: Indicates whether the domain was obtained through a free domain flow. Possible values:
- true: The domain was free.
- false: The domain was not free.

Browser callback events

The Entri Sell modal emits browser events you can listen for to react when a purchase completes or the modal is closed. Each is a window event whose event.detail carries the payload described below.

`onSuccess` Callback Event

Fired when the user reaches the Congratulations screen after a successful purchase. Use it to capture a definitive success signal and the jobId that identifies the flow.

Both the IONOS and Squarespace Sell flows fire onSuccess.

Sample usage:

JavaScript

function handleOnSuccess(event) {
  console.log('onSuccess', event.detail);
}
window.addEventListener('onSuccess', handleOnSuccess, false);

Sample `event.detail` object response:

JSON

{
  "domain": "example.com",
  "success": true,
  "setupType": "purchase",
  "provider": "squarespace",
  "freeDomain": false,
  "jobId": "2132b20f-e522-42fc-9604-5a53b1f13a4b"
}

Event details object description

Name	Type	Description
domain	string	The purchased domain. When multiple domains are purchased, they are returned as a comma-separated string.
success	boolean	Always `true` for this event.
setupType	string	Always `purchase` for Sell flows.
provider	string	The Sell registrar handling the purchase (e.g. `squarespace`).
freeDomain	boolean	`true` when the purchase used an Entri Sell free-domain flow; otherwise `false`.
jobId	string	The unique identifier for the Sell flow. It is also included in the related webhooks.

The onSuccess event is the recommended source to capture the jobId for subsequent server-side operations (e.g., retrieving the last webhook).

`onEntriClose` Callback Event

Fired as soon as the modal is closed, with the latest status of the flow.

Sample usage:

JavaScript

function handleOnEntriClose(event) {
  console.log('onEntriClose', event.detail);
}
window.addEventListener('onEntriClose', handleOnEntriClose, false);

Sample `event.detail` object response:

JSON

{
  "domain": "example.com",
  "success": true,
  "lastStatus": "FINISHED_SUCCESSFULLY",
  "provider": "squarespace",
  "setupType": "purchase"
}

Event details object description

Name	Type	Description
domain	string	The domain the user entered. May be an empty string if the user closed the modal before selecting a domain.
success	boolean	`true` if the purchase completed before the modal closed; otherwise `false`.
lastStatus	string	`FINISHED_SUCCESSFULLY` when the purchase completed successfully. Omitted when the modal is closed without completing a purchase.
provider	string	The Sell registrar handling the purchase (e.g. `squarespace`).
setupType	string	Always `purchase` for Sell flows.

The payload depends on the registrar and the outcome. The IONOS close event includes only domain and success. When the modal is closed without a completed purchase, success is false and lastStatus is omitted.

Get Started

Entri Activate

Entri Connect

Entri Sell

Entri Power

Entri Secure

Entri Monitor

Entri Network

Entri MCP

DNS Concepts

Reference

Legal & Security

Webhook event types

Payload fields

Browser callback events

`onSuccess` Callback Event

Sample usage:

Sample `event.detail` object response:

Event details object description

`onEntriClose` Callback Event

Sample usage:

Sample `event.detail` object response:

Event details object description

​Webhook event types

​Payload fields

​Browser callback events

​onSuccess Callback Event

​Sample usage:

​Sample event.detail object response:

​Event details object description

​onEntriClose Callback Event

​Sample usage:

​Sample event.detail object response:

​Event details object description

Webhook event types

Payload fields

Browser callback events

`onSuccess` Callback Event

Sample usage:

Sample `event.detail` object response:

Event details object description

`onEntriClose` Callback Event

Sample usage:

Sample `event.detail` object response:

Event details object description