Sell domains in your app
Entri Sell enables your users to easily purchase a domain that is immediately configured to work with your application.
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.
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",
lastStatus: "FINISHED_SUCCESSFULLY",
}
Advanced Settings
Entri Sell has the following additional parameters you can apply to the config object that may be useful depending on your needs.
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
| disableConnect | boolean | No | false | If true then the flow will only run the domain(s) purchase flow, but no specific DNS records will get configured. |
| debugMode | boolean | No | false | For 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. |
| freeDomain | boolean | No | false | This 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:
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
freeDomain | boolean | No | N/A | When 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
});
FAQ
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.