Decision API 错误与事件命名
先处理 HTTP 状态,再解释策略决策。account-change URL 使用连字符,JSON event 则为 account_change。401、409、422、429 或 503 表示请求、授权或服务处理状态,不是 allow/review/decline。
鉴权与路由
401 表示配置的密钥缺失或错误,或试点账号认证失败。试点模式的 409 表示事件没有批准路由。客户端指定未知或未授权供应商 ID 时返回 422。指定获准路由不能绕过账号认证。
校验与事件映射
URL/请求体事件配对为 onboarding/onboarding、payout/payout 和 account-change/account_change。不匹配或 schema 无效返回 422。subject 字段可选不表示每家供应商都能在缺少必填标识时工作。未知事件路径必须校验失败,不执行其他事件。
限流与不可用
429 表示受控试点限流。503 可能表示生产密钥缺失、试点配置不完整或上游不可用。内部诊断应结合 detail,然后执行调用方的有限重试或复核流程。默认生产 trace 查询仍不可用。
来源与范围
依据 alpha 契约与代码;真实路由可用性需单独确认。