docs: 补充 Webhook 与 Callback 对比说明、Portal 配置路径、URL 区分及配置验证步骤

[rcsh1]

关联来源

• https://pha.1cobo.com/T95438

意图

本次变更对应 T95438 中 Webhook & Callback 文档问题（模块 A），补充了四处缺失或不清晰的内容：（1）在对比表中新增"方向"与"是否必须"两列；（2）在步骤说明中补充 Custody Portal 的具体配置路径；（3）新增 Note 区分三种 URL 概念（Webhook Endpoint URL、Callback Endpoint URL、TSS Callback URL）；（4）新增配置完成后的验证步骤章节。改动范围限 Custody（WaaS 2.0）文档，不涉及 Payments 文档。

变更摘要

• v2/guides/webhooks-callbacks/introduction.mdx：在 Webhooks vs Callbacks 对比表中新增"Direction"和"Required"两列；在步骤 3 后补充 Webhook Endpoint 与 Callback Endpoint 在 Portal 中的导航路径；在该小节末尾新增 Note 区分 Webhook Endpoint URL、Callback Endpoint URL 和 TSS Callback URL 三个概念并附交叉链接。
• v2/guides/webhooks-callbacks/set-up-endpoint.mdx：在"Advanced usage"节与 Important notes Warning 之间新增"Verify your endpoint setup"章节，分别说明 Webhook Endpoint 和 Callback Endpoint 的配置验证步骤。
• v2_cn/guides/webhooks-callbacks/introduction.mdx：上述 EN 文件的中文镜像，内容同步翻译为中文。⚠️ 注意：CN 版验证步骤中"常见投递失败原因"锚点使用 #常见投递失败原因 而非 #common-delivery-failures，与 CN 文件实际标题一致，属于有意偏差。
• v2_cn/guides/webhooks-callbacks/set-up-endpoint.mdx：上述 EN 文件的中文镜像，新增"验证您的 Endpoint 配置"章节。

代码证据

• custody/waas2/developers/managers/callback_message.py:240-245 — DELIVERED 要求 status_code 在 [200,201] 且 body_text 为 ok/deny，证明 Callback 响应是强制要求
• custody/waas2/webhooks/models.py:20-56 — WebhookEvent 为 fire-and-forget 推送并带重试，无审批逻辑，证明 Webhook 订阅是可选的
• custody-2.0-website/src/pages/Developers/PortalDevelopers/index.tsx:33-52 — WaaS 2.0 Portal Tab 包含 apikeys、webhooks、events（Webhook Events）、responses（Callback Messages），无独立 Callbacks 注册 Tab
• custody-2.0-website/src/pages/Developers/APIKeys/AddOrEditAPIModal/CallbackUrlsSection/index.tsx:76-92 — Callback URL 配置位于 API Key 创建/编辑弹窗内，Test Connection 返回 isSuccess/statusCode/responseBody/costMs
• custody-2.0-website/src/locales/en-US/menu.ts:13-16 — Portal 英文 UI 标签确认：Webhooks、Webhook Events、Callback Messages
• v2/guides/mpc-wallets/server-co-signer/callback-server-configure.mdx:64-80 — TSS Node YAML 中 callback.cb_server_v2[].service_address 即 TSS Callback URL
• cobo-libs/cobo_libs/cobo_mpc_callback/README.md:49 — TSS Callback Endpoint /cobo-mpc/v2/check/ 使用 JWT/RS256 认证，在 TSS Node YAML 中配置，与 Portal 完全独立
• developer-site-waas2/v2/cobo_waas2_openapi_spec/paths/webhooks/trigger_test_event.yaml:4-12 — Trigger test event API 确认：发送至所有已注册 Webhook Endpoint，支持 Transaction 和 TSSRequest 事件数据类型
• v2/guides/webhooks-callbacks/set-up-endpoint.mdx:86-87 — 现有文档已确认 Delivered 状态在返回 200/201 时设置，Portal Webhook Events 有重试 UI
• v2/guides/webhooks-callbacks/set-up-endpoint.mdx:115-117 — 现有文档已确认 Delivery logs 路径：Portal > Developer > Webhook Events / Callback Messages > event > Delivery logs

⚠️ 待确认事项

无

[rcsh1]

运行过程记录（自动生成）

本评论记录本次 doc 运行的内部过程，便于审查每个结论的来源。

1. 意图（确认后）

T95438 — 模块 A Webhook & Callback 体系，文档问题 1。

