Pular para o conteúdo principal

Inadimplência e suspensão

Resumo: Esqueceu de pagar? Há 3 etapas: 1-6 dias de atraso (alerta amigável), 7-13 dias (alerta forte), 14+ dias (conta suspensa — API bloqueada). Após pagar, a conta volta a funcionar automaticamente.

Quando usar isso​

  • Você recebeu um e-mail de cobrança em atraso.
  • Sua aplicação começou a receber erro 402 PAYMENT_REQUIRED ou ACCOUNT_SUSPENDED.
  • Você quer entender o que vai acontecer se deixar de pagar uma fatura.

As 3 fases de inadimplência​

O gateway implementa um modelo padrão chamado dunning ("cobrança escalonada"). Tudo é automático, baseado nos dias de atraso da fatura.

Fase 1: WARNING (1 a 6 dias de atraso)​

O que acontece:

  • Sua conta continua totalmente funcional — você pode enviar e receber mensagens normalmente.
  • O sistema marca internamente como WARNING.
  • Você recebe e-mail de lembrete após 1 dia de atraso.
  • Pode receber lembretes a cada 2-3 dias.

O que fazer:

  • Pagar a fatura assim que possível.
  • Após o pagamento ser confirmado, o flag de WARNING é removido automaticamente.

Fase 2: CRITICAL (7 a 13 dias de atraso)​

O que acontece:

  • A conta ainda funciona, mas o painel exibe um alerta visível ("Sua conta está em risco de suspensão").
  • E-mails de cobrança mais firmes são enviados.
  • O sistema marca como CRITICAL.

O que fazer:

  • Urgente: pague antes do 14º dia para evitar suspensão.
  • Se precisar de mais prazo, entre em contato com o suporte do seu fornecedor para negociar.

Fase 3: SUSPENDED (14+ dias de atraso)​

O que acontece:

⚠️ Atenção: A partir de 14 dias de atraso, a API é bloqueada. Você não consegue enviar nem receber mensagens. As tentativas retornam erro HTTP 402 PAYMENT_REQUIRED.

  • A conta entra em status SUSPENDED.
  • Webhooks param de ser entregues (mensagens recebidas durante a suspensão ficam acumuladas — algumas podem ser perdidas dependendo do tempo).
  • O painel mostra a tag "SUSPENSO" em vermelho em todas as telas.
  • Canais Baileys podem desconectar durante esse período (sessão de WhatsApp Web pode cair sem ninguém para reconectar).
  • Templates WABA continuam aprovados na Meta — não há perda lá, mas você não consegue usá-los.

O que fazer:

  1. Pague todas as faturas em aberto.
  2. Aguarde a confirmação do pagamento (Asaas → gateway, geralmente em minutos).
  3. A conta é reativada automaticamente — sem precisar acionar suporte.
  4. Reconecte canais Baileys que tenham desconectado durante a suspensão (escaneie o QR Code novamente).

Mensagens de erro que você verá​

HTTPCódigoSignificado
402PAYMENT_REQUIREDConta suspensa por inadimplência. Pague para reativar.
403ACCOUNT_SUSPENDEDVariação do anterior, dependendo do endpoint.

Esses códigos podem aparecer em qualquer chamada à API após a conta ser suspensa.

Como acompanhar o status​

No painel:

  • Cobrança → Status da conta: mostra ACTIVE, WARNING, CRITICAL ou SUSPENDED.
  • Cobrança → Faturas em aberto: lista faturas não pagas com dias de atraso.

Você também recebe e-mails de notificação em cada transição de fase.

Reativação automática​

Quando você paga uma fatura em atraso:

  1. Asaas confirma o pagamento (boleto pode demorar até 1 dia útil; PIX é em minutos).
  2. Asaas dispara webhook para o gateway.
  3. O gateway recalcula o status:
    • Se não há mais faturas em aberto → conta volta para ACTIVE.
    • Se ainda há faturas em aberto → o status pode descer um nível (de CRITICAL para WARNING, por exemplo) mas não ativa totalmente.
  4. API libera imediatamente.

Dúvidas comuns​

Vou perder histórico de mensagens? Mensagens já entregues ao seu sistema antes da suspensão não são afetadas. Webhooks que tentavam entregar durante a suspensão podem ter sido perdidos (mas o gateway tenta retentativas e tem uma "fila de eventos falhos" para reprocessar depois).

Meus canais ficam desconectados para sempre? Não. Após reativar, canais WABA voltam a funcionar automaticamente. Canais Baileys precisam reconectar via QR Code (sessões antigas podem ter caído por falta de atividade).

E os templates WABA aprovados? Eles continuam aprovados — a Meta não sabe da suspensão. Após reativar, você usa todos normalmente.

Posso negociar parcelamento? Sim. Entre em contato com o suporte do seu fornecedor. O wpp-gateway é uma plataforma técnica — quem comercializa é o seu fornecedor de software, e eles têm a flexibilidade de negociar.

Por que 14 dias e não 30? É o padrão usado em SaaS BR. Dá um período razoável para regularizar (boleto vence, esquece, paga em 1-2 semanas) sem deixar o cliente abusar (mês inteiro sem pagar).

E se eu nunca pagar? Após muitos meses sem pagar (geralmente 60-90 dias), a conta passa de SUSPENDED para CANCELLED permanente. Os dados podem ser apagados conforme política de retenção (consulte o suporte para casos específicos).

Artigos relacionados​