Choose or change your account plan

Order Pro or Business when your account needs more than the Free plan gives, move between them as your needs change, or cancel to return to Free. Each choice opens one page that says what you pay today, what the plan then renews at, and what the new plan would leave above its limits, and you pay on that same page. Nothing changes until you press its button. You start from the plan page, or through the API (With the API). Only Admin and Billing members can change the plan.

• Account plans are open on your account (Plans open in stages). Before they open, you can still cancel a plan through the API (Cancel your plan with the API).
• An order or a move to a larger plan raises an invoice. Coritan takes what it can from your credit, and the page charges the rest to the payment method you choose, so keep a payment method ready or add credit.

1. In the dashboard, open the plan page: select Manage plan on the Your plan card of the Dashboard.
2. Under Plans, select the button under the plan you want, such as Choose Pro. The page opens at /dashboard/plan/change on the billing period that Plans shows. A link such as /dashboard/plan?plan=plan-pro&cycle=annually opens the same page on that plan and period, with cycle set to monthly or annually.
3. To change the billing period, select Monthly or Yearly under Billing period. The prices change to match.
4. Check What changes and the Summary. Then gives the price the plan renews at and the date. During a trial, the page also says that the trial ends when the plan starts. When you hold the Server access add-on, it says that the add-on ends when the plan starts and how much goes to your credit (Server access). When the plan would leave some of what you have above its limits, the page lists it under a title such as Over the Pro plan's limits.
5. To use a promo code, type it in Promo code. There is no button to press: the page checks the code a moment after you stop typing. The field then says what the code gives, such as SPRING25 applied: 25% off the first 3 invoices., and the Summary adds a line such as Promo code SPRING25 with what it takes off this invoice. Due today is lower by that amount. A code the order cannot use shows the reason under the field, and the button stays off until you change or clear it (Use a promo code).
6. Under Pay with, choose a saved payment method, a new card, a wallet or another way to pay. Account credit comes first: Account credit shows what it covers, and Due today shows what the method is charged.
7. Select the one button under the Summary. It names what it does, such as Pay $12.00 and start Pro, and Pay $12.00 from credit and start Pro when your credit covers the whole price. Cancel, or the back link Plan, leaves the page without ordering.

Coritan charges the method for what your credit does not cover, adds it to your credit, and orders the plan, all from this page. A new card opens its form on the page, and your bank's check (3-D Secure) opens there too. The dashboard then lands on the plan page and says Your Pro plan starts in a moment. A wallet or another gateway opens its own page and brings you back to the same order, with your choices as you left them. If the order is still unpaid after the payment, for example because the price changed, the page to pay the invoice opens, as on the Invoices tab (Pay an invoice), and the plan starts once the invoice is paid. If you leave that page, the Your plan card on the plan page keeps saying that the plan waits for payment, with Pay invoice, until you pay.

An order for another plan cancels the waiting order and its invoice, and places the new one.

With Pro or Business, choose the other one on the plan page.

1. Under Plans, select the button under the plan you want, such as Choose Business. The page opens on your plan's billing period, and Monthly and Yearly under Billing period change the period together with the plan (Change your billing period).
2. Check the page, titled such as Change to Business:
   • Moving up, Due today is the difference for the rest of this billing period, and Then gives the new price from your renewal date. Pay it under Pay with, as for an order.
   • Moving down, Added to your account credit shows the unused difference, less the days Coritan keeps back.
   • The page lists anything the new plan would leave above its limits.
3. Select the button under the Summary, such as Pay $27.00 and change to Business, or Change to Business when nothing is due.

A move up raises an invoice for the difference. The page charges the payment method for what your credit does not cover, and the new plan applies at once. If the invoice is still unpaid, the plan applies once you pay it, on the page that opens or with Pay invoice on the plan page. A move down applies at once. When the move applies, the dashboard says Your plan is now Business., and a move down adds how much went to your credit. Your renewal date stays the same, and the plan renews at the new plan's price from then (How the switch is billed). Moving to another plan also withdraws a cancellation.

The Your plan card of a plan you pay for has a button that moves to the other period: Switch to yearly billing or Switch to monthly billing. It opens the page for your own plan on that period. You can also choose another plan and the other period together on one page, with Monthly and Yearly under Billing period.

1. On the plan page, select Switch to yearly billing, or the button for the other period.
2. Check the page, titled Switch to yearly billing or Switch to monthly billing. Under Billing moves to yearly today, it says that the new period starts today and what the unused days of your current period are worth.
   • Monthly to yearly: the unused part of this month comes off the first yearly invoice. Due today is the year less those days, and you pay it under Pay with.
   • Yearly to monthly: the unused part of your year pays the first month, and the rest goes to your account credit. The credit leaves out the last days of the year that every move to a smaller price keeps back. When those days do not cover the month, Due today is the rest.
3. Select the button under the Summary, such as Pay $108.00 and switch to yearly billing, or Switch to monthly billing when nothing is due.

The plan then renews at the new period's price from the end of the new period, which the page gives as Then. Over the API, Switch between monthly and yearly billing describes the same move.