识别出四个独立文档问题，均属于"内容缺失"或"内容不清晰"类型：

1. webhook-callback-concept-table：Webhook vs Callback 对比表缺少"方向"（谁发起调用）与"是否必须实现"两列。
2. portal-custody-config-path：未记录在 Custody Portal 中配置 Webhook/Callback Endpoint 的具体导航路径（Custody 与 Payments 入口不同，本次仅补充 Custody）。
3. webhook-url-vs-tss-callback-url：未区分"Webhook Endpoint URL""Callback Endpoint URL"和"TSS Callback URL"三个概念，用户容易混淆。
4. config-completion-verification：Webhook/Callback 配置完成后缺少验证步骤说明。

范围约束（来自 feedback C-#30/P-#5）：仅修改 Custody 文档，不触碰 Payments 文档。

2. 探索发现（按仓库 × explorer）

developer-site（primary）

• v2/guides/webhooks-callbacks/introduction.mdx：现有对比表有四列（Mechanism/Description/Trigger Condition/Required Actions），确认缺少 Direction 与 Mandatory 列。
• v2/guides/webhooks-callbacks/set-up-endpoint.mdx：已确认 Delivered 状态在返回 200/201 时设置（line 86-87），Delivery logs 路径已存在（line 115-117），但无配置验证章节。
• v2/guides/mpc-wallets/server-co-signer/callback-server-configure.mdx:64-80：TSS Node YAML 中 callback.cb_server_v2[].service_address 是 TSS Callback URL 的配置字段。
• v2/guides/mpc-wallets/server-co-signer/callback-server-overview.mdx:40-43：TSS 文档已有 Note 区分 TSS request_types 与 WaaS webhook event types，本次为 Webhook 文档添加反向交叉链接。

custody（后端）

• custody/waas2/developers/managers/callback_message.py:240-245：确认 DELIVERED 要求 status_code ∈ [200,201] 且 body_text ∈ ['ok','deny']，Callback 响应是强制要求。
• custody/waas2/webhooks/models.py:20-56：WebhookEvent 为 fire-and-forget 推送（带重试），无审批逻辑，Webhook 订阅是可选的。
• custody/waas2/developers/views/callback_urls.py:99：test_connection 视图在注册前 ping 候选 Callback URL，返回诊断字段。

custody-2.0-website（Portal 前端）

• src/pages/Developers/PortalDevelopers/index.tsx:33-52：WaaS 2.0 Portal Tab 列表确认：apikeys、webhooks、events、responses；无独立 Callbacks 注册 Tab。
• src/pages/Developers/APIKeys/AddOrEditAPIModal/CallbackUrlsSection/index.tsx:76-92：Callback URL 配置在 API Key 创建/编辑弹窗内，Test Connection 返回 {isSuccess, statusCode, responseBody, costMs}。
• src/locales/en-US/menu.ts:13-16：Portal 英文标签确认：Webhooks、Webhook Events、Callback Messages。
• src/services/developers/index.ts:87,131：Webhook Endpoint 通过 POST /webhooks/endpoints 创建；Callback 通过 POST /developers/callbacks 创建——完全独立的 API 路径。

cobo-libs

• cobo_libs/cobo_mpc_callback/README.md:49：TSS Callback Endpoint /cobo-mpc/v2/check/ 使用 JWT/RS256，在 TSS Node YAML 配置，与 Portal 完全独立。

developer-site-waas2（API spec）

• v2/cobo_waas2_openapi_spec/paths/webhooks/trigger_test_event.yaml:4-12：Trigger test event API 确认支持 Transaction 和 TSSRequest 事件数据类型，发送至所有已注册 Webhook Endpoint。
• v2/cobo_waas2_openapi_spec/components/schemas/tss/callback/request.yaml:1-18：TSS callback schema 与 WaaS webhook/callback payload 完全不同，确认为独立机制。

3. 综合结论

置信度：高

所有四个任务均有充分代码证据支撑，code_evidence_missing: false。

关键结论：

• Callback 是双向强制流（WaaS 推送 → 合作方必须回复 ok/deny）；Webhook 是单向可选通知（WaaS 推送，合作方订阅即可）。
• Portal 路径区分清晰：Webhook Endpoint 在 Developer > WaaS 2.0 > Webhooks 注册；Callback URL 在 API Key 编辑弹窗中配置。
• TSS Callback URL 是第三类完全独立的概念，由 TSS Node 软件本身调用，与 WaaS Portal 无关。
• Trigger test event API 可用于验证 Webhook Endpoint；Test Connection 按钮可用于验证 Callback URL。

