docs menu

Billing

Plans are priced per project, in euros, excluding VAT. The pricing page lists the prices, and limits and plans lists what each plan includes and what usage over the limits costs. Payments go through Mollie, a Dutch payment company. Card details stay with Mollie.

Upgrade a project#

An admin of the project opens Settings, Usage and plan, picks Pro or Business and monthly or yearly billing, then pays in Mollie's checkout. The first payment sets up the mandate that later invoices use, and the plan starts when it succeeds.

Before the first checkout, add your billing details in Account: company, address, country and, for companies in the EU, a VAT number. The country sets the VAT; see below.

Yearly billing charges 10 months for 12.

Change or cancel#

ChangeWhat happens
Pro to BusinessApplies at once. The difference for the rest of the period is charged now
Business to ProApplies at once. The unused difference becomes a credit on the next invoices
Monthly to yearly, or backApplies from the next period
CancelRenewals stop. The plan stays until the end of the paid period, then the project moves to Free
ResumeUndoes a cancel before the period ends

Moving to Free keeps every document, media file and member. The Free limits then apply, as described in limits and plans: reads keep working, and writes pause while usage is over a limit.

Usage invoices#

At the start of each month, Galerne bills the previous month's extra people and usage over the plan limits (bandwidth, storage, API requests, documents) on one invoice per subscription, paid with the saved mandate. A month within the limits has no usage invoice. Usage and plan shows this month's usage charges so far.

Failed payments#

When a payment fails, the subscription becomes past due. Galerne tries again every 2 days. If the payment is still not settled 7 days after the first failure, the plan ends and the project moves to Free.

VAT#

CustomerVAT on the invoice
In FranceFrench VAT
A business in another EU country, with a valid VAT numberNone: reverse charge, with the legal mention on the invoice
A person in another EU country, or a business without a VAT numberThe VAT rate of their country (OSS)
Outside the EUNone, with the legal mention on the invoice

VAT numbers are checked with the EU's VIES service. Changing the billing details reprices the next renewals, since the VAT may change.

Invoices#

Every payment has an invoice, numbered in sequence, with the net amount, the VAT rate and amount, and the total. A refund comes with a credit note that cancels all or part of the invoice. The credit from a downgrade stays on the subscription and lowers the next invoices. Usage and plan lists the invoices of the project, and Account lists all of yours, each with a printable page.

Galerne with Tramontane hosting#

A Pro project can include Tramontane Pro hosting for one site at a bundle price, from the next renewal. See pricing.

Billing API#

Project billing is also on the API, for admins (a token with the admin scope acting as an admin):

MethodPathWhat it does
GET/p/<project>/v1/billingThe plan, the subscription (interval, status, period end, credit, next renewal), this month's usage charges and the invoices
POST/p/<project>/v1/billing/checkoutStarts a checkout. Body: plan (pro or business), interval (month or year), optional profile with the billing details. Answers with checkoutUrl
POST/p/<project>/v1/billing/planChanges between Pro and Business. Body: plan
POST/p/<project>/v1/billing/intervalChanges the interval from the next period. Body: interval
POST/p/<project>/v1/billing/cancelCancels at the end of the period
POST/p/<project>/v1/billing/resumeUndoes a cancel
GET/p/<project>/v1/billing/invoicesThe invoices of the project
GET/p/<project>/v1/billing/invoices/<id>One invoice as a printable HTML page
bash
curl https://api.galerne.cloud/p/acme/v1/billing -H "Authorization: Bearer gal_…"
json
{
  "plan": "pro",
  "subscription": { "plan": "pro", "interval": "year", "status": "active", "currentPeriodEnd": "2027-10-01T00:00:00.000Z", "cancelAtPeriodEnd": false, "creditCents": 0, "tramontaneHosting": false, "projects": ["acme"] },
  "upcoming": { "lines": [], "netCents": 0 },
  "invoices": []
}

Errors use the usual shape. A server without billing set up answers 501 with code feature.