Server access lets an account run Cloud Compute instances and game servers. Pro, Business and a trial include it, and the plan cards say Includes Server access. Under Plans, a plan that includes it also says what it costs over Free with Server access, such as $7.50 a month more than Free with Server access.

A Free account sees a Server access card on the plan page, next to Your plan. It says what Server access includes (data out each month) and its price for the billing period that Plans shows. Only an Admin member can buy it. To buy it:

1. On the plan page, select Add Server access on the Server access card. The page opens at /dashboard/plan/server-access.
2. Under What you get, read what it includes. When the catalogue sells both periods, choose one under Billing period. To use a promo code, type it in Promo code. The page checks it as you type and lowers Due today by what it takes off.
3. Under Pay with, choose how to pay, and select the button, such as Pay $4.50 and add Server access.

The dashboard lands on the plan page and says Server access added. The card then shows Active, its price and Renews on, and the Your plan card says Server access is an add-on at $4.50/mo, renewing on Oct 12, 2026. Select Cancel Server access to end it at the end of the period you paid for. The dashboard asks you to confirm, and the card then shows Ending. Servers the account already runs keep running, and a new one needs Server access again. Buying Pro or Business ends the add-on at once and credits its unused days (Server access). The add-ons guide has the API calls (Add Server access).

1. On the plan page, select Cancel plan on the Your plan card, or Move to Free under Free in Plans.
2. Check the page, Cancel your plan. Ends on gives the date the plan ends, and the page lists what the Free plan would leave above its limits.
3. Select Cancel plan. To leave the plan as it is, select Keep my plan.

The plan stays until the end of the period you paid for, and then the account moves to Free. Until then, the Your plan card has the Cancelling badge and says when the plan ends, such as Ends on Oct 12, 2026. The account then moves to the Free plan.

To keep the plan, select its keep button on the Your plan card before it ends, such as Keep Pro. The page gives the price the plan renews at and the date. Select Keep Pro again under the Summary, and the plan renews as before.

A trial ends from the same page, with End trial (When the trial ends). A plan suspended for an unpaid invoice and an order you have not paid for have no cancel button in the dashboard. Pay the invoice, or cancel through the API (Cancel your plan with the API).

The Your plan card and What your account uses show the new plan once it applies, and so does the Dashboard. The Dashboard links to the same pages: its Upgrade to Pro opens the order page for the next plan on your billing period, and Pay invoice takes its place while a plan is on hold or a change waits for payment. A change that waits for payment shows a line on the Your plan card of the plan page and of the Dashboard, such as Your Pro plan starts once you pay its invoice of $12.00. or Your move to Business happens once you pay its invoice of $27.00.

In the dashboard, the page shows the reason in an alert titled Could not price this change, Could not change your plan, Could not cancel your plan or, for Server access, Server access was not added. Over the API, it is the answer's detail, with the status in the first column.

• How account plans work
• Start a free trial
• Use a promo code
• Pay an invoice
• Change a service's plan

You need an access token for the account (Access and refresh tokens). Each request names a plan: plan-pro or plan-business, or free in a preview. billing_cycle is monthly or annually. Left out, an active plan keeps its own, and a new plan is monthly.

POST /account/plan/preview changes nothing. This account is on Pro and asks what moving to Free would mean:

curl -X POST https://api.coritan.com/api/v1/account/plan/preview \
  -H "Authorization: Bearer $CORITAN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"plan": "free"}'

{
  "plan": "free",
  "name": "Free",
  "billing_cycle": null,
  "change": "cancel",
  "due_now": 0.0,
  "discount": 0.0,
  "credit": 0.0,
  "currency": "USD",
  "renews_at": null,
  "renewal_amount": null,
  "ends_at": "2026-10-12T00:00:00+00:00",
  "over_limit": [
    {"entitlement": "websites_max", "limit": 3, "used": 5},
    {"entitlement": "mailboxes", "limit": 5, "used": 7}
  ],
  "renew_at_own_price": [
    {"entitlement": "included_floating_ips", "limit": 0, "used": 1}
  ],
  "trial": null,
  "promo": null,
  "server_access": {"included_after": false, "servers": 2},
  "cycle_switch": null,
  "message": "Your Pro plan stays until October 12, 2026. After that the account moves to the Free plan. Free does not include Server access. Your 2 servers keep running and bill by use. A new server needs Server access."
}

To see what a promo code would take off a new plan order, add promo_code to the body. A plan change and Free take no code.

change

new (an order, paid up front), upgrade (you pay the difference for the rest of this billing period now), downgrade (the plan changes now, and the unused difference goes to your credit), switch (you move between monthly and yearly billing, below), cancel (the account moves to Free at ends_at), renew (a plan you cancelled keeps renewing) or none.

due_now, credit

What you pay now, and what goes to your credit, in currency.

renews_at, renewal_amount

When the plan next renews, and the price it renews at.

over_limit

Each count the new plan would leave above its limit, as {entitlement, limit, used}. Coritan deletes none of it (Moving to a smaller plan).

