Webhooks - Repass

repass.webhooks gerencia os endpoints de webhook e suas entregas: criação, rotação do segredo de assinatura, inspeção das entregas e reenvio.

Endpoint

create e rotateSecret retornam o secret em texto uma única vez; guarde-o no momento, pois ele não volta a aparecer.

const endpoint = await repass.webhooks.create({
  url: "https://x.com/hook",
  subscribedEvents: ["conversion.created"],
}); // → WebhookEndpointWithSecret (WebhookEndpoint + secret)
endpoint.secret; // mostre/guarde agora; não volta a aparecer

await repass.webhooks.list(); // → RepassPage<WebhookEndpoint>

await repass.webhooks.retrieve("whep_…"); // → WebhookEndpoint

await repass.webhooks.update("whep_…", { status: "disabled" }); // → WebhookEndpoint (atualização parcial)

await repass.webhooks.del("whep_…"); // → void (204)

// Rotacionar o segredo; retorna o novo secret (também uma única vez)
await repass.webhooks.rotateSecret("whep_…"); // → WebhookEndpointWithSecret

Entregas

deliveries e deadLetter retornam um RepassPage. replayDelivery recebe o id da entrega (whdl_), não o do endpoint.

await repass.webhooks.deliveries("whep_…", { status: "failed" }); // → RepassPage<WebhookDelivery> (filtros opcionais por status)

await repass.webhooks.deadLetter("whep_…"); // → RepassPage<WebhookDelivery> (entregas esgotadas após as retentativas)

await repass.webhooks.test("whep_…");           // → WebhookDelivery (dispara uma entrega de teste)
await repass.webhooks.replayDelivery("whdl_…"); // → WebhookDelivery (reenvia uma entrega específica)

Para o schema completo de cada corpo (eventos assináveis, status de endpoint e de entrega), consulte a Referência da API. Os conceitos estão em Webhooks › Visão geral e Assinatura.