SubmetryBlog

App Store: período de carência ou nova tentativa de cobrança após falha na renovação?

Separe recuperação do pagamento e continuidade do acesso, teste as transições no sandbox e compare coortes com a mesma janela de observação.

Uma ampulheta de vidro ao lado de um cartão sem inscrições, com caminhos luminosos para um símbolo de nova tentativa e um sinal de confirmação.

Quando uma renovação falha, o time de produto precisa responder a duas perguntas: a cobrança ainda pode ser recuperada e o assinante ainda tem acesso? Para assinaturas autorrenováveis da App Store, as respostas nem sempre coincidem. A Apple pode tentar cobrar novamente mesmo depois que o direito de acesso daquela assinatura termina. Tratar a primeira falha como cancelamento definitivo mistura problemas que exigem decisões diferentes.

A carência mantém o acesso; a nova tentativa busca o pagamento

Em billing retry, a Apple continua tentando renovar a assinatura após uma falha de cobrança. O Billing Grace Period, ou período de carência na cobrança, é outra coisa: quando está habilitado no App Store Connect e a assinatura é elegível, o app mantém o acesso durante esse intervalo. A carência pode acabar sem renovação, mesmo que a Apple continue tentando cobrar. Outro direito ativo, se houver, ainda pode dar acesso à pessoa.

Exemplo fictício: a renovação falha na segunda. Na quarta, a pessoa continua usando o serviço porque está na carência. Se o pagamento for recuperado dentro do prazo, não conte uma interrupção que não ocorreu. Se a carência terminar primeiro, registre a perda de acesso daquela assinatura e, se houver recuperação, o restabelecimento como fatos separados. Isso não são duas cobranças.

Concilie o estado atual em vez de reagir a um evento isolado

Nas notificações da Apple, DID_FAIL_TO_RENEW indica falha na renovação e o subtipo GRACE_PERIOD indica que há carência. GRACE_PERIOD_EXPIRED sinaliza que ela terminou sem renovação; DID_RENEW com BILLING_RECOVERY indica recuperação. No fluxo do RevenueCat, um CANCELLATION com motivo BILLING_ERROR não comprova que a pessoa cancelou voluntariamente ou que perdeu acesso de imediato. Verifique o motivo e a situação atual do direito.

Use o estado confirmado dos direitos como referência para liberar acesso e a transação confirmada para registrar a renovação. Guarde identificadores, horário efetivo e horário de recebimento. Faça a deduplicação pelo ID do evento dentro de cada provedor e concilie transações ou episódios entre fontes antes de contá-los. Se uma notificação antiga chegar depois de uma mais recente, confira a fonte de referência para não sobrescrever um estado válido.

Teste no sandbox e dê tempo para a recuperação aparecer

Use uma conta de teste no sandbox para simular uma falha sem carência e outra com carência. Confira a continuidade do acesso, a recuperação dentro do prazo e o fim da carência seguido de recuperação. Compare a interface, o estado registrado no servidor e o status confirmado na fonte. Nos testes do seu sistema, reenvie uma notificação e troque a ordem de duas entregas para checar deduplicação e conciliação.

Para calcular recuperação em sete dias, selecione apenas os episódios distintos iniciados há pelo menos sete dias. Nesse grupo, calcule a proporção recuperada em até sete dias a partir da falha. Meça à parte quantas pessoas ficaram sem acesso e por quanto tempo. Não inclua as falhas de ontem no denominador de uma taxa de sete dias: elas ainda não tiveram o mesmo tempo para se resolver. Ao comparar duas configurações, use a mesma regra para formar os episódios. Separe renovações pagas da conversão do teste gratuito se acompanhar as duas.

Para definir a métrica, leia o guia da Submetry sobre cancelamento e expiração.

Conheça a Submetry e entre na lista de espera do lançamento.