支付结果通知

更新时间：2025.03.21

以下情况需要调用关单接口：商户订单支付失败需要生成新单号重新发起支付，要对原订单号调用关单，避免重复支付；系统下单后，用户支付超时，系统退出不再受理，避免用户继续，请调用关单接口。

注意：

● 同样的通知可能会多次发送给商户系统。商户系统必须能够正确处理重复的通知。

● 后台通知交互时，如果微信收到商户的应答不符合规范或超时，微信会判定本次通知失败，重新发送通知，直到成功为止（在通知一直不成功的情况下，微信总共会发起多次通知，通知频率为15s/15s/30s/3m/10m/20m/30m/30m/30m/60m/3h/3h/3h/6h/6h - 总计 24h4m），但微信不保证通知最终一定能成功。

● 在订单状态不明或者没有收到微信支付结果通知的情况下，建议商户主动调用微信支付【查询订单API】确认订单状态。

特别提醒：

● 商户系统对于支付结果通知的内容一定要做签名验证,并校验返回的订单金额是否与商户侧的订单金额一致，防止数据泄露导致出现“假通知”，造成资金损失。

● 当收到通知进行处理时，首先检查对应业务数据的状态，判断该通知是否已经处理过，如果没有处理过再进行处理，如果处理过直接返回结果成功。在对业务数据进行状态检查和处理之前，要采用数据锁进行并发控制，以避免函数重入造成的数据混乱。

● 技术人员可登进微信商户后台扫描加入接口报警群，获取接口告警信息。

接口说明

适用对象: 直连模式机构模式

请求URL: 该链接是通过【统一下单API】中提交的参数notify_url设置，如果链接无法访问，商户将无法接收到微信通知。通知url必须为直接可访问的url，不能携带参数。示例：notify_url：“https://pay.weixin.qq.com/wxpay/pay.action”

是否需要证书: 否

通知参数

字段名	变量名	类型	必填	描述
返回状态码	return_code	string(16)	是	SUCCESS/FAIL 此字段是通信标识，非交易标识，交易是否成功需要查看result_code来判断示例值：SUCCESS
返回信息	return_msg	string(128)	否	返回信息，如非空，为错误原因签名失败参数格式校验错误示例值：签名失败

以下字段在return_code为SUCCESS的时候有返回

