Register a domain

Register a domain when you want Coritan to hold its registration as well as its DNS. The domain is yours for the period you pay for. The price comes out of your account credit, and when your credit is short, the same button adds what is missing with your card first. The domain starts on Coritan's nameservers with a DNS zone. It can have a certificate and a web proxy set up at the same time.

• Check the prices. The page shows the price for the name you search. View domain prices, in the Domain Management list's More website actions menu, lists every extension. If your account's currency is not US dollars, the prices show in it as an estimate, and the list says so.
• You do not need to add credit first. If your balance does not cover the total, the button changes to "Pay $X and register", where $X is what your payment method is charged, and one click adds that credit and registers the domain. In another currency the button says Pay about €13.50 and register for a saved method, because Coritan prices the charge when you press the button, and Pay €13.50 and register once it has priced it.

1. In the dashboard, go to Domain Management and select Add a website. The page asks Do you have a domain? Choose Register a new domain, then select Find a domain. This opens the Domain order page. The More website actions menu has Register a domain, which opens it at once, and you can also open it from Order a service, under Websites. The welcome page and Add a website on the dashboard open the same page.
2. In section 1, Domain, keep Register selected, enter the Domain name, such as example.com, and select Search.
3. Read the result. The page says whether the domain is available and its price for a year, and marks a premium domain, whose price its registry sets. If it is taken, search for another name.
4. In section 2, Period, choose the Registration period, from 1 to 10 years. Some extensions need more than one year. The summary shows the total for the period, paid once.
5. In section 3, Options, choose what to set up:
   • Set up a proxy route (off at first) sends your site's visitors through Coritan's network. It creates a web proxy for the domain that forwards to the Origin server you enter: the public address or hostname of the server that runs your site. Coritan refuses a private or loopback address, such as 127.0.0.1 or 10.0.0.5, before it takes any credit. Leave Origin server empty and Coritan creates no web proxy.
   • Issue an SSL certificate requests a certificate for that web proxy. It needs Set up a proxy route: turn that on first, and this option turns on with it.
   • WHOIS privacy (on at first) hides your contact details from public WHOIS lookups, at no charge.
6. In section 4, Owner contact, keep Use the default contact, or choose Enter the owner's details and fill in the form. The details are the same as on the website's Settings tab, in the Registrant contact card (Set a domain's registrant contact). Coritan sends them to the registry when it registers the domain.
7. In the summary, read Due today and choose how to pay under Pay with. The summary has no promo code field, because domains take none.
   • When your account credit covers the total, the summary says We take it from your account credit. and the button says Register domain. Credit is in US dollars, so Account credit and Due today show US dollars in every currency, and the prices above them are estimates.
   • When it does not, Pay with lists your saved payment methods, a new card and any wallet or other way to pay your account offers. Pick one. The button says "Pay $X and register". A saved method is charged when you press the button. A new card opens a card form in the summary. PayPal and other hosted checkouts open their own page and bring you back to this one, with your choices kept.
8. Select the button. Coritan adds the missing credit with your method, takes the total from your credit balance, then registers the domain.

If the payment is declined, the page keeps every choice and shows the reason under the button. Choose another method and select the button again. The page keeps your choices when you reload it. It does not keep an EPP code, which only a transfer uses.

The dashboard confirms that the domain is registered and opens its page under Domain Management. It also appears in the Domain Management list. The registration starts with:

• the transfer lock and auto-renew on, and WHOIS privacy on unless you turned it off;
• Coritan's nameservers, ns1.coritan.com to ns8.coritan.com;
• a DNS zone hosted on Coritan and signed with DNSSEC. If your account already has a zone for the domain, the registration uses that one.

The web proxy that Set up a proxy route creates forwards to your Origin server, and you can change the origin later. Coritan requests the certificate only for that proxy. When you left Origin server empty, the registration stands, the dashboard says that Coritan created no web proxy, and it orders no certificate: create a web proxy when you know where the site runs. With Set up a proxy route off, issue the certificate from the domain's SSL/TLS tab once you need one.

Next, add the domain's DNS records.

Your card was declined. or another reason under the button

Your payment method refused the credit that the order needs. Coritan registered nothing. Choose another method, or a shorter period, and select the button again.

This registration costs … Your credit balance is …

The credit changed between the page and the registry, for example another purchase used it. Coritan has charged nothing. Select the button again and it adds what is missing.

Domain is not available for registration

Someone else holds the domain. Search for another name.

Domain already registered in our system

The domain is already registered through Coritan, on your account or another.

Registration failed: … or Registrar error: …

The registry refused the registration or did not answer. When Coritan had already taken the charge, it put it back on your credit balance, and the message says how much. Try again later.

Domain registration is not available right now.

Coritan cannot reach a registrar at the moment, so it cannot search, price or register a name. Nothing was charged, or Coritan put the charge back on your credit balance. Waiting a minute does not help. Try again later, and contact support if it lasts.

We could not check this name right now. Try again in a moment., The domain registrar is busy. Try again in a moment. or We could not check this name. Try again in a moment.

The registrar did not answer the search. Search again in a minute. Nothing was charged.

Invalid domain name format

Enter the bare domain, such as example.com, without https:// or a path.

• How domain registration works
• Renew a domain
• Turn on WHOIS privacy and transfer lock

Check the name first. The price is per year, as a string:

curl -X POST https://api.coritan.com/api/v1/domains/search \
  -H "Authorization: Bearer $CORITAN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com"}'

