Skip to content
Coritan Docs

See your platform cut

See the share of your customers' money Coritan takes this month, the rate your revenue pays, what the next payout would hold, and the months already closed.

View as Markdown

In the dashboard

Coritan takes a share of the money your customers pay your organization, the platform cut, at a rate set by each month's revenue. It also charges the wholesale price of the hosting your customers' services run on. The Platform cut page of Billing shows where this month stands, what the next payout would hold if it were made today, and the rate each closed month paid.

Before you begin

Section titled Before you begin

You need the owner, admin or billing role.

Read this month

Section titled Read this month
  1. In the dashboard, open the organization, then Billing, then Platform cut.
  2. The four figures at the top show:
    • Revenue in the month: your store sales and your hosting money so far this month, together.
    • Rate now: the rate that revenue pays, and the band it falls in.
    • Cut so far: what the cut would come to if the month ended now.
    • Wholesale discount: how far below Coritan's list price the hosting you resell is charged.

Every figure on the page is in US dollars, converted from the currencies your customers paid in.

The rate is set by the month's whole revenue, store sales and hosting together, and applies to all of it, so a month that crosses into a cheaper band pays the lower rate on everything it took. The Rates card lists the bands and marks the one this month is in with This month. Under it, a line says how much more revenue this month would take every sale to the next band's rate.

Read the next payout

Section titled Read the next payout

The Next payout card shows what the payout for the window since your last one would hold if it were made today:

  • Collected: what Coritan's payment gateways took for your organization, less refunds and chargebacks.
  • Platform cut and Wholesale: what comes off it.
  • Card fees: None deducted. A payout deducts no card fees; the gateways' fees are on your statements, for your records.
  • Paid out: what would be sent to you.
  • Paid to: where it goes, the payout method and its account masked, such as a PayPal address shown as c•••@example.com. Coritan sets it for you: Ask support to change it opens a ticket. While none is set, Coritan pays by hand and the row says Ask support to set it.

Each month in the window is a row, with its Revenue, its Rate, the Hosting money it took, its Cut and its Wholesale. A rate marked "So far" belongs to a month that has not closed. A month whose hosting money came to nothing, or less once refunds came off, reads No cut with a cut of $0.00, here and under Closed months: no rate was applied to it. Money your own PayNow store took, invoices settled from wallet credit and invoices marked paid are not in the payout, and a line under the figures says how much of each there was.

When the money collected does not cover the cut and the wholesale, for example because your customers paid your own PayNow store, a warning says that the difference would be invoiced to your Coritan account (the owner's, when you are not the owner), and the card shows it as Invoiced to the owner. When the last payout has already settled everything before this month, the card says there is nothing waiting to be paid out: this month's money is paid out once the month is over. When no money came in over the window and nothing was charged, it says there is nothing to pay out.

Read the closed months

Section titled Read the closed months

The Closed months card lists the last twelve months that have closed, newest first: the Revenue each one reached, split into Store and Hosting, the Rate it paid and the Cut it came to, and when it Closed. A month closes once it is over, at the rate its whole revenue reached.

Coritan's own organizations

Section titled Coritan's own organizations

An organization Coritan runs pays no platform cut and no wholesale price. Its page says No platform cut, shows the month's revenue with its store sales and hosting, and leaves out the rates and the cut.

Troubleshooting

Section titled Troubleshooting
The rate is higher than the revenue suggests
The revenue is in US dollars, after refunds and chargebacks, and store sales count less tax. A month whose refunds outweighed its charges carries the difference into the next one.
The next payout says Coritan could not work it out
The preview failed for a moment. Reload the page. The figures for this month and the closed months do not depend on it.
Section titled Related

With the API

Section titled With the API

Read the platform cut. This takes the owner, admin or billing role:

Shell
curl "https://api.coritan.com/api/v1/orgs/acme/billing/cut" \
  -H "Authorization: Bearer $CORITAN_TOKEN"

The answer has:

Field What it holds
exempt true for one of Coritan's own organizations, which pays no cut and no wholesale.
currency The currency the cut is reckoned in.
tiers The bands, lowest first, each with its percent and, except the last, below: the revenue it ends under.
wholesale_discount_percent How far below list price the hosting is charged.
this_month The month so far: month, volume_usd, store_volume_usd, hosting_volume_usd, rate_percent, and cut_usd, the cut that revenue comes to at that rate in US dollars, rounded half up to the cent as a closed month is.
months The last twelve closed months, newest first, each with month, label, volume_usd, store_volume_usd, hosting_volume_usd, rate_percent, cut_usd (the rate over the month's whole revenue, in US dollars), cut (the same figure, under the name older clients read), currency, exempt and closed_at.
settlement What the next payout would hold, up to the start of this month, or null when it cannot be worked out: period_start and period_end, total_collected, platform_cut_amount, wholesale_total, net_to_reseller (what would be paid out), shortfall (what would be invoiced to the owner), not_settled (own_store, settled_with_credit and marked_paid), and months, each with month, label, volume_usd, rate_percent, rate_final, hosting_money, own_store_money, carried_in, cut and wholesale.
payout Where the next payout goes: method (stripe_connect, paypal or manual, Coritan paying by hand), whether a destination is set and whether your billing mode needed one, and destination, the account masked, or null when Coritan pays by hand.

API operations on this page

MethodPathWhat it does
GET/api/v1/orgs/{org_slug}/billing/cutGet platform cut