# Créditos

> A moeda de reserva da comunidade. De onde vêm os créditos (plano todo mês, produto avulso e concessão da equipe), lotes e validade, a virada do mês, acúmulo, cancelamento tardio e ausência, a aba Créditos no perfil, Meus créditos, as regras da comunidade e quem pode o quê.

**Créditos** são a moeda interna que o membro gasta para **reservar** salas, mesas e horários de pessoas ([Reservas](/espacos/reservas) e [Agendamento](/espacos/agendamento)). Crédito **não é dinheiro**: não se saca, não se transfere e não passa pelo checkout. A comunidade define quanto cada sala custa em créditos, e o membro recebe créditos pelo plano, por um produto ou da equipe.

## Para que serve

| Comunidade | Como usa os créditos |
|---|---|
| Coworking | O plano **Residente** dá 40 créditos por mês; a sala de reunião custa 3 créditos a cada 30 minutos |
| Espaço de estudo | Um pacote avulso de 20 créditos, válido por 90 dias, para quem não quer assinar |
| Mentoria | A equipe concede créditos de cortesia a quem fez a primeira compra |
| Associação | Cada associado ganha créditos todo mês para usar o auditório |

## Como funciona

### De onde vêm os créditos

| Origem | Como chega | Aparece no extrato como |
|---|---|---|
| **Plano** | Todo mês, para cada assinatura ativa do plano que tem **Créditos por mês** | Plano |
| **Produto avulso** | Uma vez, quando a compra é concluída | Produto |
| **Concessão manual** | A equipe dá créditos a um membro, com um motivo | Equipe |

**Plano.** Cada assinatura **ativa** (ou em período de teste) de um plano com créditos por mês recebe o mês que falta, e o plano anual recebe **mês a mês** do mesmo jeito. Os créditos do plano valem **até a virada do mês**, à meia-noite do fuso da comunidade. Quem troca para um plano com mais créditos recebe **só a diferença**; quem troca para um plano com menos não perde o que já tem. Cancelar na hora ou reembolsar a assinatura retira o que ainda não foi usado.

**Produto avulso.** Um produto **digital de pagamento único** pode conceder créditos na compra, com uma validade em dias (em branco, não vencem). Produto que já está **incluído em um plano** não concede créditos. Reembolso ou contestação da compra retira os créditos que ela concedeu (o que ainda não foi usado).

