SubmetryBlog

Webhooks do RevenueCat: evite renovações duplicadas

Impeça que novas tentativas inflem a receita: salve o ID do evento e teste a idempotência na recepção e no processamento.

Três envelopes roxos chegam a uma barreira e apenas um sai

A renovação já entrou no relatório, mas o RevenueCat não recebeu a resposta do seu servidor. Uma nova tentativa de entrega não pode virar outra venda. A ideia da idempotência é simples: se a mesma mensagem chegar de novo, o efeito para a receita ou para o acesso precisa continuar o mesmo.

Use a identificação do evento

A documentação do RevenueCat orienta guardar o ID do evento para reconhecer entregas repetidas. Em um receptor compartilhado por integrações independentes, inclua também a origem na chave. Não use só o ID do assinante: o pagamento do mês que vem tem de ser contabilizado mesmo quando é da mesma pessoa.

Nas métricas operacionais, separe o volume de entregas do número de eventos únicos. Se as tentativas aumentarem e os eventos únicos não, investigue o recebimento antes de comemorar um aumento de receita.

Grave antes de dar a confirmação

Valide a origem da solicitação conforme a documentação do provedor. Grave então o recebimento com uma chave única. Se o trabalho assíncrono ficar no mesmo banco, salve o recebimento e a tarefa na mesma transação. Responda após confirmar a gravação. Uma repetição com chave já gravada recebe confirmação sem abrir outra tarefa.

O teste crítico é cortar a conexão após a confirmação no banco e antes da resposta HTTP. O recebimento original fica salvo e a nova tentativa não dispara outro trabalho.

Proteja a operação de ponta a ponta

O processamento também pode falhar depois de atualizar a receita, mas antes de registrar que terminou. Imponha a unicidade da chave do evento na gravação de receita ou passe uma chave de idempotência para um serviço externo que a aceite. Para liberar ou encerrar acesso, compare com o estado atual confiável, sem presumir que a última mensagem recebida descreve o evento mais recente.

Teste com a mesma conta

No ambiente de teste, mande o mesmo evento de renovação duas vezes. Mande depois uma segunda renovação da mesma conta com outro ID. O resultado certo é três entregas e dois registros de receita. Para diagnosticar diferenças, registre a chave do evento, o estado do processamento e a contagem de duplicatas, sem gravar dados completos de clientes nos logs.

O guia de integração do Submetry explica a deduplicação e a separação do sandbox. Se fizer sentido para seu app, entre na lista de espera do Submetry.