开发者上线前检查清单

只有完整请求与通知链路经过受控流量验证后才能上线。一次目录查询成功，并不能证明鉴权、资金、下单、查询、Webhook 和恢复流程都已经具备生产条件。

明确责任人与接入范围

记录应用负责人、值班联系人、允许产品、预期流量、数据分类、客服路径和变更窗口。

处理“开发者上线前检查清单”时，应把“明确责任人与接入范围”作为一个独立检查点，不要同时修改多个条件。记录页面现象、操作时间和相关业务编号，每次只执行一个有依据的步骤，并等待系统给出明确结果。

保护唯一有效 API Key

确认 Key 保存在秘密系统中，不出现在源码或日志，并配置尽可能窄且必填的 IPv4 或 CIDR 白名单。

处理“开发者上线前检查清单”时，应把“保护唯一有效 API Key”作为一个独立检查点，不要同时修改多个条件。记录页面现象、操作时间和相关业务编号，每次只执行一个有依据的步骤，并等待系统给出明确结果。

所有链路使用 HTTPS

Partner API 调用和 Webhook 都必须使用 HTTPS。验证证书、主机名、跳转和生产网络可达性。

处理“开发者上线前检查清单”时，应把“所有链路使用 HTTPS”作为一个独立检查点，不要同时修改多个条件。记录页面现象、操作时间和相关业务编号，每次只执行一个有依据的步骤，并等待系统给出明确结果。

实现订单幂等

每次业务尝试生成一个稳定 partnerOrderNo。超时后查询原订单，不能自动创建替代编号再次下单。

处理“开发者上线前检查清单”时，应把“实现订单幂等”作为一个独立检查点，不要同时修改多个条件。记录页面现象、操作时间和相关业务编号，每次只执行一个有依据的步骤，并等待系统给出明确结果。

执行价格与余额保护

接码根据批准的业务限额设置 maxPrice。目录库存只是估算，必须安全处理价格、库存和余额拒绝。

处理“开发者上线前检查清单”时，应把“执行价格与余额保护”作为一个独立检查点，不要同时修改多个条件。记录页面现象、操作时间和相关业务编号，每次只执行一个有依据的步骤，并等待系统给出明确结果。

按语义处理错误与重试

按稳定 code 分支，保留 traceId，修正不可重试请求；只有文档定义的临时故障才使用带退避的有限重试。

处理“开发者上线前检查清单”时，应把“按语义处理错误与重试”作为一个独立检查点，不要同时修改多个条件。记录页面现象、操作时间和相关业务编号，每次只执行一个有依据的步骤，并等待系统给出明确结果。

验证 Webhook 安全

验证签名，在副作用前保存事件身份，安全接收后返回精确 SUCCESS，并能处理最多五次通知。

处理“开发者上线前检查清单”时，应把“验证 Webhook 安全”作为一个独立检查点，不要同时修改多个条件。记录页面现象、操作时间和相关业务编号，每次只执行一个有依据的步骤，并等待系统给出明确结果。

监控并演练回滚

监控鉴权失败、订单错误、Webhook 重试、延迟和异常状态比例，并明确停止流量、撤销 Key 和保存证据的方法。

处理“开发者上线前检查清单”时，应把“监控并演练回滚”作为一个独立检查点，不要同时修改多个条件。记录页面现象、操作时间和相关业务编号，每次只执行一个有依据的步骤，并等待系统给出明确结果。

实际操作检查清单

1. 核对“明确责任人与接入范围”对应的信息，保存可验证结果；只有下一步含义明确时才继续操作。
2. 核对“保护唯一有效 API Key”对应的信息，保存可验证结果；只有下一步含义明确时才继续操作。
3. 核对“所有链路使用 HTTPS”对应的信息，保存可验证结果；只有下一步含义明确时才继续操作。
4. 核对“实现订单幂等”对应的信息，保存可验证结果；只有下一步含义明确时才继续操作。
5. 核对“执行价格与余额保护”对应的信息，保存可验证结果；只有下一步含义明确时才继续操作。
6. 核对“按语义处理错误与重试”对应的信息，保存可验证结果；只有下一步含义明确时才继续操作。
7. 核对“验证 Webhook 安全”对应的信息，保存可验证结果；只有下一步含义明确时才继续操作。
8. 核对“监控并演练回滚”对应的信息，保存可验证结果；只有下一步含义明确时才继续操作。

最终业务状态和账户流水是判断结果的依据。截图或客服沟通中不要发送密码、完整验证码、认证密钥、Access Token、API Key 或未遮挡的身份材料。更多说明可查看 MangoOTP 帮助中心。