renew_at_own_price

The floating IPs and DDoS Shield profiles your plan pays for now beyond what the new plan pays for, as {entitlement, limit, used} with entitlement included_floating_ips or included_ddos_profiles. The new plan keeps paying for the oldest. The others keep working and renew at their own price from their next renewal.

discount, promo

What the promo code takes off the first invoice, and what the code gives as {valid, code, message, reason, summary, duration, cycles}. due_now is what is left to pay, and renewal_amount is the plan's price before the code. Without a code, discount is 0 and promo is null.

trial

converts or ends when you have a trial running, and null otherwise. Either way, the trial ends when the plan starts.

server_access

null when the choice changes nothing about Server access. Choosing Pro or Business while you hold the Server access add-on, or during a trial, gives {"ends": true, "credit": "1.50"}: the add-on ends when the plan starts, and credit is what goes to your account credit for its unused days (When a plan includes Server access). Choosing Free while your plan or trial includes Server access gives {"included_after": false, "servers": 2}: your instances and game servers, servers of them, keep running and bill by use, and a new one needs Server access.

cycle_switch

null unless change is switch. Then it is {from, to, unused_credit, holdback_days}: the two billing periods, the money for the unused days of the current period, and the days Coritan keeps back from it (0 when you move to a longer period).

message

All of it in a sentence or two.

Send the plan to POST /account/plan. Add promo_code to take a code's discount off the first invoice (Use a promo code):

curl -X POST https://api.coritan.com/api/v1/account/plan \
  -H "Authorization: Bearer $CORITAN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"plan": "plan-pro", "billing_cycle": "annually"}'

Your credit did not cover this order, so it waits for payment:

{
  "service_id": 5310,
  "invoice_id": 20412,
  "status": "payment_required",
  "change": "new",
  "amount_due": 120.0,
  "message": "Pay the invoice to start your Pro plan."
}

Pay the invoice, and the plan starts once it is paid. Sending the same request again while the order waits answers with the same order. An order for another plan cancels the waiting order and its invoice, and places the new one.

With an active plan, send the other plan to the same route:

curl -X POST https://api.coritan.com/api/v1/account/plan \
  -H "Authorization: Bearer $CORITAN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"plan": "plan-business"}'

• Moving up raises an invoice for the difference over the rest of this billing period. The new plan applies once the invoice is paid, at once when your credit covers it.
• Moving down applies now. The unused difference goes to your credit, less the days Coritan keeps back.
• Your renewal date stays the same, and the plan renews at the new plan's price from then.

Sending the plan you have while it is set to end withdraws the cancellation, and the answer's status is renewing.

Send the plan with the other billing_cycle. It can be the plan you have or another one. The new period starts today, and the unused days of the period you paid for count towards it. Preview it first:

curl -X POST https://api.coritan.com/api/v1/account/plan/preview \
  -H "Authorization: Bearer $CORITAN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"plan": "plan-pro", "billing_cycle": "annually"}'

This account is on Pro at $12 a month, with 17 of 30 days left. The answer is shortened:

{
  "change": "switch",
  "billing_cycle": "annually",
  "due_now": 113.2,
  "credit": 0.0,
  "renews_at": "2027-10-12T09:30:00+00:00",
  "renewal_amount": 120.0,
  "cycle_switch": {"from": "monthly", "to": "annually", "unused_credit": 6.8, "holdback_days": 0},
  "message": "You pay $113.20 now for a year of Pro from today, after $6.80 for the unused part of this month. Your plan then renews at $120/yr from October 12, 2027."
}

• Monthly to yearly: The invoice has a line for the year and a line that takes off the unused days of the month, so due_now is the year less those days. Your credit pays it when it covers it, and the plan is then billed yearly at once. Otherwise the answer's status is payment_required, and the plan switches once you pay the invoice. renews_at is one year from the day it applies.
• Yearly to monthly: It applies now and never waits for the end of the year. The unused days of the year, less the holdback days that every downgrade gives up, pay the first month. due_now is 0 and credit is what goes to your account credit. When the unused days do not cover the month, due_now is the rest and the plan switches once you pay it.
• A plan and a period can change together. The unused days of the current plan count towards the new one.
• Sending the same request again while its invoice waits answers with that invoice. A request for another plan or period cancels it and prices the new one.
• A plan with an unpaid renewal invoice is refused with 409. Pay the renewal first.

The answer's change is switch, and status is changed or payment_required.

POST /account/plan/cancel takes an optional reason:

curl -X POST https://api.coritan.com/api/v1/account/plan/cancel \
  -H "Authorization: Bearer $CORITAN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"reason": "Moving to another provider"}'

• Pro or Business stays until the end of the period you paid for, and then the account moves to Free. To keep the plan, choose it again with POST /account/plan before then.
• A plan suspended for an unpaid invoice ends now, and Coritan cancels the invoice.
• A trial ends now.
• A plan order you have not paid for is cancelled with its invoice.

Each answer has a status and a message that says what happened.

GET /account/plan shows an order or change that waits for payment under pending (Read your plan).