【微信支付】notify_url 回调地址详解

原创已于 2024-12-24 21:43:39 修改 · 7.2k 阅读

25 ·

本内容遵循CC 4.0 BY-SA版权协议

标签

#微信 #微信小程序 #小程序 #前端

于 2024-12-24 21:40:55 首次发布

微信小程序专栏收录该内容

21 篇文章

订阅专栏

文章目录

在使用微信支付的过程中，notify_url 是一个非常重要的参数。它被用于接收支付结果通知，帮助开发者完成支付状态的更新。本文将详细解析 notify_url 的作用、使用场景以及开发过程中需要注意的事项。

一、什么是 `notify_url`？

1. 基本定义

notify_url 是在调用微信支付统一下单接口（https://api.mch.weixin.qq.com/pay/unifiedorder）时需要提供的参数之一。它的主要作用是指定支付结果通知的接收地址。

官方定义：

参数名称：notify_url
类型：String(256)
描述：支付结果通知的回调地址，必须为直接可访问的 HTTPS URL。

微信支付官方链接：[支付结果通知](

2. 工作机制

在用户完成支付后，微信支付服务器会主动向 notify_url 指定的地址发送支付结果的通知。
通知内容通常包括订单号、支付状态、交易金额等信息。
后端服务器需要对通知内容进行验证和处理，例如更新订单状态、记录支付日志等。

二、`notify_url` 的使用场景

1. 支付状态更新

通过 notify_url，微信支付可以将订单的支付结果实时推送到开发者的服务器。开发者可以根据通知内容更新订单状态，例如：

支付成功：将订单状态更新为“已支付”。
支付失败：记录失败原因，提醒用户重新支付。

2. 异步通知

notify_url 设计为异步通知机制，即：

即使用户支付成功后未返回商户页面，微信支付仍会发送通知。
确保支付结果能够准确传递给商户系统，避免因网络原因丢失支付状态。

三、`notify_url` 的调用时机

1. 调用统一下单接口

notify_url 参数必须在调用统一下单接口时一并提交。例如：

<xml>
  <appid>wx1111111111111111</appid>
  <mch_id>10000100</mch_id>
  <nonce_str>111111111111111111</nonce_str>
  <body>JSAPI支付测试</body>
  <out_trade_no>20150806125346</out_trade_no>
  <total_fee>88</total_fee>
  <spbill_create_ip>123.12.12.123</spbill_create_ip>
  <notify_url>https://yourdomain.com/api/pay_notify</notify_url>
  <trade_type>JSAPI</trade_type>
  <sign>1111111111111111111111</sign>
</xml>

2. 微信支付服务器记录回调地址

调用统一下单接口时，微信支付服务器会记录 notify_url，但不会立即调用。只有在用户完成支付后，微信支付才会向该地址发送支付结果通知。

四、支付结果通知的处理流程

1. 接收通知

开发者需要在 notify_url 指定的接口中编写逻辑，用于接收和解析支付结果通知。例如：

from flask import Flask, request

app = Flask(__name__)

@app.route('/api/pay_notify', methods=['POST'])
def pay_notify():
    data = request.data  # 接收微信服务器发送的 XML 数据
    print("支付通知内容：", data)
    return "<xml><return_code>SUCCESS</return_code><return_msg>OK</return_msg></xml>"