Hooks

Overview

Hooks 是第三方合作方 webhook 回调接口，用于同步用户收款、订单履约、仓储、跨境物流轨迹、费用和包裹等异步事件。

Base Path: /hooks

Chapters

章节	文档	Method	说明
00	章节概览	-	Hooks 章节、已有接口和待补充项
01	用户与 Payoneer 回调	GET	Payoneer 注册/绑卡完成回调
02	订单与物流回调	POST	仓储、订单、物流轨迹、费用和包裹回调契约

Authentication and Verification

Hook authentication is endpoint-specific. 已实现的 Payoneer 回调目前使用查询参数识别事件；订单与物流回调计划使用 X-API-KEY、X-API-SIGNATURE、X-API-Timestamp。

Error Handling

如果 hook 处理失败，应返回对应 HTTP 错误状态，便于合作方按重试策略重新投递。