Para equipe ilarika
Super Admin › Assinaturas: ver quem paga o quê e agir com motivo
- Super AdminAssinaturas (lista e saúde)
- Super AdminAssinaturasPix Automático (interruptor)
- Super AdminAssinaturasCobrança automática e Nota fiscal de serviço
- Super AdminAssinaturasdetalhe
- Super AdminEstabelecimentosaba Assinatura
Aqui a equipe da iLarika vê todas as assinaturas (em teste, ativas, em atraso, suspensas, canceladas), a saúde da cobrança e age sobre uma assinatura ou fatura. Toda ação pede um motivo e fica na linha do tempo da assinatura e na auditoria, com quem fez.
Quem pode o quê
| Acesso à área Assinaturas e cobrança | Pode |
|---|---|
| Ver | Ver tudo: lista, saúde, detalhe, faturas, linha do tempo. |
| Ver e mudar (e o superadmin) | Tudo acima e as ações (reativar, suspender, cancelar, conceder dias, trocar plano sem cobrar, marcar paga, reemitir, anular, cancelar com reembolso, editar titular, emitir/cancelar nota fiscal, ligar o Pix Automático). |
Quem só vê a área não vê os botões, e o servidor recusa de qualquer jeito (Time iLarika).
A saúde, em cima da lista
Os números vêm direto das tabelas, sem atraso:
- MRR: soma das mensalidades das assinaturas ativas e em atraso (anual dividido por 12). Cortesia conta zero.
- Recebido no mês e Em aberto: faturas pagas neste mês e faturas abertas ou incobráveis, com a contagem.
- Testes → pagos (30 d): quantos testes começaram e quantos viraram pagos nos últimos 30 dias.
- Excedente de IA no mês faturado, ao lado do custo real em dólar.
- Inadimplência por faixa de atraso (até 7, 8–30, 31–90, mais de 90 dias) aparece só quando há fatura vencida.
- A reconciliar: o botão fica em destaque quando há pagamento sem fatura ou webhook com erro. Veja reconciliar.
Formas de pagamento das lojas e o Pix Automático
As lojas escolhem como pagar a assinatura (checkout e “Minha assinatura”):
| Ciclo | Formas | Teste grátis |
|---|---|---|
| Mensal | Cartão · Pix Automático (se ligado) | Só no cartão |
| Anual | Cartão (até 12x) · Pix à vista · Pix Automático (se ligado) | Só no cartão |
Boleto não é oferecido às lojas. Para um caso especial, o superadmin ainda pode Reemitir cobrança de uma fatura como boleto.
O painel Pix Automático liga e desliga a oferta pelo interruptor
Oferecer Pix Automático às lojas (billing.pixAutomatico.enabled, PUT /platform/billing/pix-automatico,
auditado). Nasce desligado: o Asaas só libera Pix Automático para conta
PJ com CNPJ ativo há pelo menos 6 meses, aprovada e sem pendências.
Desligado, o mensal é só cartão e o anual é cartão ou Pix à vista; quem já
tem Pix Automático ativo continua sendo debitado.
Antes de ligar (no Asaas):
- Conta Asaas da plataforma em nome do CNPJ (PJ), com CNPJ ativo há 6 meses
ou mais, aprovada e sem pendência cadastral. Confirme com o gerente/suporte
do Asaas que a conta está elegível ao Pix Automático (o Asaas manda o
evento
PIX_AUTOMATIC_RECURRING_ELIGIBILITY_UPDATED). - Ter uma chave Pix cadastrada na conta.
- No webhook já usado pela cobrança (
/webhooks/billing/asaas/asaas), marcar também os eventos de Pix Automático:PIX_AUTOMATIC_RECURRING_AUTHORIZATION_ACTIVATED,…_CANCELLED,…_EXPIRED,…_REFUSEDePIX_AUTOMATIC_RECURRING_PAYMENT_INSTRUCTION_REFUSED(os de cobrançaPAYMENT_*já estão lá). - Se a chave de API foi trocada para a conta PJ, salvar em Super Admin › Configurações › Asaas (cobrança) (ou o botão Asaas no topo de Assinaturas) e Testar conexão (asaas).
- Testar no sandbox uma assinatura com Pix Automático (pagar o QR e autorizar) antes de ligar em produção.
No detalhe da assinatura, “Forma de pagamento” mostra o cartão (bandeira,
final, parcelas), “Pix Automático · autorização ativa / aguardando o pagador
/ cancelada”, “Pix à vista”, o Pix Automático a caminho (com o id da
autorização) e se a loja foi avisada para escolher outra forma. Detalhes do
fluxo em fatura-e-pagamento.md.
Os outros painéis da tela
- Cobrança automática: o interruptor Cobrança automática ligada
(
billing.enabled), o provedor padrão, o link do Asaas e a carência / suspensão em dias. Desligar só para de emitir e avisar: não anula fatura nem mexe em assinatura. Veja a visão geral. - Nota fiscal de serviço: o interruptor Emitir nota fiscal ao pagar, quem emite, homologação ou produção e a fila. Veja fatura e pagamento.
Encontrar uma assinatura
Filtre pelo estado nos chips e busque por nome ou slug da loja, e-mail de
cobrança, CPF/CNPJ (só os números já bastam), número da fatura
(2026-000123) ou a referência do pagamento no provedor. A linha mostra o
plano, a mensalidade, até quando vai o período e a fatura aberta, se houver.
A mesma coisa aparece na aba Assinatura do detalhe do estabelecimento, mais curta, com um link para a página completa.
O detalhe e as ações
- Situação: estado, plano e preço, período atual, dia de cobrança, forma de pagamento (e a situação da autorização do Pix Automático), e-mail e documento de cobrança, add-ons e pacotes.
- Faturas: número, tipo, valor, vencimento, situação e como foi (ou está
sendo) paga. Em cada fatura aberta:
- Copiar link de pagamento: copia um link curto
(
conta.<domínio>/f/2026-000123.…), que vale 7 dias, para mandar à loja no WhatsApp. Abre a mesma página de pagar do e-mail (Pix ou cartão), sem login. Se o navegador não deixar copiar, o link aparece na mensagem. - Consultar provedor: o “já paguei” do operador. Pergunta ao gateway e, se estiver paga, aplica na hora.
- Reemitir cobrança: cancela as tentativas pendentes e gera um QR, boleto ou cobrança no cartão novos (o boleto só existe por aqui; a loja não tem essa opção). “Pix automático” sem autorização ativa gera o QR que paga a fatura e autoriza as próximas (com o Pix Automático ligado).
- Marcar paga: pagamento recebido fora do gateway (Pix direto, transferência). Pede a referência do comprovante e o motivo.
- Anular: a fatura deixa de ser cobrada e fica no histórico.
- Copiar link de pagamento: copia um link curto
(
- Ações da assinatura (no topo):
- Reativar / Suspender / Cancelar: a máquina de estados do domínio continua valendo; cancelar não devolve dinheiro.
- Conceder dias: empurra o fim do período e o vencimento das faturas abertas para a frente (1 a 365 dias), sem cobrar. A fatura aberta do próximo ciclo anda inteira (vencimento e período): paga, ela vale até o fim do ciclo dela já com os dias concedidos, e a régua não emite outra fatura para o mesmo ciclo.
- Trocar plano sem cobrar: aplica o plano novo na hora, recalcula os recursos e não emite fatura. Sem preço escolhido, a assinatura vira cortesia.
- Cancelar com reembolso: cancela e pede ao provedor a devolução do último pagamento casado (inteiro ou um valor menor). Pagamento manual não tem reembolso automático: devolva por fora e escreva no motivo.
- Linha do tempo: tudo que aconteceu, com data, quem fez e o motivo.
Titular da cobrança e nota fiscal
“Situação” mostra o titular da cobrança (nome, CPF/CNPJ, endereço
fiscal). Editar titular completa o que o checkout não pediu: é o tomador
da nota fiscal de serviço, e a prefeitura costuma exigir endereço completo e
código IBGE do município. A coluna Nota fiscal das faturas e as ações
sobre ela estão descritas em fatura-e-pagamento.md.
O que acontece depois
- Reativar ou pagar reabre a loja na hora; suspender pausa o painel (nada é apagado). Veja atraso e bloqueio.
- Trocar plano recalcula os recursos da loja imediatamente.
- Cada ação gera um registro em Auditoria com o motivo.
Perguntas comuns
A loja pagou por Pix direto na nossa conta. O que faço? Abra a fatura aberta e use Marcar paga com o id do Pix como referência.
Quero dar um mês grátis. Conceder dias (30) com o motivo. A próxima fatura é emitida 5 dias antes do novo fim do período.
Posso mudar o valor de uma assinatura? Não aqui: valor é do preço do produto. Troque o plano/preço em produtos e cupons ou use Trocar plano sem cobrar.
