Créditos
Créditos abatem a fatura antes da cobrança. Eles ficam em Cobrança › Créditos, que mostra o saldo disponível, o projetado (disponível menos o estimado do período aberto) e o que vence em 30 dias, além das concessões, das compras recentes e do extrato.
Owner e Admin veem a tela. Comprar créditos, retirar uma compra, a recarga automática, o resgate de código e a indicação são do Owner. Os créditos valem para organizações cobradas em reais.
Tipos de crédito
| Tipo | Origem | Validade |
|---|---|---|
| Pré-pago | Compra por PIX ou cartão | Não vence |
| Promocional | Código promocional | Definida no código |
| Indicação | Programa "Indique e ganhe" | Definida no programa |
| Trial | Período de experiência | Até o fim do trial |
| Cortesia | Concedida pela plataforma, com motivo | Definida na concessão |
| Comissão de parceiro | Conversão de saldo de parceiro | Com validade |
Comprar créditos
Comprar créditos abre uma janela com o valor (de R$ 20,00 a R$ 50.000,00 por compra) e o meio de pagamento:
- PIX: o portal mostra o QR Code, o código copia-e-cola e a contagem até a expiração (60 minutos por padrão). A janela consulta o pagamento a cada 10 segundos; ao confirmar, aparece "Créditos adicionados" e o saldo sobe. Não há reemissão automática: se expirar, gere outro.
- Cartão: cobra o cartão padrão. Se o banco pedir autenticação (3DS), a janela mostra o link para concluir. Sem cartão salvo, cadastre um em Cobrança.
Cada compra gera um recibo (não fiscal, no modo padrão). Uma organização pode ter no máximo 3 compras aguardando pagamento (409 credits.too_many_pending) e criar até 10 por hora.
Ordem de consumo e validade
No fechamento do período, os créditos são aplicados à fatura antes da cobrança, nesta ordem:
- Os créditos não pagos (promocional, indicação, trial, cortesia e comissão de parceiro), do que vence primeiro ao que vence por último (sem validade por último).
- Os créditos pré-pagos, do mais antigo ao mais novo.
Consumir primeiro o que vence evita que você perca saldo; consumir por último o que foi pago preserva o maior valor estornável. O detalhe da fatura mostra Créditos aplicados (por concessão) e Valor a pagar. Com valor a pagar zero, a fatura fica paga sem cobrança.
A expiração roda uma vez por dia, às 0h30 (horário de Brasília), e você recebe um aviso 7 dias antes do vencimento. Créditos pré-pagos nunca expiram. Se uma fatura for anulada, os consumos voltam como estorno para as mesmas concessões; se a concessão já tiver vencido, o valor volta como cortesia de 30 dias.
Extrato
O extrato lista cada lançamento (Concessão, Consumo, Vencimento, Reembolso, Estorno) com o valor com sinal e o saldo depois do lançamento. Ele é somente de acréscimo: nenhum lançamento é alterado ou apagado. Exportar CSV baixa o extrato com o cabeçalho sequence,occurredAt,type,grantKind,amount,balanceAfter,invoiceId,topUpId.
Recarga automática
A regra "quando o saldo ficar abaixo de X, comprar Y no cartão padrão, até N vezes por mês" mantém o saldo sem você precisar lembrar. O Owner liga a regra (o que exige o segundo fator e registra o consentimento para cobrança recorrente no cartão). O saldo usado na comparação é o projetado.
- O máximo de compras por mês é limitado pelo plano.
- Se o banco pedir autenticação, o Owner recebe um e-mail com o link.
- Três falhas seguidas desligam a regra e o Owner é avisado. Ligue de novo depois de conferir o cartão.
- Trocar para um plano sem recarga automática desliga a regra.
Combinada com o teto no modo saldo, a recarga automática faz o teto ser atingido apenas quando a recarga falha. Veja Teto de gasto.
Códigos promocionais
Resgatar código (Owner) transforma o código em crédito promocional com validade. Um código vale uma vez por organização, tem janela de resgate e pode ter limite de usos ou valer só para organizações novas. Código inválido e inexistente dão a mesma resposta (400 credits.promo_invalid), e há limite de 5 tentativas por hora (429). Respostas: 409 credits.promo_already_redeemed e 409 credits.promo_exhausted.
Indique e ganhe
Quando o programa está ligado, o Owner vê um link de indicação copiável. Quem se cadastrar pelo link recebe um crédito na criação da organização, e você recebe o seu quando a primeira fatura da organização indicada com valor a pagar for paga. A plataforma recusa indicações da própria organização (mesmo CPF/CNPJ, e-mail de cobrança, Owner em comum ou cartão em comum), limita as recompensas por mês e expira a indicação se a organização indicada não pagar em 90 dias. A lista mostra o estado de cada indicação.
Estorno e arrependimento
- Arrependimento de 7 dias: o Owner pode retirar uma compra até 7 dias depois do pagamento, desde que nenhum crédito dela tenha sido consumido (CDC, art. 49). Exige o segundo fator e devolve o valor total ao meio de pagamento. Depois da janela ou com consumo, a API responde
409 credits.refund_window_closed. - Estorno pela plataforma: a administração pode estornar o saldo restante de uma compra, com motivo registrado. Uma compra totalmente consumida responde
409 credits.nothing_to_refund. - Como funciona: o saldo deixa de estar disponível no momento do pedido, e só então o provedor de pagamento é chamado. Se o provedor falhar, o reembolso fica pendente e é repetido, sem devolver o saldo antes, para o valor não ser gasto duas vezes.
- Encerramento da organização: o saldo pré-pago restante entra na tela de desativação como "a reembolsar". Os créditos não pagos expiram.
Tratamento fiscal
O serviço prestado pela plataforma é a computação consumida, e o fato gerador do ISS é a prestação. A recarga é um adiantamento por serviço ainda não prestado, o crédito promocional é um desconto incondicional e o crédito pré-pago, quando consumido, é a forma de pagamento do serviço do mês. A plataforma oferece dois modos, escolhidos pela administração na página do emissor fiscal:
| Modo | NFS-e | Base de cálculo na fatura |
|---|---|---|
ON_CONSUMPTION (padrão) | Emitida sobre a fatura, como sempre. A recarga só tem recibo. | Total da fatura; os créditos não pagos entram como desconto incondicional; os pré-pagos não alteram a base. |
ON_TOPUP | Emitida quando a recarga é paga. Estorno total cancela a nota; estorno parcial pede substituição pelo valor líquido. | Os créditos pré-pagos aplicados também saem da base, porque já foram tributados. Uma fatura paga só com pré-pago não gera nota. |
Crédito promocional nunca gera nota própria. Trocar o modo vale só para recargas e faturas criadas depois da troca.
Perguntas para o seu contador
Estas são as dúvidas que a plataforma não resolve sozinha e que valem uma confirmação com o contador da empresa:
- Qual modo se aplica ao município do prestador,
ON_CONSUMPTIONouON_TOPUP? - O desconto incondicional dos créditos promocionais e de indicação reduz mesmo a base do ISS no município?
- Como tratar o crédito de indicação e a comissão de parceiro, que não têm pagamento associado?
- Na transição da reforma tributária (IBS e CBS, LC 214/2025), em que momento incide o tributo sobre pagamento antecipado?
- O recibo da recarga no modo
ON_CONSUMPTIONbasta como comprovante de adiantamento?