Webhook 与 Callback
Callback 和 webhook 在您的业务操作中具有不同的用途。
您可以在 Cobo Portal > 开发者 > Webhook 事件 / Callback消息 中查看您团队中所有 webhook 事件和Callback消息的数据。
处理 webhook 事件和Callback消息
按照以下步骤处理 WaaS 服务发送的 webhook 事件和Callback消息：- 创建一个 webhook 或Callback Endpoint。
- 选择服务器环境。
- 定义Endpoint URL。
- 在服务器端实现处理逻辑。
- 解析 API 请求。
- 验证签名。
- 响应 API 请求。
- 添加其他处理逻辑（如果适用）。
- 在 Cobo Portal 上注册Endpoint。
注册 Webhook Endpoint 时，您需要指定要订阅的事件类型。
从 WaaS 1.0 升级到 WaaS 2.0 的注意事项
WaaS 1.0 服务使用 API Callback进行交易通知和提币确认，类似于 WaaS 2.0 中引入的 webhook 和Callback。以下表格提供了两种版本基于事件通知机制的比较：
有关 WaaS 1.0 Callback的更多详细信息，请参阅 如何配置 API Callback。
继续使用 WaaS 1.0 API
如果您选择继续使用 WaaS 1.0 API，则无需进行任何额外配置。现有的 API Callback将按预期工作。升级到 WaaS 2.0 API
当升级到 WaaS 2.0 时，您需要执行以下操作：- 按照 设置Callback或 Webhook Endpoint 中的说明设置您的 webhook 或 Callback Endpoint。
- 按照 注册 Webhook Endpoint 或 注册 Callback Endpoint 中的说明在 Cobo Portal 上注册Endpoint。
WaaS 1.0 API Callback使用的签名算法与 WaaS 2.0 webhook 和Callback不同。请勿直接在 Cobo Portal 上注册您的 WaaS 1.0 Endpoint。否则，由于 WaaS 1.0 和 WaaS 2.0 之间的签名算法和 webhook/Callback数据结构的差异，您的Endpoint将收到错误。请确保参考提供的 示例代码 正确配置您的 WaaS 2.0 Endpoint。
如果您为交易通知配置了 WaaS 1.0 API Callback，但没有设置 WaaS 2.0 webhook，您的Endpoint仍将收到来自 WaaS 1.0 的交易通知。
如果您同时为交易通知配置了 WaaS 1.0 API Callback和 WaaS 2.0 webhook，并继续使用 WaaS 1.0 API，您的Endpoint将收到：- 来自 WaaS 1.0 的交易通知。
- 来自 WaaS 2.0 的 webhook 事件。
cobo_id）实现去重，以避免处理重复通知。