# Gestión de suscripciones

> La vista del equipo sobre quién se suscribe a qué. Listar y filtrar las suscripciones, ver el historial de cada una, cancelar, reactivar, dar un descuento, incluir adicionales, extender el período, enviar un enlace de pago y crear suscripciones de cortesía, todo con registro de quién lo hizo.

La **gestión de suscripciones** es la lista de todas las suscripciones de la comunidad, con las acciones del equipo sobre cada una. La [Facturación](/pagamentos/faturamento-do-membro) es la vista de quien paga; la gestión de suscripciones es la de quien administra.

Está en **Miembros › Suscripciones**: *"Quién se suscribe a qué, cuánto paga y cuándo es el próximo cobro."* Quien se suscribe es gente, por eso la pestaña está junto al resto de las personas de la comunidad.

> [!NOTE]
> **Cambió de lugar el 6 de octubre de 2026.** La pestaña estaba en **Monetización**. El enlace antiguo (`/monetization?tab=subscribers`) lleva directamente a **Miembros › Suscripciones**.

## Para qué sirve

| El equipo necesita… | En la gestión de suscripciones |
|---|---|
| Saber quién está atrasado | Filtrar por **Atrasada** |
| Ver quién canceló este mes | Filtrar por **Cancelando** o **Cancelada** y por período |
| Dar el plan a un ponente o socio | Crear una suscripción de **cortesía** |
| Cerrar un acuerdo con alguien en dificultades | Dar un **descuento** por un tiempo, o **extender** el período |
| Cobrar a quien está atrasado | **Enviar enlace de pago** |
| Enviar la lista al equipo financiero | **Exportar CSV** |

## Quién puede

**Propietario**, **administrador** y **finanzas**. Los tres lo ven todo y hacen todas las acciones. Moderadores y miembros no tienen acceso.

Finanzas llega por el elemento **Miembros** del menú: se abre directamente en **Suscripciones** y no ve las otras pestañas de Miembros.

Toda acción queda registrada: quién la hizo, cuándo, qué cambió, cómo estaba antes y cómo quedó.

## Cómo funciona

### La lista

Cada fila muestra el miembro (nombre y correo), el plan y la opción, el estado, el importe (con el descuento, si lo hay), los adicionales, la forma de pago, el próximo cobro, el contrato y la renovación pendiente, si la hay.

| Estado | Qué significa |
|---|---|
| **Activa** | Al día |
| **En prueba** | En el período de prueba gratis |
| **Atrasada** | La renovación no se pagó |
| **Pausada** | Suspendida por el equipo |
| **Cancelando** | Cancelada, pero con acceso hasta el final del período pagado |
| **Cancelada** / **Finalizada** | Terminó |
| **Cortesía** | Creada por el equipo, sin cobro |

Las columnas son **Miembro**, **Plan · opción**, **Estado**, **Importe**, **Próximo cobro** y **Método**. Una suscripción con un PIX o boleto de renovación sin pagar muestra *"Esperando el pago"*.

Los filtros son el estado (en píldoras), **Plan u opción**, **Inicio desde** e **Inicio hasta** (por la fecha de inicio de la suscripción) y **Buscar por nombre o correo**. **Exportar CSV** descarga la lista con los mismos filtros, hasta 5.000 filas.

### El detalle

**Ver detalles** abre la suscripción: la barra de acciones (que cambia según el estado), los adicionales, el historial de cobros y la línea de tiempo con los eventos (creada, cobro pagado, cobro rechazado, cancelada, finalizada) y cada acción del equipo, diciendo quién la hizo (*"El propietario"*, *"Un administrador"*, *"El equipo financiero"*).

### Las acciones

| Acción | Qué hace |
|---|---|
| **Cancelar suscripción** | **Al final del período** (el miembro mantiene el acceso hasta entonces y no se le cobra de nuevo) o **Ahora** (el acceso termina en ese momento). El motivo es opcional y queda en la línea de tiempo. No se reembolsa nada de lo ya pagado |
| **Reactivar** | Revierte una cancelación mientras el período pagado no ha terminado: la suscripción vuelve a cobrarse en la próxima fecha |
| **Aplicar descuento** | Un porcentaje a partir del próximo cobro, hasta una fecha o mientras dure la suscripción. **Eliminar descuento** vuelve al precio completo en el próximo cobro |
| **Añadir adicional** | Suma un [adicional](/monetizacao/adicionais) sin cobrar ahora: entra a partir del próximo cobro del plan |
| **Eliminar** (adicional) | **Al final del período** o **Ahora**. Solo sale el adicional; el plan sigue |
| **Extender período** | **Por días** (de 1 a 3.650) o **Hasta una fecha**. El tiempo extra no se cobra, y el próximo cobro se ajusta |
| **Enviar enlace de pago** | Envía al miembro un correo con **Pagar o registrar tarjeta**, que lleva a su Facturación. No se cobra nada sin que la persona lo confirme |

Toda acción pide confirmación antes.

Cambiar al miembro de plan o de opción de cobro todavía no es una acción del equipo.

