跳转到主要内容

​
查看与重新触发 webhook 事件

你可以在 PayLoco Web 应用中查看 webhook 事件及其投递状态，并在调试或故障恢复后重新投递事件。 通过 PayLoco Web 应用的事件列表，可以查看所有从 PayLoco 发送的 webhook 事件，并在需要时重新投递事件。关于 webhook 的工作原理及投递状态的判定，请参阅 Webhooks 概述。

​
开始之前

你必须已配置至少一个 webhook 订阅。如果没有，请先完成 监听 webhook 事件。

​
查看 webhook 事件

Webhook 事件会保留 30 天。 要查看事件及其投递状态，请打开事件列表并使用筛选器：
  1. 登录 PayLoco Web 应用，选择 Developer > Events。
  2. 使用以下筛选条件缩小结果范围：
    • 日期与时间：事件发生的时间区间。
    • 事件名称：如 payment_intent.result。
    • 事件来源：事件发生的ID。
    • 状态：webhook 事件的状态。可能的值包括：
      • 成功（Success）：事件已成功收到 200 HTTP 状态码响应。
      • 排队中（Queued）：事件已加入队列，将在一段时间内重新触发。
      • 失败（Failed）：你的端点未返回 200 HTTP 状态码。
  3. 点击某个事件可查看其详细信息。
事件详情包括：
  • Webhook ID：webhook 订阅的唯一标识符。
  • Event ID：webhook 事件的唯一标识符。
  • 发送至：接收 webhook 事件的通知 URL。
  • HTTP 状态：PayLoco 投递事件时你的 webhook 端点返回的响应。
  • 请求负载：发送到通知 URL 的 JSON 事件负载。
Retrieve webhook secret

​
重新触发 webhook 事件

重新触发会再次投递已发生的事件。适用于因故障未收到事件、调试集成或需要确认幂等处理时。
[信息] 事件只能在发生后 30 天内重新触发。
重新触发一个或多个事件的步骤：
  1. 登录 PayLoco Web 应用，选择 Developer > Events。
  2. 使用 状态 筛选器查找失败的事件（或用其他筛选条件缩小范围）。
  3. 选择一个或多个 webhook 事件，点击 Re-trigger。PayLoco 会重新投递所选事件。
  4. 几分钟后刷新页面，可在更新后的列表顶部看到已重新触发的事件。
Retrieve webhook secret

​
后续步骤

现在你已可以查看和重新触发事件，可以按产品查看 事件类型和负载示例。