Domain Transfer In API: Sample Flows

This article presents possible use cases and corresponding sample flows that you can support. It provides a useful starting point as you plan your implementation.

Validate domain transferability before a transfer

Before starting a domain transfer, you can check whether the domain is eligible to be transferred to Wix. This catches issues like unsupported TLDs, premium domains, and domains already registered with Wix before the Wix user pays for the transfer.

To validate domain transferability:

1. Call Validate Domain Transferability with the domain name.
2. Read validationResult.violations in the response. Each violation is a requirement the domain doesn't meet. For example, DOMAIN_TRANSFER_IN_TLD_NOT_SUPPORTED means the TLD can't be transferred to Wix, and TRANSFER_IN_PREMIUM_DOMAIN_NOT_SUPPORTED means the domain is a premium domain.
3. Show the Wix user what to fix for each violation. For guidance on resolving common issues, see Troubleshooting a Failed Domain Transfer to Wix.
4. When validationResult.violations is empty, start the transfer by calling Upsert Domain Registration Intent with the domain name, the contact information, and intentType set to TRANSFER_IN.

Validate an authorization code before a transfer

The Wix user gets an authorization code from the domain's current registrar. You can confirm the code is valid before submitting the transfer, so the Wix user can request a new code right away if needed.

To validate an authorization code:

1. Call Validate Authorization Code with the domain name and the authorization code.
2. Read validationResult.violations in the response. If it contains DOMAIN_TRANSFER_IN_AUTHORIZATION_CODE_NOT_VALID, ask the Wix user to check the code or request a new one from the current registrar.
3. When validationResult.violations is empty, start the transfer by calling Upsert Domain Registration Intent with the domain name, the contact information, and intentType set to TRANSFER_IN.

Build a multi-step transfer wizard

You can build a guided transfer experience that validates each step before the Wix user continues. This makes sure every requirement is met before the transfer request is submitted.

To build a multi-step transfer wizard:

1. Collect the domain name from the Wix user.
2. Call Validate Domain Transferability with the domain name. Show any violations and let the Wix user resolve them before moving to the next step.
3. Collect the authorization code from the Wix user.
4. Call Validate Authorization Code with the domain name and the authorization code. If the response contains a violation, let the Wix user enter the code again.
5. Show a summary confirming that the domain and the authorization code are both valid.
6. Start the transfer by calling Upsert Domain Registration Intent with the domain name, the contact information, and intentType set to TRANSFER_IN.