Pular para o conteúdo

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):

  1. 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).
  2. Ter uma chave Pix cadastrada na conta.
  3. 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, …_REFUSED e PIX_AUTOMATIC_RECURRING_PAYMENT_INSTRUCTION_REFUSED (os de cobrança PAYMENT_* já estão lá).
  4. 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).
  5. 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

  1. 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.
  2. 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.
  3. 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.
  4. 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.