开放 API 接入前准备

使用自己的 API Key

在开发者页面申请或创建所需权限的 Key，设置必要的出口和限额。不要把 Key 写入公开网页或分享给第三方；子账号还需有主账户授予的对应权限。

保持请求可追溯

按具体接口文档提供幂等键，并保存请求标识和订单 ID。相同业务重试沿用同一个幂等键；遇到超时先查已有订单。完整路径、参数与返回码请登录后阅读当前开放 API 文档。

准备接入权限

先登录开发者页面，使用自己账号获准的能力。

1. 查看对应 API 功能是否已开通；子账号同时检查主账号授予的权限。
2. 创建所需权限的 Key，按业务配置出口 IP 和资金或操作限制。
3. 在服务器端安全保存凭据，不写入公开网页。
4. 打开当前开发者文档，核对准确路径、鉴权、参数与错误码。

手册截图只展示入口位置，不包含可用的 API Key。

建议的最小接入顺序

先做好结果查询和幂等，再连接写入操作。

1. 用只读接口验证鉴权与出口限制。
2. 为同一个业务请求保存固定幂等键。
3. 提交后记录请求标识与平台订单号。
4. 用查询接口确认订单状态，再处理回调和售后逻辑。

接口失败怎样排查

依次检查 HTTP 状态、业务错误码、权限、限额和幂等键。网络超时不等于订单失败；先查询已有订单，再决定是否重试。向客服提供脱敏请求、请求标识、时间和错误码，不提交密钥或完整卡资料。