Articles
The reseller model: whoever manages the server pays for it
When servers are sold through a reseller: whose subscription it is, who is invoiced, what happens when a customer leaves, and when staff have to step in by hand.
About 4 min read · Last updated
In this article
Before you set up the reseller model, one rule is enough to know: whoever can manage the server pays for it. The rest follows from that rule.
The starting position
A reseller opens the customer's account and orders servers on the customer's behalf. The server belongs to the customer, the subscription belongs to the reseller, and it is invoiced to the reseller at the reseller's discount. The e-mail address of a customer account opened by a reseller starts out unproven.
The customer knows about this. They are informed once on first using the panel, and under My account → Profile they see a card showing their reseller, what the reseller can do, and the button for leaving.
When a customer leaves
Whether the customer chooses "Leave the reseller", staff use "Remove from reseller", or the reseller status is removed, the same things happen.
Running subscriptions pass to the customer. They start clean: a suspension caused by an invoice the reseller did not pay is lifted, a cancellation at period end saved by the reseller is removed, and auto-renewal is switched on. The reseller's arrears do not become the customer's debt.
The reseller can no longer act on those servers. Its open consoles are closed, and the SSH key it added to the account when ordering is removed from the account. Note that the panel does not touch the key inside running servers. The notification sent to the customer says so; the customer has to remove the key from inside the server.
Invoices
- Renewal invoices issued to the reseller for those servers and not paid at all are cancelled. The first unpaid period is invoiced to the customer, with its own due date and reminders.
- An order of the reseller's that is not yet paid and whose build has not started is withdrawn.
- The reseller's other open invoices stay with the reseller: the first invoice of a server that was built, a resize or disk difference, partly paid invoices, and invoices shared with other servers.
Staff have to look at the invoices in the last item, to collect them or cancel them. They are written to the audit log as leftInvoices.
The price
The customer does not go on paying the reseller's discounted price; from the next invoice on, the list price applies. Nothing is asked for the current period, because the reseller has paid for it. The customer sees the new monthly amounts before leaving.
The panel is careful here, because it stores a single price per server and does not store the discount and the list price separately. It calculates the list price from today's catalog and accepts it only if taking the reseller's current discount off it gives the server's price to the last cent. In that case nothing is guessed.
If it does not match, the price stays as it is and the server is listed for staff. The reasons it may not match: the catalog or the discount has changed since, staff set the price by hand, the reseller has no discount, or the server is in a virtual datacenter, is billed externally or is not monthly. For those servers the customer is invoiced at the discounted price until you correct it.
Disabling versus removing
If you disable a reseller, it can no longer act on its customers' servers, but the customers remain its customers and the subscriptions remain its subscriptions, so that it can be enabled again. A disabled reseller therefore goes on paying. The response and the audit log say how many running subscriptions the reseller pays for. To really end the relationship, remove the reseller status or remove the customers one by one.
Known gaps
- If leaving coincides with an order the reseller places at that very moment, that order can end up outside the separation. This race has not been closed.
- If the catalog and the discount have both changed in a way that brings the server's price to the same cent again, the panel cannot tell.
- A reseller merely viewing the customer's servers does not appear in the customer's activity list.
- Staff signed in on behalf of a customer cannot take the account away from its reseller.
Source: docs/billing.md, "Bayiler: kim öder" (Turkish).