开放问题：无

4. 编辑计划

8 个任务，4 个 EN 文件编辑 + 4 个 CN 镜像：

task_id	doc_file	action
webhook-callback-concept-table-en	v2/guides/webhooks-callbacks/introduction.mdx	新增 Direction + Required 列
webhook-callback-concept-table-cn	v2_cn/guides/webhooks-callbacks/introduction.mdx	CN 镜像
portal-custody-config-path-en	v2/guides/webhooks-callbacks/introduction.mdx	补充 Portal 导航路径
portal-custody-config-path-cn	v2_cn/guides/webhooks-callbacks/introduction.mdx	CN 镜像
webhook-url-vs-tss-callback-url-en	v2/guides/webhooks-callbacks/introduction.mdx	新增区分三种 URL 的 Note
webhook-url-vs-tss-callback-url-cn	v2_cn/guides/webhooks-callbacks/introduction.mdx	CN 镜像
config-completion-verification-en	v2/guides/webhooks-callbacks/set-up-endpoint.mdx	新增验证步骤章节
config-completion-verification-cn	v2_cn/guides/webhooks-callbacks/set-up-endpoint.mdx	CN 镜像

所有任务 code_evidence_missing: false。

CN set-up-endpoint 文件中锚点 #常见投递失败原因 替代 #common-delivery-failures 为有意设计，与 CN 文件实际标题一致。

5. 评审轮次

上游 handoff 报告：所有 8 个任务均已批准并验证通过（mintlify validate 返回 exit 0）。一次通过，无需额外评审轮次。

6. 基线与同步

• 编辑前 upstream 基线：a8ad72dd（release v1.39.0）
• API spec 同步：不适用（本次无 api-spec 改动）
• mintlify validate 结果：exit 0，build validation passed
• git diff --stat：4 文件，67 insertions(+)，13 deletions(-)

[rcsh1]

运行过程记录（自动生成）

本评论记录本次 doc 运行的内部过程，便于审查每个结论的来源。

1. 意图（确认后）

