Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Gerenciar cancelamento de plano

O cancelamento de um aplicativo de GitHub Marketplace aciona o webhook do evento marketplace_purchase event com a ação cancelado, que dá início ao fluxo de cancelamento.

Neste artigo

Esse documento ajudou você?

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.

Para obter mais informações sobre cancelamento e como está relacionado à cobrança, consulte "Cobrança de clientes GitHub Marketplace".

Etapa 1. Evento de cancelamento

Se um cliente optar por cancelar um pedido do GitHub Marketplace, o GitHub irá enviar um webhook de marketplace_purchase com a ação cancelado para o seu aplicativo, quando o cancelamento entrar em vigor. Se o cliente efetuar o cancelamento durante um teste grátis, seu aplicativo receberá o evento imediatamente. Quando um cliente cancelar um plano pago, o cancelamento ocorrerá ao final do ciclo de cobrança do cliente.

Etapa 2. Desativar as contas dos clientes

Quando um cliente cancela um plano grátis ou pago, seu aplicativo deve realizar essas etapas para concluir o cancelamento:

  1. Desative a conta do cliente que cancelou o plano.
  2. Revogue o token do OAuth que seu aplicativo recebeu para o cliente.
  3. Se o seu aplicativo for um aplicativo OAuth, remova todos os webhooks que seu aplicativo criou para os repositórios.
  4. Remova todos os dados do cliente em 30 dias após receber o evento cancelado.

Obsevação: Recomendamos usar a effective_date do webhook marketplace_purchase para determinar quando ocorrerá a mudança do plano e sincronizar periodicamente Listar as contas para um plano. Para obter mais informações sobre webhooks, consulte "eventos de webhook do GitHub Marketplace".

Esse documento ajudou você?

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.