Suspender por Inadimplência
Um pagamento falhou. Esta receita cobre a verificação do status de suspensão, o entendimento do cronograma da Payment Recovery Policy, o que o cliente vê durante a suspensão e a reativação após a recuperação do pagamento.
Pré-requisitos
- Acesso de admin ao WordPress.
- Um entitlement existe que teve uma falha de pagamento (renovação de assinatura Stripe falhou, ou um pagamento manual não foi recebido).
Passos
Parte A: Identificar o pagamento que falhou
Passo 1. Vá em MIDDAG Account > Entitlements e filtre por status suspended. Alternativamente, verifique MIDDAG Account > Logs para eventos recentes de falha de pagamento.
Passo 2. Abra o entitlement suspenso. Verifique a seção Payment History para detalhes sobre a falha:
- Failure date -- quando a tentativa de pagamento falhou.
- Failure reason -- cartão recusado, fundos insuficientes, cartão expirado, etc.
- Retry attempts -- quantas vezes o sistema tentou novamente.
Parte B: Entender o cronograma da Payment Recovery Policy
Passo 3. A resposta do sistema a falhas de pagamento é governada pela PaymentRecoveryPolicy. Verifique os valores da política na página de detalhes do entitlement:
| Configuração | Padrão | O que significa |
|---|---|---|
trigger | retry_exhausted | Suspender após todas as tentativas do Stripe falharem (não na primeira falha). |
anticipate_suspension | false | Se verdadeiro, suspende mais cedo para clientes com histórico ruim de pagamento. |
suspended_to_cancelled_days | 30 | Dias no estado suspended antes do cancelamento automático. |
auto_reactivate_on_payment | true | Reativar automaticamente quando o pagamento for compensado. |
Passo 4. O cronograma típico se parece com o seguinte:
Dia 0 Pagamento falha. Stripe tenta novamente conforme sua programação.
Dia 3 Stripe tenta novamente (tentativa 2).
Dia 5 Stripe tenta novamente (tentativa 3).
Dia 7 Todas as tentativas esgotadas. Entitlement suspenso.
Dia 7-37 Período de carência (30 dias). Cliente pode atualizar pagamento e tentar novamente.
Dia 37 Período de carência expira. Entitlement cancelado automaticamente.A programação exata de tentativas depende das configurações do seu Stripe. O período de carência é configurável por entitlement, produto, organização, classe ou globalmente via a hierarquia de políticas. Veja Políticas.
Parte C: O que acontece durante a suspensão
Passo 5. Quando um entitlement é suspenso, os recursos derivados são pausados, não destruídos:
| Classe | O que acontece |
|---|---|
| PLG | A licença permanece nos sites ativados, mas atualizações e novas ativações são bloqueadas. |
| ENV | O ambiente continua rodando. O admin pode marcá-lo como somente leitura ou degradado. |
| SVC | Novas solicitações de serviço são bloqueadas. Solicitações em andamento continuam. |
| ORD | Sem alteração funcional, mas o entitlement é marcado como suspenso no portal. |
Passo 6. O cliente é notificado em cada etapa:
- Quando o pagamento falha.
- Quando o entitlement é suspenso.
- E-mails de lembrete durante o período de carência (configurável via NotificationPolicy).
- Quando o período de carência está prestes a expirar.
Parte D: O que o cliente vê
Passo 7. O cliente faz login no portal e vê:
- Seu entitlement marcado com um badge Suspended.
- Uma mensagem de banner explica o motivo (falha de pagamento) e o que fazer.
- Um link para Update Payment Method que o direciona à página de atualização de pagamento hospedada no Stripe.
- Um botão Retry Payment disponível caso ele tenha atualizado seu cartão.
Passo 8. O cliente atualiza seu método de pagamento e tenta novamente. Se o pagamento for bem-sucedido, o entitlement é reativado automaticamente (quando auto_reactivate_on_payment está habilitado).
Parte E: Reativar após a recuperação do pagamento
Passo 9. Se o pagamento for recuperado (cliente atualizou o cartão, pagamento manual recebido ou nova tentativa do Stripe bem-sucedida):
- O status do entitlement transita de
suspendedde volta paraactive. - Os recursos derivados retomam: atualizações de licença são reabilitadas, novas solicitações de serviço são permitidas, etc.
- O cliente e o admin são notificados da reativação.
Passo 10. Para verificar a reativação, abra o entitlement e confirme:
- Status é
active. - Expiration Date foi estendida se o pagamento de renovação foi o que falhou e depois foi recuperado.
- Recursos derivados estão funcionais (licença aceita novas ativações, solicitações de serviço podem ser criadas).
Parte F: Intervenção manual
Passo 11. Se você precisar reativar manualmente (ex.: cliente pagou via transferência bancária fora do sistema):
- Abra a página de detalhes do entitlement.
- Clique em Reactivate Entitlement.
- Opcionalmente, vincule a evidência do pagamento manual (comprovante de transferência bancária, etc.).
- Defina a nova data de expiração se estiver estendendo o período.
- Clique em Confirm.
Passo 12. Se o período de carência expirou e o entitlement foi cancelado automaticamente, você ainda pode reativá-lo:
- Abra o entitlement cancelado.
- Clique em Reactivate (disponível por um período configurável após o cancelamento).
- Processe ou vincule um pagamento.
- O entitlement retorna para
active.
Resultado esperado
- O entitlement suspenso é reativado após a recuperação do pagamento.
- Recursos derivados (licenças, serviços, ambientes) retomam a operação normal.
- O cliente vê o status
activee a data de expiração renovada no portal. - Se não recuperado dentro do período de carência, o entitlement é cancelado automaticamente conforme a política.
Leitura complementar
- Suspensão e Recuperação -- o fluxo conceitual por trás da suspensão.
- Políticas -- configuração da Payment Recovery Policy e Notification Policy.
- Tratar Offboarding de Clientes -- o que acontece se o entitlement for cancelado.