{"domain": "example.com", "available": true, "price": "14.99", "currency": "USD", "premium": false}

When the registrar does not answer or is busy, the search answers 503 with a Retry-After header in seconds, and nothing is charged. Search again after that wait. When Coritan cannot reach a registrar at all, the search answers 503 with detail set to Domain registration is not available right now. and no Retry-After header: repeating it does not help until Coritan restores the connection. Any other registrar failure answers 502. A search changes nothing, so repeat it as often as you need.

Then register it. Coritan takes the price per year that the search showed, times duration, from your credit before it registers the domain. The body takes domain, duration (1–10 years, 1 when you leave it out), whois_privacy, auto_ssl and auto_proxy. It can also take nameservers, a list of the nameservers to start with instead of Coritan's, registrant, the domain's owner as the registry records it, with the fields that Set a domain's registrant contact lists, and proxy_origin, where the web proxy sends traffic: {"host": "198.51.100.7", "port": 443, "ssl": true}. Without registrant, the registry's default contact is the domain's registrant.

curl -X POST https://api.coritan.com/api/v1/domains/register \
  -H "Authorization: Bearer $CORITAN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com", "duration": 2, "whois_privacy": true, "auto_ssl": true, "auto_proxy": false}'

The answer is 201 with the registration, in the shape How domain registration works shows. dns_zone_id names the domain's DNS zone, and proxy_route_id the web proxy. The domain gets a zone when it starts on Coritan's nameservers, or when auto_ssl or auto_proxy is true.

When another account holds the zone, dns_zone_conflict is true, dns_zone_id is null and dns_zone_message says what to do. When another account holds a web proxy for the domain, proxy_route_conflict is true, and Coritan links no proxy and requests no certificate. When auto_proxy is true and the body has no proxy_origin, proxy_route_skipped is true, proxy_route_id is null and proxy_route_message says to add the proxy yourself. The registration stands in all three cases.

When your credit does not cover the price for the whole period, the answer is 402 and Coritan charges nothing. detail says what the registration costs and what the account has:

{
  "detail": {
    "error": "insufficient_credit",
    "message": "This registration costs 29.98 USD. Your credit balance is 10.00 USD. Add credit, then try again.",
    "required": "29.98",
    "available": "10.00",
    "currency": "USD"
  }
}

required and available are strings with two decimals. Read error to tell this answer from a plan limit, which also answers 402 (When you reach a limit). A renewal and a transfer answer the same 402 when your credit does not cover them.

When the registry refuses the registration or does not answer after Coritan took the charge, the answer is 502 and Coritan puts the charge back on your credit. detail begins Registration failed: or Registrar error: and ends with the amount returned, such as We returned 29.98 USD to your credit. When Coritan cannot reach a registrar at all, the answer is 503 with detail set to Domain registration is not available right now. and no Retry-After header. A charge already taken goes back on your credit first.