Endpoint: GET /integrations/webhooks/{seller_id}/webhooks/
Autenticação: token JWT ou chave de API do vendedor. Aceita um token de acesso JWT emitido por POST /user/login/ ou uma chave de API do vendedor. Consulte Autenticação.
Retorna todas as assinaturas de webhook vinculadas ao seller_id. Um webhook é um endpoint HTTPS mantido pelo backend do vendedor que a plataforma chama quando eventos de domínio correspondentes são disparados — consulte Webhooks e Jobs para o modelo de despacho. O campo secret é somente gravação e nunca é retornado em nenhuma resposta. Se você perdê-lo, faça a rotação atualizando o webhook com um novo segredo.

​
Parâmetros de caminho

​
seller_id
string (uuid)
required
Identificador do vendedor. Os webhooks são filtrados por seller_id; se quem chama não tiver permissão sobre esse vendedor, a resposta será uma lista vazia em vez de 403.

​
Resposta

Retorna um array com as assinaturas de webhook.
​
id
string (uuid)
ID do webhook. Use-o como chave de caminho para buscar, atualizar ou remover.
​
url
string
URL de destino. Se o valor armazenado não começar com http:// ou https://, o despachante adiciona https:// automaticamente antes da chamada.
​
events
string
Texto livre listando os tipos de evento aos quais este webhook está inscrito. O despachante dispara o webhook quando o nome do evento (em minúsculas) aparece como substring do valor armazenado em events (em minúsculas) — você pode armazenar uma lista separada por vírgulas, um array JSON ou um único nome de evento, e a correspondência por substring cuida do resto. O único evento emitido atualmente é transaction.update.status.
[
  {
    "id": "5a2b6f4e-9c10-4d3a-9f17-0c2a3e4b5d61",
    "url": "https://merchant.example.com/hooks/dlpay",
    "events": "transaction.update.status"
  }
]

​
Erros

StatusQuando
401Token JWT ou chave de API ausente ou inválida.

​
Exemplos

curl https://api.dlpay.cloud/integrations/webhooks/9b1f0d2a-2b40-4f3e-9c11-c2c0a1b3e711/webhooks/ \
  -H "Authorization: Bearer $ACCESS_TOKEN"