字段名	变量名	类型	必填	描述
公众号ID	appid	string(32)	是	公众号ID 示例值：wxd678efh567hg6787
商户号	mch_id	string(32)	是	微信支付分配的商户号示例值：1230000109
子商户公众号ID	sub_appid	string(32)	是	微信分配的小程序ID 注意：仅适用于机构模式示例值：wx8888888888888888
子商户号	sub_mch_id	string(32)	是	微信支付分配的子商户号注意：仅适用于机构模式示例值：1900000109
设备号	device_info	string(32)	否	微信支付分配的终端设备号示例值：013467007045764
随机字符串	nonce_str	string(32)	是	随机字符串，不长于32位示例值：5K8264ILTKCH16CQ2502SI8ZNMTM67VS
签名	sign	string(64)	是	签名，详见签名生成算法示例值：C380BEC2BFD727A4B6845133519F3AD6
业务结果	result_code	string(16)	是	SUCCESS/FAIL 示例值：SUCCESS
业务结果描述	result_msg	string(32)	是	对于业务执行的详细描述示例值：OK
错误代码	err_code	string(32)	否	错误返回的信息描述示例值：SYSTEMERROR
错误代码描述	err_code_des	string(128)	否	错误返回的信息描述示例值：系统错误
用户标识	openid	string(128)	是	用户在商户appid下的唯一标识示例值：oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
是否关注公众账号	is_subscribe	string(1)	是	用户是否关注公众账号， Y：关注 N：未关注示例值：Y
用户子标识	sub_openid	string(128)	否	用户在子商户appid下的唯一标识注意：仅适用于机构模式示例值：wxd930ea5d5a258f4f
是否关注子公众账号	sub_is_subscribe	string(1)	否	用户是否关注子公众账号， Y：关注 N：未关注注意：仅适用于机构模式示例值：Y
交易类型	trade_type	string(16)	是	JSAPI、NATIVE、APP 示例值：JSAPI
付款银行	bank_type	string(32)	是	银行类型，采用字符串类型的银行标识，银行类型见银行类型示例值：CMC
总金额	total_fee	int	是	订单总金额，单位为分示例值：100
货币种类	fee_type	string(8)	否	货币类型，符合ISO 4217标准的三位字母代码，默认人民币：CNY，其他值列表详见货币类型示例值：CNY
现金支付金额	cash_fee	int	是	现金支付金额订单现金支付金额，详见支付金额示例值：100
现金支付货币类型	cash_fee_type	string(16)	否	货币类型，符合ISO 4217标准的三位字母代码，默认人民币：CNY，其他值列表详见货币类型示例值：CNY
应结订单金额	settlement_total_fee	int	否	应结订单金额=订单金额-非充值代金券金额，应结订单金额 <=订单金额示例值：100
微信支付订单号	transaction_id	string(32)	是	微信支付订单号示例值：1217752501201407033233368018
商户订单号	out_trade_no	string(32)	是	商户系统内部订单号，要求32个字符内，只能是数字、大小写字母_-\|*@ ，且在同一个商户号下唯一。示例值：1212321211201407033568112322
商家数据包	attach	string(128)	否	商家数据包，原样返回示例值：123456
支付完成时间	time_end	string(14)	是	支付完成时间，格式为yyyyMMddHHmmss，如2009年12月25日9点10分10秒表示为20091225091010。其他详见时间规则示例值：20141030133525
汇率	rate_value	string(16)	是	标价币种与支付币种的兑换比例乘以10的8次方即为此值，例如美元兑换人民币的比例为6.5，则rate=650000000 示例值：650000000

举例如下：

1<xml>
2   <appid><![CDATA[wx2421b1c4370ec43b]]></appid>
3   <sub_appid><![CDATA[wx2421b1c4370ec13b]]></sub_appid>
4   <attach><![CDATA[支付测试]]></attach>
5   <bank_type><![CDATA[CFT]]></bank_type>
6   <fee_type><![CDATA[CNY]]></fee_type>
7   <is_subscribe><![CDATA[Y]]></is_subscribe>
8   <mch_id><![CDATA[10000100]]></mch_id>
9   <nonce_str><![CDATA[5d2b6c2a8db53831f7eda20af46e531c]]></nonce_str>
10   <openid><![CDATA[oUpF8uMEb4qRXf22hE3X68TekukE]]></openid>
11   <out_trade_no><![CDATA[1409811653]]></out_trade_no>
12   <result_code><![CDATA[SUCCESS]]></result_code>
13   <return_code><![CDATA[SUCCESS]]></return_code>
14   <sign><![CDATA[B552ED6B279343CB493C5DD0D78AB241]]></sign>
15   <sub_mch_id><![CDATA[10000100]]></sub_mch_id>
16   <time_end><![CDATA[20140903131540]]></time_end>
17   <rate_value><![CDATA[650000000]]></rate_value>
18   <total_fee><![CDATA[1]]></total_fee>
19   <trade_type><![CDATA[JSAPI]]></trade_type>
20   <transaction_id><![CDATA[1004400740201409030005092168]]></transaction_id>
21</xml>

返回参数

字段名	变量名	类型	必填	描述
返回状态码	return_code	string(16)	是	SUCCESS/FAIL SUCCESS表示商户接收通知成功并校验成功示例值：SUCCESS
返回信息	return_msg	string(128)	否	返回信息，如非空，为错误原因签名失败参数格式校验错误示例值：OK

举例如下：

1<xml>
2   <return_code><![CDATA[SUCCESS]]></return_code>
3   <return_msg><![CDATA[OK]]></return_msg>
4</xml>