Renew a domain

Renew a domain to extend its registration past its expiry date. You can renew it by hand for 1–10 years at a time, or leave auto-renew on so that Coritan renews it before it expires. Either way, Coritan takes the price from your account credit before it asks the registry to renew the domain. When a domain expires, its registry can stop it resolving and later release it for anyone to register.

A domain you ordered through checkout on a yearly subscription renews when you pay that subscription's invoice. Domains that renew with their service explains how.

• The domain must be registered with Coritan. For a domain registered elsewhere, renew it at that registrar.
• The registration must be active, or expiring_soon in its last 30 days. See Troubleshooting when it is neither.
• Your account credit pays for the renewal at once. You do not need to add credit first: when your balance is low, the page's button adds what is missing with your payment method and renews the domain in the same click.

1. In the dashboard, go to Domain Management, open the domain and select the Settings tab.
2. In the Renewal card, choose how many years to add, from 1 to 10.
3. Select Renew domain…. A page opens at /dashboard/order/domain?mode=renew&name=<domain>&years=<years>, with the heading Renew and the domain's name, and a link back to the domain.
4. Read Your renewal. It shows the date the registration ends now (Ends now), the date it ends after the renewal (Ends after renewal) and the Price per year. The Domain section shows the name and cannot be changed. You can change the Renewal period under Period, from 1 to 10 years. Due today shows the total for the years you chose, and the Account credit line shows how much of it your balance covers. If your account's currency is not US dollars, Price per year is an estimate in that currency, while Account credit is in US dollars, because credit is.
5. When your balance covers the total, the page says We take it from your account credit. and the button says "Renew for 2 years", with the years you chose. 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 renew", where $X is the shortfall, at least $1.00. In another currency it says Pay about €13.50 and renew for a saved method, and Pay €13.50 and renew once Coritan has priced the charge, with the US dollar amount under Due today. A saved method is charged when you press the button, and a new card opens a card form on the page. PayPal and other hosted checkouts open their own page and bring you back to the renewal page with your years chosen.
6. Check the dates and the total, then select the button. Coritan adds the missing credit with your method, takes the total from your credit balance, then renews the domain.

If the payment is declined, the page stays open and shows the reason. Your balance has not changed. Choose another method and select the button again. Cancel and the link at the top return you to the domain's Settings tab without renewing.

The dashboard confirms the renewal, says how much it took from your credit and returns you to the Settings tab. The Expires date there moves to the new end date.

1. On the domain's Settings tab, find the Domain options card.
2. Turn Auto-renew on or off.

With auto-renew on, Coritan renews the domain for one year when it is within 14 days of its expiry date. It takes a year's renewal price from your credit balance first. When the registry refuses the renewal, Coritan puts the money back and tries again the next day.

When your balance does not cover the price, Coritan does not renew the domain and takes nothing. It emails you that it could not renew the domain and how much credit to add, and it tries again each day until the domain expires. Add credit before the expiry date and the next day's try renews the domain.

With auto-renew off, Coritan emails you 30, 14, 7, 3 and 1 day before the domain expires.

A domain ordered through checkout, instead of with Add a website, is a service with its own subscription under Billing, Subscriptions. When the subscription bills a year or more at a time, its invoices pay for the domain, so Coritan never renews it from your credit. On the domain's Settings tab:

• the Renewal card has no renew button. It says the domain renews with its service, and Open Billing opens the service's page under Billing;
• the Registration card shows Auto-renew as With its service, and the Domain options card shows a note in place of the Auto-renew switch.

Pay the service's renewal invoice (Pay an invoice). Once it is paid, Coritan renews the domain for a year when it is within 14 days of its expiry date. While the invoice is unpaid, Coritan does not renew the domain.

A subscription that bills monthly, or a one-time price, pays for less than the year a renewal adds. Such a domain renews from your credit, as a domain you registered here does.