### Crear una suscripción

Para dar un plan a alguien sin pasar por el checkout:

| Modo | Para qué | Qué pasa |
|---|---|---|
| **Cortesía** | Ponente, socio, intercambio, beca | Sin cobro y sin registro en el extracto. Con **Con fecha de fin**, la suscripción termina sola en **Cortesía hasta**, sin cobrar; sin fecha, sigue hasta que el equipo la cancele |
| **Empieza a cobrar el** | Pago acordado por otro canal hasta una fecha, o un período de gracia | Gratis hasta la fecha elegida; después, se cobra como cualquier suscripción, con PIX, boleto o tarjeta |

Reactivar una cortesía con fecha de fin que se canceló la convierte en una suscripción de pago: a partir del final del período, pasa a cobrarse.

La persona tiene que ser miembro de la comunidad. Si ya está suscrita a la misma opción, la creación se rechaza: *"Este miembro ya está suscrito a esta opción."*

## Paso a paso: cortesía para un ponente

*Rol: propietario, administrador o finanzas.*

1. **Miembros › Suscripciones**, **Nueva suscripción** (*"Da una suscripción a un miembro sin pasar por el checkout."*).
2. En **Miembro**, busca por nombre o correo.
3. En **Plan y opción**, elige *Growth · Mensual*.
4. En **Cómo queda el cobro**, **Cortesía**; marca **Con fecha de fin** y elige el 31/12 en **Cortesía hasta**.
5. Si quieres, escribe una nota (*"Ponente del congreso"*).
6. Confirma. La suscripción aparece como **Cortesía**, y el ponente empieza a ver los espacios del plan.

## Ejemplos

**Ana se atrasó y pidió un mes.** El equipo financiero abre su suscripción, usa **Extender período** en 30 días y escribe el motivo. El próximo cobro pasa al mes siguiente, sin cobrar el mes concedido.

**Descuento de retención.** Bruno iba a cancelar. El equipo usa **Aplicar descuento**: 20% hasta final de año. Los próximos cobros salen un 20% más baratos, y el descuento aparece en su Facturación.

**Coworking que cobra el primer mes por otro canal.** Un residente pagó el primer mes en efectivo. El equipo crea la suscripción con **Empieza a cobrar el**, con el cobro empezando el día 10 del mes siguiente, con tarjeta.

## Mensajes

| Mensaje | Qué hacer |
|---|---|
| *Este miembro ya está suscrito a esta opción.* | Abre la suscripción que ya existe |
| *Esta suscripción ya terminó.* | Crea una suscripción nueva |
| *Esta suscripción ya termina al final del periodo.* | Para revertirlo, usa **Reactivar** |
| *El periodo de esta suscripción ya terminó.* | No se puede reactivar; crea una nueva |
| *El descuento debe ser mayor que 0% y menor que 100%…* | Usa un porcentaje entre 0 y 100, con hasta dos decimales |
| *Esto es un complemento; abre la suscripción del plan.* | Las acciones de adicionales están en la suscripción del plan |
| *La nueva fecha debe ser posterior al final del periodo actual.* | Elige una fecha más lejana |
| *No se pudo enviar el enlace: el miembro no tiene correo.* | Habla con el miembro por otro canal |

## Preguntas frecuentes

**¿La cortesía aparece en las ventas?**
No. Una cortesía no genera cobro ni registro en el extracto.

**¿El equipo financiero también puede cancelar?**
Sí. Propietario, administrador y finanzas tienen las mismas acciones, y todas quedan registradas con el nombre de quien las hizo.

**¿El equipo ve cuánto cobra el procesador de pagos?**
No. La gestión de suscripciones muestra los importes del miembro y de la comunidad, con la comisión de la plataforma; nunca costes internos.

## En la API

En `/api/manage/subscriptions`, con la comunidad en la cabecera `X-CommunityId`:

- `GET /` lista, con `status`, `productId`, `subscriptionGroupId`, `from`, `to`, `search`, `page` y `limit`.
- `GET /export.csv` exporta.
- `GET /{subscriptionId}` devuelve el detalle, con `charges`, `events` y `addOnSubscriptions`.
- `POST /` crea, con `profileId`, `productId`, `mode` (`COMPLIMENTARY` o `FUTURE_CHARGE`), `complimentaryUntil`, `chargeStartsAt`, `paymentMethod` y `note`.
- Las acciones son:
  - `POST /{id}/cancel` y `POST /{id}/reactivate`;
  - `PUT` y `DELETE /{id}/discount`;
  - `POST /{id}/add-ons` y `DELETE /{id}/add-ons/{addOnSubscriptionId}`;
  - `POST /{id}/extend`;
  - `POST /{id}/payment-link`.

## Relacionados

- [Facturación del miembro](/pagamentos/faturamento-do-membro)
- [Pagar ahora](/pagamentos/pagar-agora)
- [Renovación](/pagamentos/renovacao)
- [Roles y permisos](/conceitos/papeis-e-permissoes)