查询付款

更新时间: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、如需查询超过有效期的单据,请登录到商户平台进行查询

 

更多技术问题
技术咨询
反馈
咨询
目录
置顶