微信支付 API
  1. 最佳实践
微信支付 API
  • 文档说明
    • 阅读对象
    • 版本说明
  • 名词表
    • 支付模式
    • 名词解释
    • 参数规定
  • 支付产品
    • 付款码支付
      • 支付账户
      • 场景介绍
      • 验证密码规则
      • 案例介绍
      • 协议规则
      • 开发指引
      • API列表
        • 付款码支付
        • 查询订单
        • 撤销订单
        • 申请退款
        • 查询退款
        • 下载交易账单
        • 下载资金账单
    • JSAPI支付
      • 支付账户
      • 场景介绍
      • 案例介绍
      • 接入前准备
      • 协议规则
      • 开发指引
      • 获取微信版本号
      • API列表
        • 统一下单
        • 查询订单
        • 关闭订单
        • 申请退款
        • 查询退款
        • 下载交易账单
        • 下载资金账单
        • 支付结果通知
        • 退款结果通知
    • Native支付
      • 支付账户
      • 场景介绍
      • 案例及规范
      • 协议规则
      • 开发指引
      • API列表
        • 统一下单
        • 查询订单
        • 关闭订单
        • 申请退款
        • 查询退款
        • 下载交易账单
        • 下载资金账单
        • 支付结果通知
    • APP支付
      • 支付账户
      • 场景介绍
      • 页面推荐示例
      • 协议规则
      • 开发指引
      • API详细说明
      • APP端开发步骤
      • API列表
        • 调起支付接口
        • 统一下单
        • 支付结果通知
        • 查询订单
        • 关闭订单
        • 申请退款
        • 查询退款
  • 接口规则
    • 协议规则
    • 参数规定
    • 安全规范
    • 获取openid
  • API列表
    • 统一下单
      POST
    • 查询订单
      POST
    • 关闭订单
      POST
    • 申请退款
      POST
    • 查询退款
      POST
    • 下载交易账单
      POST
    • 下载资金账单
      POST
    • 支付结果通知
      POST
    • 交易保障
      POST
    • 退款结果通知
      POST
  • API安全
    • 最佳安全实践
    • 安全与网络相关注意事项
    • HTTPS服务器配置
  • 最佳实践
    • 支付回调和查单实现指引
    • 回调通知注意事项
    • 专线商户Notify升级指引
    • 支付验收指引
    • 跨城冗灾方案
  • 运营规范
    • 运营规范
  • SDK与DEMO下载
    • SDK与DEMO下载
  1. 最佳实践

回调通知注意事项

1、notify_url填写注意事项

● notify_url需要填写商户自己系统的真实地址,不能填写接口文档或demo上的示例地址。
● notify_url必须是以https://或http://开头的完整全路径地址,并且确保url中的域名和IP是外网可以访问的,不能填写localhost、127.0.0.1、192.168.x.x等本地或内网IP。
● notify_url不能携带参数。
● 常见错误举例:

错误描述错误示例
url中只有域名,缺少具体的路径http://www.weixin.qq.com
url不是以https://或http://开头,缺少域名或IP./PayNotify.aspx
url中填写了本地或者内网IPhttp://127.0.0.1/pay/notify.php
填写了不是url格式的字符串xxxxxxx,1234567,test

2、返回报文格式规范

● 返回报文必须是xml格式,字段名需与接口文档说明的一致,报文前后和各字段标签中间不能包含特殊字符。
● 常见错误举例:

错误描述错误示例
返回内容为空或者非xml格式字符串ok,success,支付成功
返回的xml格式报文中间有其他字符\n<return_code></return_code> \n<return_msg></return_msg>\n
返回的是json格式{"return_code":"SUCCESS";"return_msg":"OK"}
返回的是整个页面的html代码支付成功通知页面success

3、回调处理逻辑注意事项

● notify_url的代码处理逻辑不能做登录态校验。
● 商户系统收到支付结果通知,需要在5秒内返回应答报文,否则微信支付认为通知失败,后续会重复发送通知。
● 同样的通知可能会多次发送给商户系统,商户系统必须能够正确处理重复的通知。如果已处理过,直接给微信支付返回成功。
● 商户侧对微信支付回调IP有防火墙策略限制的,需要对以下IP段开通白名单:

上海电信出口网段:101.226.103.0/25
上海联通出口网段:140.207.54.0/25
上海CAP出口网段:121.51.58.128/25
深圳电信出口网段:183.3.234.0/25
深圳联通出口网段:58.251.80.0/25
深圳CAP出口网段:121.51.30.128/25
香港出口网段:203.205.219.128/25
退款结果通知、分账动账通知IP(新增):
175.24.214.208、175.24.211.24、175.24.213.135、109.244.180.23、114.132.203.119、43.139.43.69

修改于 2025-09-28 08:36:04
上一页
支付回调和查单实现指引
下一页
专线商户Notify升级指引
Built with