开发者设置
商户后台
开发者设置
开发者设置用于管理商户接入 PayCools API 所需的核心凭证与安全配置，包括 AppID、Webhook 回调地址、API Key（商户公钥）以及 IP 白名单。这些参数是接口调用、签名验签、回调接收与访问控制的基础。
1
配置入口
登录商户后台，通过以下路径进入开发者设置页面：
开发者设置 → 应用详情
在应用详情页面可查看并编辑 AppID、Webhook、API Key 与 IP 白名单等配置项。
2
字段说明
| 字段 | 说明 |
|---|---|
| 统一配置开关 | 开启后（默认开启），在当前国家下配置的 Webhook、API Key 等信息将自动同步至其他国家，实现「一次配置、多国生效」；关闭后各国家配置相互独立。 |
| AppID | 应用的唯一标识，用于在 API 请求中标识商户身份，调用接口时需携带。 |
| Webhook | 代付结果回调通知地址（Notify URL）。代付交易状态变更时，平台会向该地址异步推送通知，商户应据此更新订单状态。地址须为 HTTPS 且支持 POST 请求，平台会对通知报文签名，商户需使用平台公钥验签。 |
| API Key（公钥） | 商户上传至平台的 RSA 公钥（2048 位）。平台使用该公钥验证商户请求的签名，商户需使用与之配对的私钥对请求签名。详见 技术参数配置。 |
| IP 白名单 | 允许发起 API 请求的服务器 IP 地址。仅白名单内的 IP 可成功调用接口，未加白的请求将被拒绝；支持单 IP 与 CIDR 网段，多条以换行分隔。如需调整请联系 PayCools 团队。测试环境不校验 IP 白名单。 |
3
配置注意事项
- 密钥安全：商户私钥需妥善保管，切勿前端暴露或提交至代码仓库。一旦泄露，请立即重新生成密钥对并更新后台公钥配置。
- 公钥更新：更新公钥后，平台将使用新公钥对后续请求验签，请确保服务端同步切换至对应私钥签名，避免验签失败。
- Webhook 安全：回调地址必须为 HTTPS 协议；收到通知后应先使用平台公钥验签，再处理业务逻辑，防止伪造请求。
- 多国同步：「统一配置开关」开启时，配置变更会自动同步至其他国家，请确认变更对其他国家的影响。
- 环境差异：测试环境不校验 IP 白名单，便于调试；生产环境强烈建议启用 IP 白名单以提升安全性。
4
相关文档
- 技术参数配置（公钥配置） — 公钥生成、上传与 IP 白名单、回调地址配置的详细步骤。
- 配置与签名 — 签名规则与验签机制说明。
- 环境信息 — 各环境请求地址与平台公钥。