Currencies and countries

Coritan prices every service in US dollars, and your invoices and your credit balance are in US dollars too. You can pay in another currency: Coritan converts the US dollar amount at its current exchange rate when you pay. Your billing country decides which payment provider takes your payments. It and the currency also decide which methods the payment form offers (Ways to pay).

Your account's currency is the currency Coritan charges your card or PayPal account in. It is set like this:

• When you create your account, Coritan looks up the country you are connecting from. If Coritan takes payments in that country's currency, it becomes your account's currency. Otherwise your account uses US dollars.
• If the lookup fails, your account starts in US dollars. The first time you open Billing or Settings from a country Coritan can place, it switches to that country's currency once, if Coritan takes payments in it.
• Once you choose a currency yourself, Coritan never changes it.

To choose one:

1. In the sidebar, select Settings, then the Billing address tab.
2. In the Currency and country card, choose a Currency. The list shows every currency you can pay in, for example EUR (Euro).

The currency saves as soon as you choose it, and a message confirms Currency changed to EUR. The currency menu in the top bar of the dashboard is the same choice, so changing it there changes Currency in Settings, and the other way round. The Save country button in the card saves the country only.

Your credit balance stays in US dollars whatever you choose.

The dashboard shows your credit, invoices, transactions and refunds in US dollars, and plan prices in your account's currency as an estimate (Prices in your currency). What your bank or PayPal charges depends on how you pay:

Your statement shows the converted amount, and your bank may add its own fee for a payment in a foreign currency.

Each rate is the market rate for that currency, plus any margin Coritan adds for it. Coritan updates the rates every hour by default. A payment is converted when you make it, so the same invoice can cost a slightly different amount in your currency on another day.

A currency is in the list only when Coritan has a rate for it and one of its payment accounts takes it, so every currency you can choose is one you can pay in. A currency Coritan has just added appears once it has a rate.

A payment in Hungarian forints or New Taiwan dollars is a whole number of units, because the payment providers take no fractions of them. Coritan rounds the amount before it prices the payment, so the amount on the quote is the amount charged. A refund of part of such a payment is rounded to a whole unit too.

Plans, invoices and credit are priced in US dollars. Where a page shows a price in another currency, it multiplies the US dollar price by the rate and rounds half up to the currency's decimal places. That amount is an estimate, so a price you decide on has its US dollar price beside it: a line such as ≈ $12.99 USD under a plan or a total, or a sentence such as In US dollars that is about $11.80 on a public page. A price in a table or a list has no such line, and neither does a price in US dollars.

Signed out, the currency menu in the top bar of coritan.com changes the prices you read, and your browser keeps the choice. Signed in, the same choice is saved on your account. These prices follow it:

• The prices of plans, add-ons, sizes and usage rates on coritan.com, on the order pages and in the order summary.
• The prices of domains: the price list and the search on coritan.com, View domain prices in the Domain Management list's More website actions menu, the Domain order page and the Price per year on the renewal page of a domain. The price of the name you search for on coritan.com has its US dollar price beside it.
• The price of each service on Subscriptions, on its Billing tab and on the receipt of an order you placed.
• The prices on the plan page, where Server access has its US dollar price beside it, and the Then line of the plan change page, which says what the plan renews at.
• A deployment's price, its price for each instance-hour and its usage rates on its Billing tab. The Rates card says the prices are an estimate and that Coritan bills in US dollars.
• The quote in Change plan, with the US dollar amount under what is due now.

