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 e 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ê).
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: 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
- Abra Monetização › Planos e crie ou edite o plano.
- No campo Créditos por mês, informe a quantidade. 0 significa que o plano não concede créditos.
- 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
- Abra o produto (digital, de pagamento único).
- Em Créditos concedidos na compra, informe a quantidade (0 = não concede).
- Em Validade dos créditos (dias), informe os dias, contados a partir da compra. Em branco, os créditos não vencem.
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
- Abra o perfil do membro e a aba Créditos.
- 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).
- 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).
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. O assistente faz tudo isso pela conversa: ver Ferramentas · Créditos.