Business OS · Documentação

#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ãoAvisar 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ãoCancelar é "não vai renovar". A pessoa tem direito ao que já pagou. Tente reverter.
access.adjustedNãoO fim recuou, mas ainda há acesso. Atualize a data.
payment.refundedSim (se você usa payments)Tire o acesso e dê baixa.
chargeback.createdSim (veja o porém da dispute)Tire o acesso, avise o financeiro, junte provas.
access.endedSim (se você usa kb_access)Tire o acesso.

#Receita recomendada (fluxo kb_access)

Ouça apenas access.ended para tirar acesso:

  1. Confira assinatura, webhook-id.
  2. Leia data.object.end_reason:
end_reasonSignificadoMensagem sugerida
refundedReembolsouSem mensagem de "volte".
chargebackContestou no cartão/PixSem mensagem de "volte".
period_endAcabou o período de um plano que não renova sozinhoOferta de volta.
not_renewedPlano que renova, mas a cobrança seguinte não veio até o fim mais a tolerânciaOferta de volta.
canceledCancelou e o período pago acabouOferta de volta.
unlinkedTodos os pagamentos foram desligados (decisão de pessoa)Em geral nada.
voidedPagamento manual anuladoEm geral nada.
trial_not_convertedO teste acabou sem cobrança aprovadaOferta para assinar.
  1. Tire o acesso. A data do fim é data.object.ended_at.
  2. Guarde subject.id e o subject.sequence; ignore um access.ended com sequence menor do que o último visto.

Quando o fim é por reembolso, o objeto não traz ends_at (o período foi desfeito). Use ended_at.

#Receita com o fluxo payments

Se você não usa kb_access:

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


← Liberar conteúdo no pagamento aprovado  ·  Pagamento vencido ou esquecido →