**Concessão manual.** A equipe abre um lote novo para o membro, com **motivo obrigatório** e validade opcional (ver [Quem pode o quê](#quem-pode-o-que)).

### Lotes e validade

Cada concessão abre um **lote**, com a sua validade. O **saldo** é a soma dos lotes que **ainda não venceram**. Quando o membro reserva, o custo sai **primeiro do lote que vence antes**, e um estorno volta ao mesmo lote (se ele já venceu, volta num lote novo, válido por 30 dias). O extrato nunca é apagado nem editado: um erro se corrige com um novo lançamento.

O extrato mostra cada lançamento com o tipo:

| Tipo | O que é |
|---|---|
| **Concessão** | Um lote novo (plano, produto ou equipe) |
| **Uso em reserva** | O custo de uma reserva |
| **Estorno** | Créditos devolvidos por cancelamento, remarcação ou bloqueio |
| **Ajuste** | Correção feita pela equipe, com o motivo |
| **Expiração** | O que venceu sem uso |
| **Revogação** | Créditos retirados de volta (reembolso, por exemplo) |

### A virada do mês

Os créditos do plano vencem à **00:00 do dia 1**, no **fuso da comunidade** (não no de quem olha). Por padrão **não há acúmulo**: o que sobra do plano vence na virada e o mês seguinte começa com a cota nova.

Com o **acúmulo** ligado, o que sobra passa para o mês seguinte, respeitando:

- o **teto** do que pode passar de um mês para o outro (em branco, sem teto);
- os **meses de vida do acumulado**, de 1 a 12.

A mudança vale **da próxima virada do mês em diante** e nunca altera um lote que já existe.

### Cancelamento tardio e ausência

Cada reserva tem uma **janela de cancelamento**, de **24 horas** por padrão (de 0 a 720; a sala pode ter a sua). Quem cancela ou remarca **dentro da janela** (com 24 h ou mais de antecedência) recebe tudo de volta.

| Situação | Por padrão |
|---|---|
| Cancelamento **depois** da janela (tardio) | O membro **perde** os créditos |
| **Ausência (no-show)**, marcada pela equipe ou pelo anfitrião | O membro **perde** os créditos |
| Cancelamento pela **equipe** ou pelo anfitrião | Sempre estorna por inteiro |
| Sala excluída ou horário bloqueado com reservas | Sempre estorna por inteiro |

Cada regra de perda é um interruptor nas [regras da comunidade](#as-regras-da-comunidade): desligado, o crédito volta mesmo no cancelamento tardio ou na ausência.

### Assinatura pausada ou inadimplente

Uma assinatura **pausada** ou **inadimplente** **não recebe o mês novo** de créditos. Quanto ao saldo que a pessoa já tem, **por padrão ela continua usando**, inclusive para reservar. Essa é uma regra da plataforma, não uma opção da comunidade: não aparece nas configurações. Quando a assinatura volta a ficar ativa, a pessoa recebe os créditos do mês corrente.

## Onde ver

### A aba Créditos no perfil

No perfil de um membro, a aba **Créditos** mostra:

- o **saldo** e o que **vence em breve**;
- os **lotes**, com a origem, quanto resta de cada um e a validade (ou "não vence");
- o **extrato**, do mais novo ao mais antigo, com quem fez cada lançamento e o motivo.

O membro vê **só a aba dele**; a equipe (proprietário, administrador, moderador e financeiro) vê a de **qualquer membro**. O moderador só vê: os botões **Conceder créditos** e **Ajustar saldo** aparecem para o proprietário, o administrador e o financeiro.

### Meus créditos

O membro abre **Minha conta › Créditos** (**Meus créditos**) e vê o mesmo painel: saldo, lotes e extrato. Sem créditos, a tela explica de onde eles chegam (plano, produtos ou concessão da equipe).

### As regras da comunidade

**Configurações › Créditos** reúne as regras (só o proprietário e o administrador alteram):

| Campo | O que faz | Padrão |
|---|---|---|
| **Acumular créditos do plano para o mês seguinte** | Liga o acúmulo | Desligado |
| **Teto do que passa de um mês para o outro** | O máximo que pode ser acumulado | Sem teto |
| **Meses de vida do acumulado** | Por quantos meses o acumulado ainda vale (1 a 12) | 1 |
| **No primeiro mês, conceder o proporcional aos dias restantes** | Quem assina no meio do mês recebe só os dias que faltam | Desligado |
| **Janela para cancelar ou alterar (horas)** | Antecedência para cancelar sem perder (0 a 720) | 24 |
| **Cancelamento tardio perde o crédito** | Cancelar dentro da janela não devolve | Ligado |
| **Falta (no-show) perde o crédito** | Quem não aparece não recebe de volta | Ligado |

## Passo a passo

### Dar créditos mensais a um plano

1. Abra **Monetização › Planos** e crie ou edite o plano.
2. No campo **Créditos por mês**, informe a quantidade. **0** significa que o plano não concede créditos.
3. Salve. Cada assinatura ativa passa a receber a cota todo mês, até a virada do mês no fuso da comunidade.

### Dar créditos na compra de um produto

1. Abra o produto (digital, de pagamento único).
2. Em **Créditos concedidos na compra**, informe a quantidade (0 = não concede).
3. Em **Validade dos créditos (dias)**, informe os dias, contados a partir da compra. Em branco, os créditos **não vencem**.

> [!NOTE]
> Créditos só funcionam numa comunidade que tem um espaço de **Reservas** ou de **Agendamento**. Sem ele, o app avisa embaixo do campo: *"Créditos só funcionam em uma comunidade com um space de Reservas ou de Agendamento. Crie um primeiro e depois defina os créditos."* Crie o espaço e volte ao plano ou ao produto.

### Conceder ou ajustar créditos de um membro

1. Abra o perfil do membro e a aba **Créditos**.
2. **Conceder créditos** abre um lote novo: informe a **quantidade**, o **motivo** (obrigatório, aparece no extrato) e, se quiser, a **validade** (o último dia vale até 23:59 no fuso da comunidade).
3. **Ajustar saldo** corrige o saldo: escolha **Adicionar** ou **Remover**, a quantidade e o motivo. Remover pede uma segunda confirmação, consome primeiro os lotes que vencem antes e **não pode passar do saldo utilizável**.

## Quem pode o quê

| Ação | Proprietário | Administrador | Financeiro | Moderador | Membro |
|---|---|---|---|---|---|
| Ver o próprio saldo e extrato | ✔ | ✔ | ✔ | ✔ | ✔ |
| Ver o saldo e o extrato de qualquer membro | ✔ | ✔ | ✔ | ✔ | — |
| Conceder créditos e ajustar o saldo | ✔ | ✔ | ✔ | — | — |
| Ver as regras da comunidade | ✔ | ✔ | ✔ | ✔ | — |
| Alterar as regras da comunidade | ✔ | ✔ | — | — | — |
| Reservar com **cortesia** (sem débito) | ✔ | ✔ | — | — | — |

A **cortesia** é uma reserva que não debita nada, sempre com um motivo; só o proprietário e o administrador a usam (ver [Reservas](/espacos/reservas#reservar-em-nome-de-alguem)).

## Erros comuns e como resolver

| Situação | O que fazer |
|---|---|
| O campo de créditos do plano ou do produto mostra o aviso de espaço | Crie um espaço de Reservas ou de Agendamento primeiro |
| *"Faltam N créditos para esta reserva"* | O membro precisa de mais créditos: a equipe concede, ou ele escolhe um horário mais barato |
| Não consigo remover créditos | O saldo utilizável é menor do que o pedido; remova no máximo o saldo |
| Mudei o acúmulo e nada mudou no lote de agora | A regra vale da próxima virada do mês e não altera lotes que já existem |
| O produto não concede créditos | Só produto **digital de pagamento único** concede, e não se estiver incluído num plano |

## Perguntas frequentes

**Crédito é dinheiro?** Não. Ele só paga reserva dentro da comunidade; não se saca nem se transfere.

**O membro vê quando os créditos vencem?** Sim: o saldo mostra o que vence em breve e cada lote mostra a data.

**O que acontece com os créditos se a assinatura é cancelada?** O cancelamento imediato e o reembolso retiram o que não foi usado.

**Posso mudar o custo de uma sala depois?** Sim. As reservas já feitas mantêm o custo que tinham.

## Na API e no MCP

As rotas ficam em `/api/credits` (saldo, extrato, concessões, ajustes e regras), documentadas na [referência da API](/api/referencia). O assistente faz tudo isso pela conversa: ver [Ferramentas · Créditos](/mcp/ferramentas-creditos).

## Relacionados

- [Reservas](/espacos/reservas)
- [Agendamento](/espacos/agendamento)
- [Planos](/monetizacao/planos)
- [Produtos](/monetizacao/produtos)
- [Papéis e permissões](/conceitos/papeis-e-permissoes)