The Registration card on the Settings tab shows the new Expires date and whether Auto-renew is on. In the Domain Management list, the domain's card shows Registration as "Renews before" and the date with "Auto-renew is on", or as "Expires on" and the date with "Auto-renew is off".

Your card was declined. or another reason on the renewal page

Your payment method refused the credit that the renewal needs. Coritan renewed nothing and charged nothing. Choose another method, or fewer years, and select the button again.

Could not read the renewal price

The page could not get the price from Coritan, so it cannot say what is due. Select Try again.

This domain renews with its service

A service pays for this domain through its invoices, so it cannot be renewed from your credit. Pay the service's renewal invoice, as Domains that renew with their service describes.

Registration not found or not active

The dashboard renews a registration whose status is active or expiring_soon. Once the registry reports the domain expired, its status is expired and the dashboard cannot renew it. Contact support to renew an expired domain.

Could not save the Auto-renew setting

The switch could not be changed. The registration may no longer be active or expiring_soon, or the dashboard could not reach Coritan. Reload the page and try again.

Renewal failed: …

The registry refused the renewal or did not answer. Coritan put the charge back on your credit balance, and the message says how much. The expiry date has not changed. Try again later.

We could not get a price for this domain or Registrar error: …

Coritan could not get the renewal price from the registry, so it charged nothing and renewed nothing. Try again later.

Domain registration is not available right now.

Coritan cannot reach a registrar at the moment, so it cannot price or renew the domain. It charged nothing, or put the charge back on your credit balance. The expiry date has not changed. Try again later, and contact support if it lasts.

We could not renew example.com

This email means auto-renew is on but your credit balance does not cover a year of renewal. It gives the price and how much to add. Add credit before the expiry date, and Coritan renews the domain on its next daily try.

Duration must be between 1 and 10 years

The API accepts a duration from 1 to 10.

• How domain registration works
• Website settings
• Add credit to your balance

Ask what a year of renewal costs first. renew_price is the price per year, as a string with two decimals:

curl https://api.coritan.com/api/v1/domains/registrations/7/renewal \
  -H "Authorization: Bearer $CORITAN_TOKEN"

{"domain": "example.com", "renew_price": "16.99", "currency": "USD"}

Then renew registration 7 for two years. The body's duration is 1 when you leave it out. Coritan takes renew_price times duration from your credit before it asks the registry:

curl -X POST https://api.coritan.com/api/v1/domains/registrations/7/renew \
  -H "Authorization: Bearer $CORITAN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"duration": 2}'

{"message": "Domain renewed successfully", "domain": "example.com", "new_expiry": "2029-09-16T10:04:00+00:00", "charged": "33.98", "currency": "USD"}

The answer is 202. charged is the amount Coritan took, as a string with two decimals, and new_expiry is the date the registry reported, or null when it reported none. The registration's expires_at changes at once: to that date or, when the registry reported none, to the old date plus the years you renewed.

When your credit does not cover the total, the answer is 402 and Coritan charges nothing. detail has the shape Register a domain shows, and its message begins This renewal costs. Other answers:

• 409 when a service pays for the domain. detail.error is renews_with_service and detail.service_id names the service.
• 502 when the registry refuses the renewal or does not answer. detail begins Renewal failed: and says how much Coritan put back on your credit.
• 503 with detail set to Domain registration is not available right now. and no Retry-After header when Coritan cannot reach a registrar at all. Coritan puts back any charge it took.
• 404 with Registration not found or not active for a registration that is not yours, or not active or expiring_soon.

The quote answers 404 and 409 the same way, 502 when Coritan cannot get a price, and the same 503 when it cannot reach a registrar to ask. Turn auto-renew on or off with enabled:

curl -X PUT https://api.coritan.com/api/v1/domains/registrations/7/auto-renew \
  -H "Authorization: Bearer $CORITAN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'

{"message": "Auto-renew disabled", "domain": "example.com"}