跳到主要内容

回调通知出来指南

1. “notify_url”输入指南:

  • 确保notify_url设置为商家系统的实际地址,而不是界面文档或演示中提供的示例地址。

  • notify_url应该是以“https://”或“http://”开头的完全限定路径。URL中的域名和IP都可以从外部访问,这一点至关重要。

  • 避免使用本地或内部IP地址,如localhost、127.0.0.1或192.168.x.x作为notify_url。

  • 最好不要将参数附加到notify_url。

常见错误及其描述:

错误 示例
URL只是一个没有特定路径的域https://www.test.com
URL缺少“https://”或“http://”,或者缺少域名/IP/payNotify.php
使用本地或intranet IPhttp://127.0.0.1/pay/notify.php
非URL格式的字符串xxxxxxx,1234567,test

2. 回调逻辑注意事项:

  • notify_url的处理逻辑不应涉及任何登录状态或权限检查。

  • 商户必须验证通知的签名,以避免虚假通知。此外,将通知中的订单金额与商家系统中的订单数量进行交叉检查。

  • 在收到付款通知后,商家的系统应在5秒内进行确认。否则,CodePay将认为通知尝试失败,从而提示将来重试。

  • 商户应预计多次收到同一通知的可能性。因此,请确保系统能够无错误地处理重复的通知。如果已经处理了通知,只需向CodePay发送成功确认即可。

  • 如果有防火墙策略限制商户端的CodePay回调IP,请确保将以下IP列入白名单:

3.135.111.52
18.217.220.157