Endpoint: PUT/PATCH /integrations/webhooks/{seller_id}/webhooks/{id}/
Autenticação: token JWT ou chave de API do vendedor. Consulte Autenticação.
Atualiza um webhook existente. São aceitos tanto PUT (substituição total) quanto PATCH (parcial). Este é também o caminho para rotacionar o segredo compartilhado: envie o novo valor em secret e o próximo despacho passará a usá-lo. Não existe um endpoint separado para rotação.

​
Parâmetros de caminho

​
seller_id
string (uuid)
required
​
id
string (uuid)
required
ID do webhook.

​
Corpo

​
url
string
Nova URL de destino.
​
secret
string
Novo segredo compartilhado. Somente gravação; a resposta não retornará este valor. Ao alterá-lo, o valor anterior é perdido — armazene o novo antes de responder ao seu cliente.
​
events
string
Nova string de inscrição em eventos. Lembre-se: a correspondência é por substring, sem diferenciar maiúsculas e minúsculas — consulte Criar webhook para a regra e os nomes canônicos de evento.
PUT exige todos os campos graváveis (url, secret, events). PATCH aceita qualquer subconjunto.

​
Resposta

O webhook atualizado (sem o campo secret). 
{
  "id": "5a2b6f4e-9c10-4d3a-9f17-0c2a3e4b5d61",
  "url": "https://merchant.example.com/hooks/dlpay/v2",
  "events": "transaction.update.status"
}

​
Erros

StatusQuando
400Corpo inválido ou seller_id não existe.
401Token JWT ou chave de API ausente ou inválida.
404Não existe webhook com id sob o seller_id informado.

​
Exemplos

curl -X PATCH https://api.dlpay.cloud/integrations/webhooks/9b1f0d2a-2b40-4f3e-9c11-c2c0a1b3e711/webhooks/5a2b6f4e-9c10-4d3a-9f17-0c2a3e4b5d61/ \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://merchant.example.com/hooks/dlpay/v2"}'