查询付款

更新时间：2024.11.13

简介

用于商户的付款操作进行结果查询，返回付款操作详细结果。

查询付款API只支持查询30天内的订单，30天之前的订单请登录商户平台查询。

注意事项：

如果查询单号对应的数据不存在，那么数据不存在的原因可能是：
（1）付款还在处理中；
（2）付款处理失败导致付款订单没有落地。
在上述情况下，商户首先需要检查该商户订单号是否确实是自己发起的，如果商户确认是自己发起的，则请商户不要直接当做付款失败处理，请商户隔几分钟再尝试查询（请勿付款和查询并发处理），或者商户可以通过相同的商户订单号再次发起付款（支持2个自然日内的单据，超过2个自然日请确认付款失败后再换单发起）。如果商户误把还在付款处理中的订单直接当付款失败处理，商户应当自行承担因此产生的所有损失和责任。
XML具有可扩展性，因此返回参数可能会有新增，而且顺序可能不完全遵循此文档规范，如果在解析回包的时候发生错误，请商户务必不要换单重试，请商户联系客服确认付款情况。如果有新回包字段，会更新到此API文档中。
因为错误代码字段err_code的值后续可能会增加，所以商户如果遇到回包返回新的错误码，请商户务必不要换单重试，请商户联系客服确认付款情况。如果有新的错误码，会更新到此API文档中。
错误代码描述字段err_code_des只供人工定位问题时做参考，系统实现时请不要依赖这个字段来做自动化处理。

接口调用请求说明

请求Url	https://api.mch.weixin.qq.com/mmpaymkttransfers/gettransferinfo
是否需要证书	是（证书及使用说明详见商户证书）
请求方式	POST
签名方式	MD5
接口调用频率限制	30/s

请求参数

字段名	字段	必填	示例值	类型	说明
随机字符串	nonce_str	是	5K8264ILTKCH16CQ2502SI8ZNMTM67VS	String(32)	随机字符串，不长于32位
签名	sign	是	C380BEC2BFD727A4B6845133519F3AD6	String(32)	签名，详见签名算法
商户订单号	partner_trade_no	是	10000098201411111234567890	String(32)	商户调用付款API时使用的商户订单号
商户号	mch_id	是	10000098	String(32)	微信支付分配的商户号
Appid	appid	是	wxe062425f740d30d8	String(128)	商户号的appid

数据示例：

1<xml>
2     <sign><![CDATA[E1EE61A91C8E90F299DE6AE075D60A2D]]></sign>
3     <partner_trade_no><![CDATA[0010010404201411170000046545]]></partner_trade_no>
4     <mch_id ><![CDATA[10000097]]></mch_id >
5     <appid><![CDATA[wxe062425f740c30d8]]></appid>
6     <nonce_str><![CDATA[50780e0cca98c8c8e814883e5caa672e]]></nonce_str>
7</xml>

返回参数

字段名	变量名	必填	示例值	类型	说明
返回状态码	return_code	是	SUCCESS	String(16)	SUCCESS/FAIL 此字段是通信标识，非付款标识，付款是否成功需要查看result_code来判断
返回信息	return_msg	否	签名失败	String(128)	返回信息，如非空，为错误原因签名失败参数格式校验错误
以下字段在return_code为SUCCESS的时候有返回
业务结果	result_code	是	SUCCESS	String(16)	SUCCESS/FAIL ，非付款标识，付款是否成功需要查看status字段来判断
错误代码	err_code	否	SYSTEMERROR	String(32)	错误码信息
错误代码描述	err_code_des	否	系统错误	String(128)	结果信息描述
以下字段在return_code 和result_code都为SUCCESS的时候有返回
商户单号	partner_trade_no	是	10000098201411111234567890	String(32)	商户使用查询API填写的单号的原路返回.
Appid	appid	是	wxe062425f740d30d8	String(128)	商户号的appid
商户号	mch_id	是	10000098	String(32)	微信支付分配的商户号
付款单号	detail_id	是	1000000000201503283103439304	String(64)	调用付款API时，微信支付系统内部产生的单号
转账状态	status	是	SUCCESS	string(16)	SUCCESS:转账成功 FAILED:转账失败 PROCESSING:处理中
失败原因	reason	否	余额不足	String(128)	如果失败则有失败原因
收款用户openid	openid	是	oxTWIuGaIt6gTKsQRLau2M0yL16E	String(64)	转账的openid
收款用户姓名	transfer_name	否	马华	String(64)	收款用户姓名
付款金额	payment_amount	是	5000	int	付款金额单位为“分”
转账时间	transfer_time	是	2015-04-21 20:00:00	String(32)	发起转账的时间
付款成功时间	payment_time	是	2015-04-21 20:01:00	String(32)	付款成功时间
付款备注	desc	是	车险理赔	String(100)	付款备注

示例：

1<xml> // 按照格式补充
2  <return_code><![CDATA[SUCCESS]]></return_code>
3  <return_msg><![CDATA[获取成功]]></return_msg>
4  <result_code><![CDATA[SUCCESS]]></result_code>
5  <mch_id>10000098</mch_id>
6  <appid><![CDATA[wxe062425f740c30d8]]></appid>
7  <detail_id><![CDATA[1000000000201503283103439304]]></detail_id>
8  <partner_trade_no><![CDATA[1000005901201407261446939628]]></partner_trade_no>
9  <status><![CDATA[SUCCESS]]></status>
10  <payment_amount>650</payment_amount >
11  <openid ><![CDATA[oxTWIuGaIt6gTKsQRLau2M0yL16E]]></openid>
12  <transfer_time><![CDATA[2015-04-21 20:00:00]]></transfer_time>
13  <transfer_name ><![CDATA[测试]]></transfer_name >
14  <desc><![CDATA[福利测试]]></desc>
15</xml>

错误码

错误代码	描述	解决方案
CA_ERROR	请求未携带证书，或请求携带的证书出错	到商户平台下载证书，请求带上证书后重试
SIGN_ERROR	商户签名错误	按文档要求重新生成签名后再重试
FREQ_LIMIT	受频率限制	请对请求做频率控制
XML_ERROR	请求的xml格式错误，或者post的数据为空	检查请求串，确认无误后重试
PARAM_ERROR	参数错误	请查看err_code_des，修改设置错误的参数
SYSTEMERROR	系统繁忙，请再试	系统繁忙
NOT_FOUND	1、指定单号数据不存在 2、指定单号数据不存在，单据查询超过有效期	1、查询单号对应的数据不存在，请使用正确的商户订单号查询 2、如需查询超过有效期的单据，请登录到商户平台进行查询

文档是否有帮助

更多支持

开发文档(服务商)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服