账户回调配置

账户回调配置接口用于查询、更新和测试当前账户的回调地址、鉴权密钥、停用状态及事件订阅白名单。

enabled_actions 订阅语义

enabled_actions 是允许投递的 action_id 白名单：

值	含义
null	兼容存量配置，订阅全部可过滤事件
[]	显式空白名单，不投递任何可过滤事件
["order:issued", ...]	仅投递数组中列出的事件

更新接口采用局部更新语义：不传 enabled_actions（或传 JSON null）时保留原值；传空数组时关闭全部可过滤事件；传非空数组时替换整个白名单。服务端会去重并按字典序保存。数组最多包含 200 项，且每一项都必须是服务端支持过滤的 action_id。

订阅范围

更新接口不支持把 enabled_actions 恢复为 null。如果需要订阅全部事件，请显式提交希望接收的完整事件列表。事件名称参见回调通知；部分内部或旁路事件不支持加入白名单，以接口校验结果为准。

白名单只在事件进入回调队列时生效。先关闭某事件、事件发生后再重新开启，不会补发关闭期间被过滤的历史事件。

disabled=true 会停用回调。停用期间被取消的投递，在重新启用后不会自动补发。

接口列表

接口	方法	路径
查询回调配置	GET	/openapi/v3/account/callback
更新回调配置	PUT	/openapi/v3/account/callback
测试回调配置	PUT	/openapi/v3/account/callback/test

相关文档

• 回调通知 — 回调请求格式、事件列表和重试策略
• 错误码说明 — 账户回调配置相关错误码