Kapta · 15/09/2026
A integração deve acompanhar cada ciclo de cobrança e relacioná-lo com a subscrição, o cliente e o documento correspondente. Criar uma subscrição uma vez não resolve as renovações, alterações de plano e tentativas de cobrança seguintes.
Qual é a diferença em relação a um pagamento único?
Uma subscrição mantém uma relação comercial ao longo do tempo. O Stripe documenta eventos para alterações de subscrição e resultados de cobrança. A ligação precisa de escolher os eventos adequados ao seu modelo e ao momento documental aprovado. Eventos de subscrições Stripe.
Uma subscrição criada significa que a primeira mensalidade foi paga?
Não deve assumir isso. A documentação distingue a criação da subscrição do pagamento e refere estados que ainda exigem conclusão. O sistema deve verificar o resultado aplicável antes de marcar o ciclo como liquidado. A regra de emissão de documentos deve ser definida separadamente da regra de acesso ao serviço.
Como identificar cada renovação?
Guarde referências para cliente, subscrição e ciclo de cobrança. Por exemplo, uma mensalidade de outubro deve continuar distinguível da de novembro, mesmo que o cliente e o montante sejam iguais. Use o identificador da operação na origem, em vez de tentar reconhecer a venda apenas por email e valor.
O que acontece quando uma cobrança falha e é tentada novamente?
Mantenha as tentativas associadas ao ciclo original. A equipa deve conseguir ver a situação pendente e o resultado final. Quando o pagamento for concluído, a recuperação não deve duplicar um documento que já tenha sido preparado segundo as regras da empresa.
Como testar uma mudança de plano?
Prepare uma alteração a meio do período, um desconto e um cancelamento no fim do ciclo. Compare as linhas disponibilizadas pelo Stripe com os valores que devem chegar ao InvoiceXpress. Não reduza todos os cenários a uma mensalidade fixa quando a origem apresenta ajustes.
O que devo enviar à Kapta?
Os planos utilizados, os períodos de cobrança, a conta InvoiceXpress e exemplos de renovação normal e falhada. Indique como gere atualmente os documentos e o acesso ao serviço. A proposta deve separar faturação, comunicações ao cliente e gestão de acesso quando esses fluxos forem necessários.
