Saldo de Créditos

Um Saldo de Créditos rastreia os créditos consumíveis (USTs — Unidades de Serviço Técnico) disponíveis para uma organização para trabalho baseado em serviços. Créditos são a moeda do modelo de faturamento UST: cada tipo de solicitação de serviço tem um custo fixo em créditos, e os créditos são deduzidos do saldo conforme o trabalho é concluído.

Como os créditos funcionam

Em vez de cobrar por hora, a MIDDAG utiliza um sistema padronizado de créditos:

• "Atualização de Plugin" custa 4 créditos.
• "Integração de API" custa 10 créditos.
• "Desenvolvimento de Plugin" custa 30 créditos.

O cliente compra um pacote de créditos (ou recebe créditos como parte de um plano de serviço), e os créditos são consumidos conforme solicitações de serviço são atendidas. Isso oferece previsibilidade de custos ao cliente e o protege de surpresas no faturamento.

Um saldo por organização por moeda

Cada organização possui um saldo de créditos por moeda (BRL ou USD), determinado pela entidade de faturamento da organização. O saldo é criado automaticamente quando o domínio Serviço é habilitado para a organização — mesmo que o saldo inicial seja zero.

Um saldo zero não bloqueia trabalho. Solicitações de serviço continuam, e qualquer excedente é cobrado separadamente. Isso garante que o sistema sempre capture o custo operacional real.

Operações de crédito

Operação	Quando acontece	Efeito no saldo
Credit	Créditos comprados ou recarregados	Saldo aumenta
Reserve	Solicitação de serviço criada	Créditos reservados (soft-lock)
Release	Solicitação de serviço cancelada	Créditos reservados devolvidos
Consume	Solicitação de serviço concluída	Créditos permanentemente deduzidos
Expire	Data de expiração atingida	Créditos removidos

Reserva e consumo (FIFO)

Créditos seguem um modelo de consumo FIFO (primeiro a entrar, primeiro a sair). Os créditos mais antigos são consumidos primeiro.

Quando uma solicitação de serviço é criada, os créditos estimados são reservados (soft-lock). Quando a solicitação é concluída, os créditos reais são consumidos. Se o real exceder o estimado, a diferença é retirada do saldo disponível ou cobrada como cobrança avulsa.

Expiração

Créditos possuem um período de expiração configurável, governado pela Credit Policy:

Configuração	Padrão	Descrição
expiration_months	12	Meses até os créditos do plano expirarem
grace_after_days	30	Período de carência após a data de expiração
avulso_expiration_months	6	Expiração para compras avulsas de créditos

Um cron job diário verifica créditos expirados e os remove do saldo. Créditos avulsos comprados fora de um plano possuem um período de expiração menor por padrão.

Alertas de saldo baixo

Quando o saldo disponível cai abaixo de um limite configurável (padrão: 20% da última alocação de créditos), o sistema dispara uma notificação. O admin e o contato principal da organização são alertados, incentivando uma recarga ou ajuste de plano.

Histórico de transações

Toda operação de crédito é registrada em um log de transações:

Campo	Descrição
Type	credit, reserve, consume, release, expire
Amount	Positivo para créditos adicionados, negativo para deduções
Service request	SR vinculada (se aplicável)
Balance after	Saldo corrente após a transação
Timestamp	Quando a operação ocorreu
Notes	Descrição (ex.: "Reserva para SR-20260015")

Este log serve como a trilha de auditoria financeira completa para consumo de créditos. Clientes podem visualizar seu histórico de transações no portal.

O que os admins veem

No admin do WordPress, a visualização de saldo de créditos mostra:

• Nome da organização
• Saldo atual e valor reservado
• Moeda
• Transações recentes
• Agenda de expiração para alocações de créditos ativas

Admins podem creditar manualmente uma organização (para recargas, correções ou gestos de boa vontade) e visualizar o histórico completo de transações.

Páginas relacionadas

• Serviços — o trabalho que consome créditos
• Solicitações de Serviço — tarefas individuais faturadas contra o saldo
• Policies — configurações da Credit Policy para expiração e limites
• Entitlements — o entitlement SVC ao qual o saldo pertence