商户对接

商户对接常见问题及解决方案

情况一：IP错误，无法提交代付订单

错误信息："code":2045,"msg":"IP error." 原因：商户提交代付订单的服务器IP未加白在我方系统。 解决方案：请商户提供服务器IP，并在后台添加至白名单。

---

情况二：非法访问

错误信息：Uncaught (in promise) Error: Illegal request for visit. 可能原因：

1. 商户未加白我方回调IP。

2. 商户网址域名可能使用CDN，导致无法获取到正确的回调IP。

解决方案： ✅ 检查商户是否已在后台正确配置回调IP白名单。 ✅ 若商户使用CDN，请确认回调时能获取到正确的回调IP。

---

情况三：通知推送失败

错误信息：payIn notify Http Push error 原因：商户未在我方后台设置通知地址，导致推送失败。 解决方案：提醒商户在后台正确配置通知地址（notify URL）。

---

情况四：代收下单失败

错误信息："code":500,"msg":"None satisfied pay channel." 可能原因：

1. 未给商户配置代收通道。

2. 通道内无可用的账号。

3. 商户下单金额低于通道设置的金额范围。

解决方案： ✅ 配置对应的代收通道。 ✅ 确保通道内有可用的账号。 ✅ 调整下单金额或调整通道的金额范围。

---

情况五：商户需要配置多个回调地址

问题：后台通常只能配置一个回调地址，但商户希望配置多个回调地址。 解决方案：商户可在下单时新增 notifyUrl 参数，以支持多个回调地址。

---

情况六：代收下单或余额查询提示 "No Permission"

错误信息：No Permission 原因：请求的URL错误（无需加白IP的操作）。 解决方案：检查请求的URL是否正确，确保调用的是正确的API地址。