Facturació

El mòdul de facturació és un llibre comptable per inquilí per a la facturació SaaS pròpia d'un projecte. Els diners s'emmagatzemen com a cèntims enters. És opcional: habilita'l al gestor de plugins (les seves taules sempre existeixen; les rutes retornen 404 fins que s'habilita).

El llibre comptable

• customers — els teus clients finals (external_id, email, nom).

• plans — price_cents, currency, interval (mes/any/vitalici), features[].

• subscriptions — estat trialing/active/past_due/canceled, client + pla vinculats.

• invoices — draft/open/paid/void, imports en cèntims.

• events — un registre d'auditoria de només afegir.

Proveïdors de pagament

Les credencials de proveïdor viuen per projecte; la api_key i el webhook_secret es segellen en repòs. Tipus integrats: paddle (Paddle Billing) i mock per a proves.

Webhooks

Els esdeveniments entrants arriben a POST /api/p/{ref}/billing/webhooks/{kind} i es verifiquen per HMAC contra el secret de la configuració (el Paddle-Signature: ts=…;h1=… de Paddle, amb comparació de temps constant, finestra de repetició de 5 minuts). El lliurament és idempotent — un (project, kind, event_id) duplicat no fa res — i cada lliurament es reflecteix en un registre de webhooks que pots inspeccionar i reenviar.