# Créditos

> La moneda de reserva de la comunidad. De dónde vienen los créditos (plan cada mes, producto suelto y concesión del equipo), lotes y validez, el cambio de mes, acumulación, cancelación tardía y ausencia, la pestaña Créditos del perfil, Mis créditos, las reglas de la comunidad y quién puede qué.

Los **créditos** son la moneda interna que el miembro gasta para **reservar** salas, mesas y horarios de personas ([Reservas](/espacos/reservas) y [Agendamiento](/espacos/agendamento)). Un crédito **no es dinero**: no se retira, no se transfiere y no pasa por el checkout. La comunidad define cuánto cuesta cada sala en créditos, y el miembro recibe créditos por su plan, por un producto o del equipo.

## Para qué sirve

| Comunidad | Cómo usa los créditos |
|---|---|
| Coworking | El plan **Residente** da 40 créditos al mes; la sala de reuniones cuesta 3 créditos cada 30 minutos |
| Espacio de estudio | Un paquete suelto de 20 créditos, válido por 90 días, para quien no quiere suscribirse |
| Mentoría | El equipo concede créditos de cortesía a quien hizo su primera compra |
| Asociación | Cada socio recibe créditos cada mes para usar el auditorio |

## Cómo funciona

### De dónde vienen los créditos

| Origen | Cómo llega | Aparece en el extracto como |
|---|---|---|
| **Plan** | Cada mes, para cada suscripción activa del plan que tiene **Créditos por mes** | Plan |
| **Producto suelto** | Una vez, al completarse la compra | Producto |
| **Concesión manual** | El equipo da créditos a un miembro, con un motivo | Equipo |

**Plan.** Cada suscripción **activa** (o en período de prueba) de un plan con créditos por mes recibe la cuota del mes, y el plan anual la recibe **mes a mes** de la misma manera. Los créditos del plan valen **hasta el cambio de mes**, a medianoche en la zona horaria de la comunidad. Quien cambia a un plan con más créditos recibe **solo la diferencia**; quien cambia a un plan con menos no pierde lo que ya tiene. Cancelar al momento o reembolsar la suscripción retira lo que aún no se ha usado.

**Producto suelto.** Un producto **digital de pago único** puede conceder créditos en la compra, con una validez en días (en blanco, no vencen). Un producto que ya está **incluido en un plan** no concede créditos. El reembolso o el contracargo de la compra retira los créditos que concedió (lo que aún no se ha usado).

