# Créditos

> A moeda de reserva da comunidade. De onde vêm os créditos (plano todos os meses, produto avulso e atribuição da equipa), lotes e validade, a viragem do mês, acumulação, cancelamento tardio e ausência, o separador 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 levanta, não se transfere e não passa pelo checkout. A comunidade define quanto custa cada sala em créditos, e o membro recebe créditos pelo plano, por um produto ou da equipa.

## Para que serve

| Comunidade | Como usa os créditos |
|---|---|
| Coworking | O plano **Residente** dá 40 créditos por mês; a sala de reuniões 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 subscrever |
| Mentoria | A equipa atribui créditos de cortesia a quem fez a primeira compra |
| Associação | Cada associado ganha créditos todos os meses para usar o auditório |

## Como funciona

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

| Origem | Como chega | Aparece no extrato como |
|---|---|---|
| **Plano** | Todos os meses, para cada subscrição ativa do plano que tem **Créditos por mês** | Plano |
| **Produto avulso** | Uma vez, quando a compra é concluída | Produto |
| **Atribuição manual** | A equipa dá créditos a um membro, com um motivo | Equipa |

**Plano.** Cada subscrição **ativa** (ou em período experimental) 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** da mesma forma. Os créditos do plano valem **até à viragem do mês**, à meia-noite do fuso da comunidade. Quem muda para um plano com mais créditos recebe **só a diferença**; quem muda para um plano com menos não perde o que já tem. Cancelar de imediato ou reembolsar a subscrição retira o que ainda não foi usado.

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

**Atribuição manual.** A equipa 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 atribuiçã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 este já venceu, volta num lote novo, válido por 30 dias). O extrato nunca é apagado nem editado: um erro corrige-se com um novo lançamento.

O extrato mostra cada lançamento com o tipo:

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

### A viragem do mês

Os créditos do plano vencem às **00:00 do dia 1**, no **fuso da comunidade** (não no de quem está a ver). Por omissão **não há acumulação**: o que sobra do plano vence na viragem e o mês seguinte começa com a quota nova.

Com a **acumulação** ligada, 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 alteração vale **a partir da próxima viragem do mês** e nunca altera um lote que já existe.

### Cancelamento tardio e ausência

Cada reserva tem uma **janela de cancelamento**, de **24 horas** por omissã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 omissão |
|---|---|
| Cancelamento **depois** da janela (tardio) | O membro **perde** os créditos |
| **Ausência (no-show)**, marcada pela equipa ou pelo anfitrião | O membro **perde** os créditos |
| Cancelamento pela **equipa** ou pelo anfitrião | Estorna sempre na totalidade |
| Sala eliminada ou horário bloqueado com reservas | Estorna sempre na totalidade |

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.

### Subscrição pausada ou em incumprimento

Uma subscrição **pausada** ou **em incumprimento** **não recebe o mês novo** de créditos. Quanto ao saldo que a pessoa já tem, **por omissão continua a usá-lo**, inclusive para reservar. É uma regra da plataforma, não uma opção da comunidade: não aparece nas definições. Quando a subscrição volta a ficar ativa, a pessoa recebe os créditos do mês corrente.

## Onde ver

### O separador Créditos no perfil

No perfil de um membro, o separador **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 recente para o mais antigo, com quem fez cada lançamento e o motivo.

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

### Meus créditos

O membro abre **A Minha Conta › Créditos** (**Meus créditos**) e vê o mesmo painel: saldo, lotes e extrato. Sem créditos, o ecrã explica de onde chegam (plano, produtos ou atribuição da equipa).

### As regras da comunidade

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

| Campo | O que faz | Predefinição |
|---|---|---|
| **Acumular créditos do plano para o mês seguinte** | Liga a acumulação | 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** | Durante quantos meses o acumulado ainda vale (1 a 12) | 1 |
| **No primeiro mês, atribuir o proporcional aos dias restantes** | Quem subscreve a 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**, indique a quantidade. **0** significa que o plano não atribui créditos.
3. Guarde. Cada subscrição ativa passa a receber a quota todos os meses, até à viragem 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 atribuídos na compra**, indique a quantidade (0 = não atribui).
3. Em **Validade dos créditos (dias)**, indique os dias, contados a partir da compra. Em branco, os créditos **não vencem**.

> [!NOTE]
> Os créditos só funcionam numa comunidade que tem um espaço de **Reservas** ou de **Agendamento**. Sem ele, a app avisa por baixo 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.

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

1. Abra o perfil do membro e o separador **Créditos**.
2. **Atribuir créditos** abre um lote novo: indique a **quantidade**, o **motivo** (obrigatório, aparece no extrato) e, se quiser, a **validade** (o último dia vale até às 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 ultrapassar o 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 | ✔ | ✔ | ✔ | ✔ | — |
| Atribuir 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 primeiro um espaço de Reservas ou de Agendamento |
| *"Faltam N créditos para esta reserva"* | O membro precisa de mais créditos: a equipa atribui-os, 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 a acumulação e nada mudou no lote atual | A regra vale a partir da próxima viragem do mês e não altera lotes que já existem |
| O produto não atribui créditos | Só um produto **digital de pagamento único** atribui, e não se estiver incluído num plano |

## Perguntas frequentes

**Crédito é dinheiro?** Não. Só paga reservas dentro da comunidade; não se levanta 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 aos créditos se a subscrição for 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

As rotas ficam em `/api/credits` (saldo, extrato, atribuições, ajustes e regras), documentadas na [referência da API](/api/referencia).

## Relacionados

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