With Entri Sell, your users can buy and connect a domain name to your application effortlessly, right within your Entri modal. After purchase, Entri automatically connects their domain to your service, applying the records you defined on the dnsRecords object.

Step 1 - Configure Entri

To set up Sell, first configure Entri.

Be sure to use the dynamic configuration variables if your DNS records change based on the domain purchased.

Step 2 - Call purchaseDomain()

Then, call the purchaseDomain method with your configuration object to open the Entri Purchase Domain Flow.

<button type="button" onclick="entri.purchaseDomain(config)">Purchase Domain</button>

That’s it! You’re all set. If you are using Entri’s callback events, the setupType will be set to purchase.

  domain: "purchased-domain.com",
  success: true,
  setupType: "purchase",
  provider: "Ionos",

Advanced Settings

Entri Sell has the following additional parameters you can apply to the config object that may be useful depending on your needs.

disableConnectbooleanNofalseIf true then the flow will only run the domain(s) purchase flow, but no specific DNS records will get configured.
debugModebooleanNofalseFor testing purposes. It skips the actual domain purchase flow and checkout and takes the user back to the DNS records setup step. IMPORTANT!: this should only be used with pre-existent IONOS registered domains.
freeDomainbooleanNofalseThis feature allows you to offer your users their first domain at no cost. Please contact your account manager to enable this feature

Advanced Security Settings for freeDomain

For additional security, you can explicitly set freeDomain:false or freeDomain:true when you create the JWTs. This way, the user gets explicit authorization for running the free domains’ flow.

Then if the client tries to use a config that doesn’t match the one hashed in the JWT, it will return an error. Here is an example of how to use this when generating the JWT:

freeDomainbooleanNoN/AWhen set to true, it will only allow Entri to run under the freeDomain flow.
fetch('https://api.goentri.com/token', {
  method: 'POST',
  body: JSON.stringify({
    // These values come from the Entri dashboard
    applicationId: "12345",
    secret: "12345-67890",
    freeDomain: true
  .then(response => response.json())
  .then(data => {
    console.log('Success:', data); // { "auth_token": "exampletoken..." }
    // Save the token in a variable or state manager for later use


Who is the registrar for the domain?

Entri has partnered with Ionos as the domain registrar.

How is billing handled?

Billing, renewals, and the checkout process are handled by Ionos.

Who is responsible for customer support relating to the domain purchased?

For all inquiries relating to billing, renewals, domain registration, please direct your customers to Ionos’s support team: https://contact.ionos.com/

Can I earn a commission for each domain purchased?

Yes! Please contact your Entri account manager to set this up.