**Concesión manual.** El equipo abre un lote nuevo para el miembro, con **motivo obligatorio** y validez opcional (consulta [Quién puede qué](#quien-puede-que)).

### Lotes y validez

Cada concesión abre un **lote**, con su validez. El **saldo** es la suma de los lotes que **aún no han vencido**. Cuando el miembro reserva, el costo sale **primero del lote que vence antes**, y un reembolso vuelve al mismo lote (si ya venció, vuelve en un lote nuevo, válido por 30 días). El extracto nunca se borra ni se edita: un error se corrige con un nuevo movimiento.

El extracto muestra cada movimiento con su tipo:

| Tipo | Qué es |
|---|---|
| **Concesión** | Un lote nuevo (plan, producto o equipo) |
| **Uso en una reserva** | El costo de una reserva |
| **Reembolso** | Créditos devueltos por cancelación, reprogramación o bloqueo |
| **Ajuste** | Corrección hecha por el equipo, con el motivo |
| **Vencimiento** | Lo que venció sin usarse |
| **Revocación** | Créditos retirados (por un reembolso, por ejemplo) |

### El cambio de mes

Los créditos del plan vencen a las **00:00 del día 1**, en la **zona horaria de la comunidad** (no en la de quien mira). Por defecto **no hay acumulación**: lo que sobra del plan vence con el cambio de mes y el mes siguiente empieza con la cuota nueva.

Con la **acumulación** activada, lo que sobra pasa al mes siguiente, respetando:

- el **tope** de lo que puede pasar de un mes a otro (en blanco, sin tope);
- los **meses de vida de lo acumulado**, de 1 a 12.

El cambio vale **desde el próximo cambio de mes** y nunca altera un lote que ya existe.

### Cancelación tardía y ausencia

Cada reserva tiene un **plazo de cancelación**, de **24 horas** por defecto (de 0 a 720; la sala puede tener el suyo). Quien cancela o reprograma **dentro del plazo** (con 24 h o más de antelación) recupera todo.

| Situación | Por defecto |
|---|---|
| Cancelación **después** del plazo (tardía) | El miembro **pierde** los créditos |
| **Ausencia (no-show)**, marcada por el equipo o por el anfitrión | El miembro **pierde** los créditos |
| Cancelación por el **equipo** o por el anfitrión | Siempre se reembolsa completa |
| Sala eliminada u horario bloqueado con reservas | Siempre se reembolsa completa |

Cada regla de pérdida es un interruptor en las [reglas de la comunidad](#las-reglas-de-la-comunidad): desactivado, el crédito vuelve incluso en la cancelación tardía o en la ausencia.

### Suscripción pausada o impagada

Una suscripción **pausada** o **impagada** **no recibe el mes nuevo** de créditos. En cuanto al saldo que la persona ya tiene, **por defecto puede seguir usándolo**, también para reservar. Es una regla de la plataforma, no una opción de la comunidad: no aparece en la configuración. Cuando la suscripción vuelve a estar activa, la persona recibe los créditos del mes en curso.

## Dónde verlo

### La pestaña Créditos del perfil

En el perfil de un miembro, la pestaña **Créditos** muestra:

- el **saldo** y lo que **vence pronto**;
- los **lotes**, con el origen, cuánto queda de cada uno y la validez (o "no vence");
- el **extracto**, del más nuevo al más antiguo, con quién hizo cada movimiento y el motivo.

El miembro ve **solo su pestaña**; el equipo (propietario, administrador, moderador y finanzas) ve la de **cualquier miembro**. El moderador solo ve: los botones **Conceder créditos** y **Ajustar saldo** aparecen para el propietario, el administrador y finanzas.

### Mis créditos

El miembro abre **Mi cuenta › Créditos** (**Mis créditos**) y ve el mismo panel: saldo, lotes y extracto. Sin créditos, la pantalla explica de dónde llegan (plan, productos o concesión del equipo).

### Las reglas de la comunidad

**Configuración › Créditos** reúne las reglas (solo el propietario y el administrador las cambian):

| Campo | Qué hace | Por defecto |
|---|---|---|
| **Acumular los créditos del plan para el mes siguiente** | Activa la acumulación | Desactivado |
| **Tope de lo que pasa de un mes a otro** | El máximo que se puede acumular | Sin tope |
| **Meses de vida de lo acumulado** | Por cuántos meses lo acumulado sigue valiendo (1 a 12) | 1 |
| **En el primer mes, conceder la parte proporcional a los días que quedan** | Quien se suscribe a mitad de mes recibe solo los días restantes | Desactivado |
| **Plazo para cancelar o cambiar (horas)** | Antelación para cancelar sin perder (0 a 720) | 24 |
| **La cancelación tardía pierde el crédito** | Cancelar dentro del plazo no devuelve | Activado |
| **La ausencia (no-show) pierde el crédito** | Quien no se presenta no recupera los créditos | Activado |

## Paso a paso

### Dar créditos mensuales a un plan

1. Abre **Monetización › Planes** y crea o edita el plan.
2. En el campo **Créditos por mes**, indica la cantidad. **0** significa que el plan no concede créditos.
3. Guarda. Cada suscripción activa recibe la cuota cada mes, hasta el cambio de mes en la zona horaria de la comunidad.

### Dar créditos en la compra de un producto

1. Abre el producto (digital, de pago único).
2. En **Créditos concedidos en la compra**, indica la cantidad (0 = no concede).
3. En **Validez de los créditos (días)**, indica los días, contados desde la compra. En blanco, los créditos **no vencen**.

> [!NOTE]
> Los créditos solo funcionan en una comunidad que tiene un espacio de **Reservas** o de **Agendamiento**. Sin él, la app avisa debajo del campo: *"Los créditos solo funcionan en una comunidad con un space de Reservas o de Agendamiento. Crea uno primero y luego define los créditos."* Crea el espacio y vuelve al plan o al producto.

### Conceder o ajustar los créditos de un miembro

1. Abre el perfil del miembro y la pestaña **Créditos**.
2. **Conceder créditos** abre un lote nuevo: indica la **cantidad**, el **motivo** (obligatorio, aparece en el extracto) y, si quieres, la **validez** (el último día vale hasta las 23:59 en la zona horaria de la comunidad).
3. **Ajustar saldo** corrige el saldo: elige **Añadir** o **Quitar**, la cantidad y el motivo. Quitar pide una segunda confirmación, consume primero los lotes que vencen antes y **no puede superar el saldo utilizable**.

## Quién puede qué

| Acción | Propietario | Administrador | Finanzas | Moderador | Miembro |
|---|---|---|---|---|---|
| Ver su propio saldo y extracto | ✔ | ✔ | ✔ | ✔ | ✔ |
| Ver el saldo y el extracto de cualquier miembro | ✔ | ✔ | ✔ | ✔ | — |
| Conceder créditos y ajustar el saldo | ✔ | ✔ | ✔ | — | — |
| Ver las reglas de la comunidad | ✔ | ✔ | ✔ | ✔ | — |
| Cambiar las reglas de la comunidad | ✔ | ✔ | — | — | — |
| Reservar con **cortesía** (sin débito) | ✔ | ✔ | — | — | — |

La **cortesía** es una reserva que no debita nada, siempre con un motivo; solo la usan el propietario y el administrador (consulta [Reservas](/espacos/reservas#reservar-a-nombre-de-otra-persona)).

## Errores comunes y cómo resolverlos

| Situación | Qué hacer |
|---|---|
| El campo de créditos del plan o del producto muestra el aviso del espacio | Crea primero un espacio de Reservas o de Agendamiento |
| *"Te faltan N créditos para esta reserva"* | El miembro necesita más créditos: el equipo se los concede, o elige un horario más barato |
| No puedo quitar créditos | El saldo utilizable es menor que lo pedido; quita como máximo el saldo |
| Cambié la acumulación y no cambió nada en el lote actual | La regla vale desde el próximo cambio de mes y no altera lotes que ya existen |
| El producto no concede créditos | Solo concede un producto **digital de pago único**, y no si está incluido en un plan |

## Preguntas frecuentes

**¿El crédito es dinero?** No. Solo paga reservas dentro de la comunidad; no se retira ni se transfiere.

**¿El miembro ve cuándo vencen sus créditos?** Sí: el saldo muestra lo que vence pronto y cada lote muestra la fecha.

**¿Qué pasa con los créditos si se cancela la suscripción?** La cancelación inmediata y el reembolso retiran lo que no se ha usado.

**¿Puedo cambiar después el costo de una sala?** Sí. Las reservas ya hechas conservan el costo que tenían.

## En la API y en el MCP

Las rutas están en `/api/credits` (saldo, extracto, concesiones, ajustes y reglas), documentadas en la [referencia de la API](/api/referencia). El asistente hace todo esto desde la conversación: consulta [Herramientas · Créditos](/mcp/ferramentas-creditos).

## Relacionados

- [Reservas](/espacos/reservas)
- [Agendamiento](/espacos/agendamento)
- [Planes](/monetizacao/planos)
- [Productos](/monetizacao/produtos)
- [Roles y permisos](/conceitos/papeis-e-permissoes)