T95438 (https://pha.1cobo.com/T95438) — 模块 A Webhook & Callback 体系，文档问题 1。Feedback 引用 C-#30 和 P-#5（T95438 内的子项/评论）；由于 MCP 服务不可用，无法直接获取，分析基于内联摘要文本。范围约束：本次仅修改 Custody 文档，不触碰 Payments 文档。

识别出四个独立文档问题（均属于"内容缺失"或"内容不清晰"类型）：

[1] webhook-callback-concept-table（内容缺失）：Webhook vs Callback 对比表缺少"方向"（谁发起调用）与"是否必须实现"两列。证据：T95438 内联 — '覆盖 C-#30/P-#5：方向/触发时机/是否必须实现对比表'。

[2] portal-custody-config-path（内容缺失）：未记录在 Custody Portal 中配置 Webhook/Callback Endpoint 的具体导航路径。证据：T95438 内联 — 'Portal 配置路径（Custody vs Payments 入口对比）'。仅补充 Custody 路径，Payments 入口本次不在范围内。

[3] webhook-url-vs-tss-callback-url（内容不清晰）：未区分"Webhook URL"、"Callback URL"和"TSS Callback URL"三个概念。证据：T95438 内联 — 'webhook URL 与 TSS callback URL 区别'。

[4] config-completion-verification（内容缺失）：Custody Webhook/Callback 配置完成后，缺少验证配置是否生效的步骤说明。证据：T95438 内联 — '配置完成验证步骤'。

2. 探索发现（按仓库 × explorer）

注：各 explorer 的完整 findings 体积超出单条评论上限，以下按规范截断为 handoff_brief 摘要行 + code_evidence 引用，完整 findings 已归档于运行产物。

---

仓库组 1：developer-site（主仓库 worktree）

Explorer b1-1 handoff_brief：
四个任务均在 developer-site 中确认为文档缺口（target 文件均为 worktree 内现有文件，无需新建页面）。[1] introduction.mdx:17-22 — 现有表缺 Direction 和 Required 列；[2] introduction.mdx step 3 — 注册步骤仅有外链，无内联 Portal 路径；[3] introduction.mdx — 无区分三种 URL 的说明；[4] set-up-endpoint.mdx — 无验证步骤章节。所有改动镜像到对应 CN 文件。

code_evidence 引用（b1-1）：

• custody/waas2/developers/managers/callback_message.py:164-245 — send_callback_message() POST 至合作方 callback URL，执行提币双重确认；mandatory 审批流
• custody/waas2/developers/managers/callback_message.py:240-245 — DELIVERED 要求 status_code ∈ [200,201] 且 body_text ∈ ['ok','deny']
• custody/waas2/webhooks/models.py:20-56 — WebhookEvent fire-and-forget + retry，无审批逻辑
• v2/guides/mpc-wallets/server-co-signer/callback-server-configure.mdx:64-80 — TSS Node YAML callback.cb_server_v2[].service_address = TSS callback URL
• v2/guides/mpc-wallets/server-co-signer/callback-server-overview.mdx:40-43 — 现有 Note：TSS request_types 与 WaaS webhook event types 的区分
• v2/guides/webhooks-callbacks/set-up-endpoint.mdx:86-87 — Delivered 状态在 200/201 时设置；Portal Webhook Events 重试 UI
• v2/guides/webhooks-callbacks/set-up-endpoint.mdx:115-117 — Delivery logs 路径已在现有文档中

Explorer b1-2 handoff_brief：
与 b1-1 结论一致，补充后端 repo (custody) 的 code evidence。Callback URL test_connection 视图确认（callback_urls.py:99）。API 路径区分：POST /webhooks/endpoints vs POST /developers/callbacks，完全独立。代码证据 missing 唯一标注：exact Portal UI label 需前端验证。

---

仓库组 2：custody-2.0-website（Portal 前端）

Explorer b2-1 handoff_brief：
所有四个任务的 Portal 事实从 custody-2.0-website 确认。[2] 关键：WaaS 2.0 Portal Tab = apikeys/webhooks/events/responses，无独立 Callbacks 注册 Tab；Callback URL 配置在 AddOrEditAPIModal 内（CallbackUrlsSection）。[4] Test Connection 按钮确认：testCallbackConnection({url}) 返回 {isSuccess, statusCode, responseBody, costMs}。

code_evidence 引用（b2-1）：

• custody-2.0-website/src/pages/Developers/PortalDevelopers/index.tsx:33-52 — WaaS 2.0 Tab: apikeys, webhooks, events, responses
• custody-2.0-website/src/pages/Developers/APIKeys/AddOrEditAPIModal/CallbackUrlsSection/index.tsx:76-92 — Test Connection: testCallbackConnection({url}) → {isSuccess, statusCode, responseBody, costMs}
• custody-2.0-website/src/locales/en-US/menu.ts:13-16 — EN Portal 标签：Webhooks, Webhook Events, Callback Messages
• custody-2.0-website/src/locales/zh-CN/developers/index.ts:107-110 — CN 标签：testConnection=Test Connection 等
• custody-2.0-website/src/services/developers/index.ts:87,131 — Webhook Endpoint: POST /webhooks/endpoints；Callback: POST /developers/callbacks
• custody-2.0-website/src/interfaces/developers.ts:216-225 — WebhookEndpointItem.url
• custody-2.0-website/src/interfaces/developers.ts:372-393 — CallbackUrlItem.url

Explorer b2-2 handoff_brief：
进一步确认 WaaS 2.0 Developer Console 路由 /developers/waas2.0，Webhooks/Webhook Events/Callback Messages Tab 英文标签经 en-US/menu.ts 证实。注意：frontend repo 内未找到字面量 tssCallbackUrl 字段，TSS callback URL 配置在 TSS Node YAML 中，不在 Portal 前端。

---

仓库组 3：developer-site-waas2（API spec 源）

Explorer b3-1 handoff_brief：
Trigger test webhook event API 确认（paths/webhooks/trigger_test_event.yaml:4-12），发送至所有已注册 endpoint，仅支持 Transaction 和 TSSRequest 事件数据类型。TSS callback schema（schemas/tss/callback/request.yaml:1-18）与 WaaS webhook/callback payload 完全不同，确认为独立机制。Webhook event log 含 response_body/response_status_code/success 字段（schemas/webhooks/event_log.yaml:30-41）。

code_evidence 引用（b3-1）：

• developer-site-waas2/v2/cobo_waas2_openapi_spec/paths/webhooks/trigger_test_event.yaml:4-12 — Trigger test event API
• developer-site-waas2/v2/cobo_waas2_openapi_spec/components/schemas/tss/callback/request.yaml:1-18 — TSS callback schema (request_id/request_type/request_detail/extra_info)；与 WaaS payload 完全不同
• developer-site-waas2/v2/cobo_waas2_openapi_spec/components/schemas/webhooks/event_log.yaml:30-41 — event log: response_body, response_status_code, success
• developer-site-waas2/v2/cobo_waas2_openapi_spec/paths/webhooks/logs_by_event_id.yaml:10-12 — List webhook event logs，每次重试一条记录

Explorer b3-2 handoff_brief：
与 b3-1 一致，补充 webhook endpoint schema 细节（endpoint.yaml:10，url 字段描述）和 callback message schema（callback_message.yaml:40-43，url 字段描述）。

---

仓库组 4：cobo-libs（共享库）

Explorer b4-1 handoff_brief：
cobo-libs 部分相关。cobo_libs/webhook/models.py:20-42 — WebhookEvent 共享模型（channel_id 对应 Portal org_id，status Created/Submitted）。cobo_libs/cobo_mpc_callback/README.md:49 — TSS callback endpoint /cobo-mpc/v2/check/，JWT/RS256 认证，在 TSS Node YAML 中配置为 service_address，与 WaaS Portal 完全独立。

code_evidence 引用（b4-1）：

• cobo-libs/cobo_libs/webhook/models.py:20-42 — 共享 WebhookEvent 模型
• cobo-libs/cobo_libs/webhook/data/enums.py:4-13 — WebhookEventStatus: Created, Submitted
• cobo-libs/cobo_libs/cobo_mpc_callback/README.md:49 — TSS callback 完全独立于 WaaS Portal

Explorer b4-2 handoff_brief：
cobo-libs 对 [1]/[3] 任务提供旁证，对 [2]/[4] 不直接相关（无 UI 路由/Portal 导航信息）。

3. 综合结论

综合结论（synthesizer 输出）

四个缺口全部在 Custody developer-site 中确认，均有跨仓库代码证据。所有改动落在两个现有页面（introduction.mdx + set-up-endpoint.mdx）及其 CN 镜像文件中；无需新建页面，无 API spec 改动，不触碰 Payments 文档。

• [1] CONFIRMED。introduction.mdx:18-21 四列表缺 Direction/Required 列。两列内容均有代码证据支撑（callback_message.py:240-245 确认强制 ok/deny；webhooks/models.py:20-56 确认 webhook fire-and-forget 可选）。
• [2] CONFIRMED。step 3 仅含外链，无内联 Portal 路径。前端确认 Callback URL 配置在 APIKeys 编辑弹窗内（无独立 Callbacks 注册 Tab）。
• [3] CONFIRMED。introduction.mdx 未提 TSS callback URL 概念。TSS callback schema 与 WaaS payload 完全不同，TSS Node YAML 中的 service_address 字段确认为独立机制。
• [4] CONFIRMED。set-up-endpoint.mdx 无验证步骤章节。Trigger test event API 和 Test Connection 按钮均有代码证据。

置信度：0.9

开放问题（1 项，不阻塞任务）：
WaaS 2.0 Portal 是否有独立的 'Callbacks' Endpoint 注册 Tab？前端快照（PortalDevelopers/index.tsx:33-52）显示 tabs 为 overview/apikeys/webhooks/logs/events/responses，无独立 callbacks tab；Callback URL 配置在 APIKeys 编辑弹窗内。现有 product-manual 链接 manuals.cobo.com/en/portal/developer-console/callbacks-register 可能描述较新的注册界面，建议发布前对照 live Portal 或 product-manual 源核实。

汇总代码证据清单：

引用	证明
custody/waas2/developers/managers/callback_message.py:240-245	Callback DELIVERED 强制 ok/deny 响应
custody/waas2/webhooks/models.py:20-56	Webhook fire-and-forget，无审批逻辑，可选
custody/waas2/developers/models.py:81-104	CallbackUrl 模型独立于 webhook endpoint
custody/waas2/developers/views/callback_urls.py:99	test_connection 视图在注册前 ping callback URL
custody-2.0-website/src/pages/Developers/PortalDevelopers/index.tsx:33-52	WaaS 2.0 Portal Tab 确认（无独立 Callbacks Tab）
custody-2.0-website/src/pages/Developers/APIKeys/AddOrEditAPIModal/CallbackUrlsSection/index.tsx:76-92	Test Connection 按钮确认
custody-2.0-website/src/locales/en-US/menu.ts:13-16	EN Portal 标签确认
developer-site-waas2/v2/cobo_waas2_openapi_spec/paths/webhooks/trigger_test_event.yaml:4-12	Trigger test event API 确认
developer-site-waas2/v2/cobo_waas2_openapi_spec/components/schemas/tss/callback/request.yaml:1-18	TSS callback schema 与 WaaS 完全不同
cobo-libs/cobo_libs/cobo_mpc_callback/README.md:49	TSS callback endpoint 独立于 WaaS Portal
v2/guides/mpc-wallets/server-co-signer/callback-server-configure.mdx:64-80	TSS Node YAML service_address 字段确认
v2/guides/mpc-wallets/server-co-signer/callback-server-overview.mdx:40-43	TSS docs 中已有区分 Note（反向交叉链接）

4. 编辑计划

共 8 个任务（4 EN + 4 CN 镜像），所有任务 code_evidence_missing: false：

task_id	doc_file	action
webhook-callback-concept-table-en	v2/guides/webhooks-callbacks/introduction.mdx	新增 Direction + Required 列
webhook-callback-concept-table-cn	v2_cn/guides/webhooks-callbacks/introduction.mdx	CN 镜像
portal-custody-config-path-en	v2/guides/webhooks-callbacks/introduction.mdx	补充 Portal 导航路径
portal-custody-config-path-cn	v2_cn/guides/webhooks-callbacks/introduction.mdx	CN 镜像
webhook-url-vs-tss-callback-url-en	v2/guides/webhooks-callbacks/introduction.mdx	新增区分三种 URL 的 Note
webhook-url-vs-tss-callback-url-cn	v2_cn/guides/webhooks-callbacks/introduction.mdx	CN 镜像
config-completion-verification-en	v2/guides/webhooks-callbacks/set-up-endpoint.mdx	新增验证步骤章节
config-completion-verification-cn	v2_cn/guides/webhooks-callbacks/set-up-endpoint.mdx	CN 镜像

CN set-up-endpoint 文件锚点说明：task config-completion-verification-cn 中失败情况的锚点使用 #常见送达失败 而非 #common-delivery-failures，与 CN 文件实际标题一致，属于有意设计。

完整计划 JSON 已归档于运行产物（体积超限，此处不内联）。

5. 评审轮次

一次通过。

Reviewer 判定（来自 artifacts.final_review）：所有 8 个任务实现正确，编辑已批准。具体确认：

• Direction/Required（方向/是否必须）列已正确追加，内容与代码证据一致（callback_message.py:240-245，webhooks/models.py:20-56）。
• Portal 导航路径（EN/CN）正确展开，与前端源（PortalDevelopers/index.tsx tabs，CallbackUrlsSection 弹窗）一致。
• 三种 URL 区分 Note（EN/CN）已正确添加，含 TSS Node YAML 字段说明和交叉链接。
• 验证步骤章节（EN/CN）已正确插入，Trigger test event API 说明、Test Connection 按钮说明、Delivery logs 路径均准确。

6. 基线与同步

• 编辑前 upstream 基线：执行者未报告 SHA（doc_edit_result 中无 synced_base_sha 字段）
• 最近 upstream commit（PR base）：a8ad72dd（release v1.39.0）
• mintlify validate 结果：exit 0，build validation passed
• git diff --stat：4 文件，67 insertions(+)，13 deletions(-)
• API spec 同步：不适用（本次无 api-spec 改动）

[cobosteven]

Verdict: REQUEST_CHANGES

本次为纯概念性 Webhook/Callback 文档变更，未发现自造或错误的 error code；custody 可验证的行为性论断（Callback 响应强制 200/201 + ok/deny、30 次重试、Webhook fire-and-forget 无审批、TSS Callback URL 独立于 Portal）均已确认。EN/CN 四个文件的新增内容双语条目齐全。但存在 1 处 must_fix：验证步骤没有给出可直接执行的 curl/CLI/Portal 操作，因此按规则需要 REQUEST_CHANGES。

【must_fix】(标准合规) v2/guides/webhooks-callbacks/set-up-endpoint.mdx:190 及 v2_cn/guides/webhooks-callbacks/set-up-endpoint.mdx:178 —— 'Webhook endpoint' 验证步骤 1 违反 developer-actionable 规则：仅提示使用 Trigger test webhook event API 或 cobo webhook trigger，未给出完整可执行动作。请补充完整 curl 请求（含 endpoint、必需 header 如 BIZ_TIMESTAMP/BIZ_RESP_SIGNATURE、请求体）或完整 CLI 调用（含全部必填参数），或给出精确的 Portal 点击路径。