Facturación y suscripciones

import { Aside } from ‘@astrojs/starlight/components’;

La facturación de ShareOut es por workspace: cada workspace puede tener su propia suscripción. El tier del dueño del workspace se calcula a partir del plan activo más alto entre los workspaces que posee — ese tier habilita funciones exclusivas de Teams (subdominios, conectores, gobernanza de publicación, etc.).

El flujo completo, de principio a fin

1. Registrate con Google. Caés en el plan Free con un workspace personal y ejemplos iniciales — sin tarjeta.
2. Empezá un plan. Elegí Pro o Teams en pricing → checkout. Arranca una prueba gratis de 15 días, sin tarjeta.
3. Agregá una tarjeta cuando quieras en /billing (checkout embebido de Rebill). Con tarjeta guardada, la prueba pasa a pago automáticamente al terminar.
4. Activo. Se cobra cada período — Pro precio fijo, Teams por miembro activo.
5. Sumar gente → upgrade Pro → Teams. Un workspace Pro es de un solo usuario; pasar a Teams habilita miembros al instante (la facturación se ajusta en la renovación).
6. Renovaciones. Teams recalcula el cobro según el conteo de miembros en vivo antes de cada renovación (true-up de asientos). Pro es fijo.
7. Si falla un cobro el plan pasa a past_due; actualizá la tarjeta en /billing para reintentar y restaurar acceso.
8. Cancelá cuando quieras — mantenés acceso hasta el fin del período. Los admins pueden emitir reembolsos.

Cada paso se detalla abajo.

Planes

ID del plan	Nombre	Precio	Mín. asientos	Tier desbloqueado
plan_pro_monthly	Pro	USD 12/mes	1	pro
plan_pro_annual	Pro	USD 100/año (~USD 8,33/mes)	1	pro
plan_teams_monthly	Teams	USD 15/miembro activo/mes	2 (mínimo facturado)	team
plan_teams_annual	Teams	USD 120/miembro activo/año (~USD 10/mes)	2 (mínimo facturado)	team

Listar planes disponibles (público):

GET /v1/billing/plans

Empezar una suscripción

En la app

1. Abrí shareout.site/teams/pricing y elegí un plan.
2. Checkout en /checkout?plan={plan_id} — elegí el workspace (Teams factura por miembro activo; ver abajo).
3. Arranca la prueba gratis de 15 días. No hace falta tarjeta el primer día.
4. Gestioná la facturación en /billing?workspace_id={id} — agregá tarjeta con el checkout embebido de Rebill, mirá facturas, cancelá.

Los dueños y admins del workspace pueden suscribirse y gestionar métodos de pago.

Por API

POST /v1/billing/subscribe
Authorization: Bearer {token}
Content-Type: application/json

{
  "workspace_id": "ws_abc123",
  "plan_id": "plan_teams_monthly",
  "seats": 3
}

La respuesta incluye subscription_id, status (trialing), trial_ends_at y has_card.

Reglas de la prueba:

• Una prueba gratis por workspace, para siempre — una suscripción cancelada o vencida también cuenta.
• Después de la prueba, si hay tarjeta guardada se cobra automáticamente. Sin tarjeta, el acceso de pago se suspende hasta que agregues una.

Método de pago

Agregá o actualizá la tarjeta en /billing. ShareOut usa el checkout embebido Rebill v3 en el navegador — el web component <rebill-checkout> para suscripciones nuevas y <rebill-save-card> durante la prueba. Los datos de tarjeta quedan en el ámbito PCI de Rebill; ShareOut solo guarda IDs de cliente/suscripción de Rebill.

La página de billing llama a estos endpoints de sesión tras un checkout exitoso:

POST /v1/billing/rebill-activate
{ "subscription_id": "sub_xyz789", "rebill_subscription_id": "…", "rebill_customer_id": "…" }

POST /v1/billing/rebill-save-card
{ "subscription_id": "sub_xyz789", "rebill_card_id": "…", "rebill_customer_id": "…" }

Queda un camino legacy POST /v1/billing/card con token para suscripciones dLocal en migración.

Una vez guardada la tarjeta, la página muestra la marca y los últimos cuatro dígitos.

Ciclo de vida de la suscripción

Estado	Significado
trialing	Prueba gratis activa. Tarjeta opcional hasta que termine.
active	Pagado y al día.
past_due	Falló el último cobro — actualizá la tarjeta para restaurar acceso.
cancelled	Cancelada; el acceso sigue hasta current_period_end.
expired	Prueba o suscripción terminó sin pago.

Consultar estado:

GET /v1/billing/subscription?workspace_id={id}
Authorization: Bearer {token}

Teams: facturación por miembro

Teams se factura por miembro activo del workspace, no por un pool fijo de asientos que comprás de antemano:

• El checkout y la página de billing muestran el conteo actual de miembros (mínimo 2).
• Agregá o quitá miembros cuando quieras — cada renovación cobra el headcount en vivo.
• Antes de renovar, Rebill ajusta el monto recurrente (true-up de asientos).

Pro es siempre un asiento. El campo seats en POST /v1/billing/subscribe se acepta por compatibilidad de API, pero Teams sigue el conteo de miembros.

Los miembros externos son gratis. Las personas que invitás como Clientes (compartir con externos) nunca cuentan para asientos ni cargos de renovación. La página de billing los muestra en una línea aparte “Miembros externos — incluidos”. Ver Compartir con clientes.

Convertir Pro → Teams (sumar gente)

Un workspace Pro es de un solo usuario. Para sumar compañeros, pasá el workspace a Teams. En /billing, la sección Cambiar plan muestra los otros tiers en tu intervalo de facturación actual:

• Upgrade (Pro → Teams) aplica al instante — miembros, subdominio del workspace y gobernanza se habilitan en el momento. Tu próxima renovación cobra el nuevo plan (Teams: miembros activos × precio por asiento); el período parcial actual no se prorratea.
• Cambiar (Teams → Pro, un downgrade) se difiere a la próxima renovación, así mantenés lo que pagaste hasta que termine el período.

PATCH /v1/billing/subscription/plan
{ "subscription_id": "sub_xyz789", "plan_id": "plan_teams_monthly" }

La respuesta indica qué camino se tomó: { "applied": "immediate" } para un upgrade, o { "applied": "next_renewal", "pending_plan_id": "…" } para un downgrade diferido. Enterprise es por ventas — escribinos.

Cambiar asientos

Los cambios manuales de asientos aplican en el próximo ciclo de facturación (guardados como pending_seats). En Teams, sumá o quitá miembros — el true-up en la renovación cobra el headcount en vivo automáticamente.

PATCH /v1/billing/subscription/seats
{ "subscription_id": "sub_xyz789", "seats": 5 }

Recuperar un pago fallido (dunning)

Si falla un cobro de renovación, la suscripción pasa a past_due y se retienen las funciones de pago. La página /billing muestra entonces un formulario Actualizar método de pago — incluso con una tarjeta ya guardada — para que el dueño ingrese una nueva. Un checkout exitoso reintenta el cobro y restaura active.

Cancelar

DELETE /v1/billing/subscription
{ "subscription_id": "sub_xyz789" }

Devuelve access_until — la fecha hasta la cual siguen las funciones de pago.

Facturas

GET /v1/billing/invoices?workspace_id={id}
Authorization: Bearer {token}

Devuelve el historial de pagos (amount_cents, currency, status, invoice_number, paid_at).

Reembolsos

Un admin de ShareOut puede reembolsar una factura pagada (total o parcial). El reembolso se emite en el procesador de pagos y el status de la factura pasa a refunded; las facturas reembolsadas se excluyen de los ingresos. Los reembolsos hechos directamente en el procesador se reconcilian solos (vía el webhook payment.updated → refunded). No hay endpoint de autoservicio — contactá a soporte.

Planes de cortesía

Los admins de ShareOut pueden otorgar un plan de pago de cortesía — acceso completo Pro o Teams sin tarjeta ni cargos. La página de billing muestra una insignia de cortesía en lugar de controles de pago.

Tier de cuenta vs suscripción

GET /v1/account/tier sigue devolviendo el tier efectivo del usuario y los feature flags (derivados de suscripciones activas). Para upgrades en producción, usá checkout o POST /v1/billing/subscribe — no el endpoint legacy POST /v1/account/upgrade (solo dev/testing).

Ver Visión general de Teams para cómo el tier mapea a las funciones habilitadas.

Crédito de IA incluido

El uso de IA con clave de plataforma (asistente del workspace, chat visitante en artifacts, Page Pilot, runs de crew con clave de ShareOut) consume un crédito mensual incluido por workspace, que se reinicia cada mes calendario UTC. Las claves BYO son ilimitadas y no consumen este pool.

Tier	Crédito incluido
Free	USD 0,50 / mes
Pro	USD 5 / mes
Teams	USD 10 × miembros activos / mes
Cortesía / Enterprise	Ilimitado (exento)

Cuando el crédito se agota, las sesiones nuevas de IA devuelven HTTP 402 con código AI_CREDIT_EXHAUSTED hasta el mes siguiente, que actualices el plan o agregues una clave bring-your-own en la configuración de IA del workspace. Seguir una conversación ya abierta sigue permitido.

El gasto y el saldo restante aparecen en la página Usage del workspace (GET /v1/workspaces/{id}/llm-config incluye aiCreditUsd, aiCreditRemainingUsd, aiCreditAllowed).

Durante la prueba, agregá una tarjeta antes del día 15 para evitar cortes. Si ya hay tarjeta guardada, el banner de prueba confirma que se cobrará automáticamente al terminar.