These stay in US dollars: your credit balance (also in the top bar), invoices (the invoice line on an order's receipt included), transactions, refunds, what your services have cost this month, Next 30 days, budgets and spend limits. A deposit and the credit an order uses are in US dollars too. A payment you made in another currency shows what your card was charged under its dollar amount in Transactions, such as Charged £10.36.

A domain is always paid from your account credit, which is in US dollars. A registration, a transfer or a renewal shows its price per year in your currency as an estimate, and what Coritan takes from your credit is in US dollars: Account credit and Due today show it when your credit covers the price, and the confirmation says We took $26.99 from your credit. When your credit is short, the button adds the difference as credit with the method you choose. A card pays that difference in your currency, and Due today shows the amount with its US dollar amount under it.

The amount you are charged is worked out again when you pay, at the rate of that moment. A payment in a page that carries the amount you saw is refused with The amount to pay changed. Check the new amount and pay again. when the rate has moved since, and nothing is charged.

Your billing country is the country Coritan treats you as paying from. It decides which of Coritan's payment provider accounts takes a new payment, so it can change the ways to pay that you see. Charges to a card, bank account or PayPal account you have already saved do not depend on your country. A method made for one country, such as iDEAL or BLIK, shows only when your billing country and the payment's currency both fit it (What decides the list).

Coritan decides your billing country in this order:

1. A country you chose under Currency and country on the Billing address tab of Settings, or that Coritan support set for you. A lookup never replaces it, so it stays put when you travel.
2. The country you are connecting from, when Coritan can tell. A country that came from a lookup follows you.
3. The country Coritan last detected for you.
4. The United States, when nothing else is known.

Your country does not change what you pay: the Tax line on every Coritan invoice is $0.00.

GET /payments/currencies returns every currency you can be charged in, with its rate. US dollars come first, and a currency is listed only when Coritan has a rate for it and a payment account that takes it:

curl https://api.coritan.com/api/v1/payments/currencies \
  -H "Authorization: Bearer $CORITAN_TOKEN"

[
  {
    "base_currency": "USD",
    "quote_currency": "USD",
    "rate": "1",
    "market_rate": "1",
    "upcharge_percent": "0",
    "is_enabled": true,
    "decimal_places": 2,
    "name": "US Dollar",
    "source": "base",
    "fetched_at": null
  },
  {
    "base_currency": "USD",
    "quote_currency": "EUR",
    "rate": "0.85411765",
    "market_rate": "0.85411765",
    "upcharge_percent": "0.0000",
    "is_enabled": true,
    "decimal_places": 2,
    "name": "Euro",
    "source": "frankfurter",
    "fetched_at": "2026-09-25T09:15:02",
    "updated_at": "2026-09-25T09:15:02"
  }
]

quote_currency and name

The currency's three-letter code and its name.

rate

How many units of the currency Coritan charges for one US dollar. It is market_rate with upcharge_percent added on top. Rates are decimal strings.

decimal_places

How many decimal places the currency has. A payment's amount is in the smallest unit, so 1299 is 12.99 in a currency with two places and 1,299 in one with none.

source and fetched_at

Where the market rate came from, and when.

GET /payments/rates needs no token. It lists the same currencies as GET /payments/currencies, with only what a page needs to show a price in each:

curl https://api.coritan.com/api/v1/payments/rates

{
  "currencies": [
    {"code": "USD", "name": "US Dollar", "rate": "1", "decimal_places": 2},
    {"code": "EUR", "name": "Euro", "rate": "0.85411765", "decimal_places": 2},
    {"code": "JPY", "name": "Japanese Yen", "rate": "149.2", "decimal_places": 0}
  ]
}

code and name

The currency's three-letter code and its name.

rate

How many units of the currency one US dollar costs, as a string. It is the rate Coritan charges with, margin included. US dollars are "1".

decimal_places

How many decimal places the currency has.

US dollars come first. To estimate a price, multiply the US dollar amount by rate and round half up to decimal_places. Coritan converts the amount of a payment in the same way. The answer shows no market rate, margin or source. It is the same for every visitor, so caches may keep it for a short time and a changed rate can take a moment to appear.

GET /payments/countries returns the countries you can choose, your billing country and the country Coritan detects for this request. The example is shortened to two countries:

{
  "selected": "GB",
  "detected": "GB",
  "regions": {"NA": "North America", "LATAM": "Latin America & Caribbean", "UK": "United Kingdom", "EU": "European Union & EEA", "EUROPE": "Rest of Europe", "APAC": "Asia-Pacific", "MEA": "Middle East & Africa"},
  "countries": [
    {"code": "IE", "name": "Ireland", "currency": "EUR", "region": "EU"},
    {"code": "GB", "name": "United Kingdom", "currency": "GBP", "region": "UK"}
  ]
}

countries is sorted by name. Each country's currency is its own currency, which Coritan may not take payments in; the currency Coritan suggests falls back to US dollars then. detected is null when Coritan cannot place the request.

GET /payments/geo-currency needs no token. It answers with the country Coritan places the request in and the currency it would suggest:

curl https://api.coritan.com/api/v1/payments/geo-currency

{
  "country_code": "GB",
  "suggested_currency": "GBP",
  "base_currency": "USD",
  "client_ip": "203.0.113.24"
}

client_ip is the address Coritan saw the request come from.

GET /payments/preference returns your currency and country:

{
  "preferred_payment_currency": "GBP",
  "base_currency": "USD",
  "credit_currency": "USD",
  "auto_pay_enabled": true,
  "country_code": "GB",
  "currency_source": "geo",
  "country_source": "geo",
  "billing_country": "GB",
  "suggested_currency": "GBP"
}

preferred_payment_currency

Your account's currency.

country_code and billing_country

The country saved on your account (or null), and the billing country Coritan uses.

currency_source and country_source

How each was set: default, geo (from your location), user (you chose it) or admin (Coritan support set it).

suggested_currency

The currency Coritan would pick for your billing country.

Reading your preference fills in your country and currency from your location in the same way as opening Billing. It never replaces a choice you made.

Change them with PATCH /payments/preference. Send currency, country_code or both. Either counts as your own choice, so a later lookup leaves it alone:

curl -X PATCH https://api.coritan.com/api/v1/payments/preference \
  -H "Authorization: Bearer $CORITAN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"currency": "EUR", "country_code": "IE"}'

{
  "preferred_payment_currency": "EUR",
  "base_currency": "USD",
  "credit_currency": "USD",
  "auto_pay_enabled": true,
  "country_code": "IE",
  "country_source": "user",
  "currency_source": "user",
  "message": "Payment preference updated"
}

It answers 400 with Currency TRY is not enabled for a currency that is not in GET /payments/currencies, and 400 with Unknown country for a code it does not know. US dollars are always accepted. The same endpoint turns auto-pay on and off (Manage payment methods).