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.

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, change Currency under Billing details on the Profile tab of Settings (Update your profile). The list shows every currency you can pay in, for example EUR (Euro). Your credit balance stays in US dollars whatever you choose.

The dashboard shows every amount in US dollars. 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 Coritan has just added appears in the list once it has a rate.

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 or PayPal account you have already saved do not depend on your country.

Coritan decides your billing country in this order:

1. A country you chose under Billing details, 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:

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/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",
  "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 Coritan does not take, and 400 with Unknown country for a code it does not know. The same endpoint turns auto-pay on and off (Manage payment methods).