Subscrições Software / SaaS na Zenofy
Venda acesso a software ou serviços online com faturação recorrente, uma lista dedicada no painel e webhooks HTTPS para o seu sistema activar ou revogar acesso automaticamente.
Ao criar um produto, escolha o tipo Software / SaaS. Para subscrições que renovam após cada pagamento, defina um ciclo de faturação recorrente (semanal, mensal, trimestral, semestral ou anual). A cobrança única também é possível neste tipo, mas comporta-se como um único período sem renovações automáticas.
No formulário do produto deve indicar um URL HTTPS de webhook (e pode definir um segredo opcional). A Zenofy envia POST JSON quando o ciclo de vida da subscrição muda, para criar utilizadores, activar licenças ou sincronizar faturação. Pode opcionalmente indicar uma página de vendas ou marketing própria.
Os clientes usam o mesmo URL público de checkout que qualquer produto — por exemplo https://pay.zenofy.io/p/YOUR_PRODUCT_ID — com os mesmos parâmetros opcionais descritos nos outros tutoriais (?lang=, ?currency=, cupões, UTMs, etc.).
Webhook SaaS versus Integrações → Webhook
A integração «Webhook» sob Integrações notifica sobre order_paid, order_refunded e order_cancelled com payload orientado à encomenda. O webhook de subscrição SaaS configura-se no próprio produto (campo de URL nos produtos Software / SaaS) e envia eventos subscription.* com id da subscrição, datas do período e metadados de renovação. Pode usar os dois: um para encomendas, outro para direitos de acesso.
Depois do pagamento, o comprador pode ver detalhes da subscrição (período, referência, link de renovação) na página de sucesso quando o produto for Software / SaaS recorrente.
Renovações: envie novamente à mesma ligação de checkout do produto. Use o mesmo e-mail da subscrição original para que o pagamento prolongue o período existente.
Na app Zenofy, abra Catálogo → Assinaturas SaaS para ver todas as subscrições — filtre por estado ou produto, pesquise por cliente e cancele quando o fluxo permitir.
Estados: PENDING, ACTIVE, SUSPENDED, CANCELED e EXPIRED. Em produtos SaaS recorrentes pode configurar dias após o fim do período para subscription.suspended e depois subscription.expired quando o segundo prazo é atingido; caso contrário, o fim do período pode resultar já em EXPIRED com subscription.expired (sem calendário escalonado).
Estados da subscrição (resumo)
| status | Significado (tÃpico) |
|---|---|
PENDING | Criada com a encomenda; ainda não activa ou a aguardar conclusão do pagamento |
ACTIVE | PerÃodo pago (ou tolerância antes da suspensão se estiver configurado no produto recorrente) |
SUSPENDED | Produto recorrente com polÃtica configurada; sem renovação após os dias até suspender — até expirar ou renovar |
CANCELED | Cancelamento manual pelo comerciante (painel ou fluxos associados) — subscription.canceled |
EXPIRED | PerÃodo terminou sem renovação (subscription.expired), já de imediato ou após suspendida quando passam os «dias até expirar» |
Referência técnica: JSON e nomes subscription.* → Webhooks de subscrição SaaS (HTTP)
Todos os tutoriais