Skip to main content
DELETE
Esta rota exclui um endpoint de webhook. Depois da exclusão, a URL deixa de receber os eventos de cobrança, assinatura e saque daquela conta. Não existe opção de desativar um endpoint temporariamente: para parar de receber, exclua; para voltar a receber, cadastre de novo.

Quando usar

Eventos enviados depois da exclusão não chegam a essa URL. Antes de excluir o único endpoint de uma conta, garanta que outro destino está recebendo os eventos, ou que a sua aplicação vai acompanhar as cobranças pela API.

Antes de chamar

  • Use a chave secreta (sk_) em Basic (Credenciais e ambientes). A chave age com as permissões do usuário que a gerou: um perfil sem permissão de webhooks recebe 403 Acesso negado.
  • Tenha o id do endpoint, obtido em GET /v1/webhook-endpoints.

Parâmetros de caminho

string
required
Id do endpoint, o campo id da listagem. Ex.: 2wHn5Qe8rT1yU4iO7pA3sD6fG9k.

Respostas

A resposta de sucesso é 200 sem corpo. Trate o erro pelo código HTTP, não pelo texto da mensagem.

Erros comuns

Veja também

Listar endpoints

Obtenha o id do endpoint.

Criar endpoint

Cadastre um novo destino.

Atualizar endpoint

Troque a URL sem excluir.

Webhooks: visão geral

Destinos, formatos e deduplicação.