#Tirar acesso no reembolso ou chargeback
Tirar acesso por engano é pior do que demorar: a pessoa pagou e fica sem o produto. Por isso esta página separa o que parece perda de acesso do que é.
#Três palavras que parecem iguais e não são
| O que chegou | É perda de acesso? | O que fazer |
|---|---|---|
refund.requested (pediu reembolso) | Não | Avisar o time para tentar reter. Na Cakto, refund.auto_approve_at diz quando o reembolso se efetiva sozinho se ninguém desistir. |
subscription.canceled / access.canceled (cancelou) | Não | Cancelar é "não vai renovar". A pessoa tem direito ao que já pagou. Tente reverter. |
access.adjusted | Não | O fim recuou, mas ainda há acesso. Atualize a data. |
payment.refunded | Sim (se você usa payments) | Tire o acesso e dê baixa. |
chargeback.created | Sim (veja o porém da dispute) | Tire o acesso, avise o financeiro, junte provas. |
access.ended | Sim (se você usa kb_access) | Tire o acesso. |
#Receita recomendada (fluxo kb_access)
Ouça apenas access.ended para tirar acesso:
- Confira assinatura,
webhook-id. - Leia
data.object.end_reason:
end_reason | Significado | Mensagem sugerida |
|---|---|---|
refunded | Reembolsou | Sem mensagem de "volte". |
chargeback | Contestou no cartão/Pix | Sem mensagem de "volte". |
period_end | Acabou o período de um plano que não renova sozinho | Oferta de volta. |
not_renewed | Plano que renova, mas a cobrança seguinte não veio até o fim mais a tolerância | Oferta de volta. |
canceled | Cancelou e o período pago acabou | Oferta de volta. |
unlinked | Todos os pagamentos foram desligados (decisão de pessoa) | Em geral nada. |
voided | Pagamento manual anulado | Em geral nada. |
trial_not_converted | O teste acabou sem cobrança aprovada | Oferta para assinar. |
- Tire o acesso. A data do fim é
data.object.ended_at. - Guarde
subject.ide osubject.sequence; ignore umaccess.endedcom sequence menor do que o último visto.
Quando o fim é por reembolso, o objeto não traz
ends_at(o período foi desfeito). Useended_at.
#Receita com o fluxo payments
Se você não usa kb_access:
payment.refunded: tire o acesso, tire das listas de cliente, dê baixa no financeiro.chargeback.created: tire o acesso. O tipo vem emdata.object.chargeback.kind:chargeback,med,prechargebackoudispute.payment.partially_refunded: só a Hotmart gera. O que fazer com o acesso depende da regra do seu negócio. Por padrão, só ajuste no financeiro.
Não faça as duas coisas. Quem ouve kb_access também recebe payment.refunded se estiver ouvindo payments. Se o seu código tira acesso nos dois caminhos, ele tira duas vezes. Escolha UM.
#Porém
disputeda Guru é ambígua. O "Reembolso Sol." da Guru pode ser só um pedido de reembolso e, mesmo assim, sai comochargeback.createdcomkind: dispute. Confira antes de tirar acesso de alguém que só pediu para desistir.- Outro pagamento válido. Se a pessoa tem uma renovação paga e a primeira foi reembolsada, não sai
access.ended: saiaccess.adjustede ela continua com acesso, até uma data anterior. - Aprovado atrasado. Depois do reembolso, um "aprovado" atrasado da mesma venda não sai (a plataforma não volta atrás).
- Ordem. O
payment.refundedpode chegar antes dopayment.approved. Comparesubject.sequenceeoccurred_at. - Concessões (cortesia). A revogação de tempo concedido sai como
access.adjustedouaccess.endedcomdata.grant.revoked: true. - Chargeback ganho ou perdido (
chargeback.won,chargeback.lost) são nomes reservados: nenhuma plataforma os gera hoje. Não programe nada em cima deles. Veja Eventos reservados.
← Liberar conteúdo no pagamento aprovado · Pagamento vencido ou esquecido →