查询企业付款

简介

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

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

注意事项

◆ 如果查询单号对应的数据不存在,那么数据不存在的原因可能是:(1)付款还在处理中;(2)付款处理失败导致付款订单没有落地。在上述情况下,商户首先需要检查该商户订单号是否确实是自己发起的,如果商户确认是自己发起的,则请商户不要直接当做付款失败处理,请商户隔几分钟再尝试查询(请勿付款和查询并发处理),或者商户可以通过相同的商户订单号再次发起付款。如果商户误把还在付款处理中的订单直接当付款失败处理,商户应当自行承担因此产生的所有损失和责任。

◆ XML具有可扩展性,因此返回参数可能会有新增,而且顺序可能不完全遵循此文档规范,如果在解析回包的时候发生错误,请商户务必不要换单重试,请商户联系客服确认付款情况。如果有新回包字段,会更新到此API文档中。

◆ 因为错误代码字段err_code的值后续可能会增加,所以商户如果遇到回包返回新的错误码,请商户务必不要换单重试,请商户联系客服确认付款情况。如果有新的错误码,会更新到此API文档中。

◆ 错误代码描述字段err_code_des只供人工定位问题时做参考,系统实现时请不要依赖这个字段来做自动化处理。

接口调用请求说明

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

请求参数

字段名 字段 必填 示例值 类型 说明
随机字符串 nonce_str 5K8264ILTKCH16CQ2502SI8ZNMTM67VS String(32) 随机字符串,不长于32位
签名 sign C380BEC2BFD727A4B6845133519F3AD6 String(32) 生成签名方式查看3.2.1节
商户订单号 partner_trade_no 10000098201411111234567890 String(32) 商户调用企业付款API时使用的商户订单号
商户号 mch_id 10000098 String(32) 微信支付分配的商户号
Appid appid wxe062425f740d30d8 String(128) 商户号的appid

数据示例:

<xml>

     <sign><![CDATA[E1EE61A91C8E90F299DE6AE075D60A2D]]></sign>

     <partner_trade_no><![CDATA[0010010404201411170000046545]]></partner_trade_no>

     <mch_id ><![CDATA[10000097]]></mch_id >

     <appid><![CDATA[wxe062425f740c30d8]]></appid>

     <nonce_str><![CDATA[50780e0cca98c8c8e814883e5caa672e]]></nonce_str>

</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) 企业付款备注

示例:

<xml> // 按照格式补充

<return_code><![CDATA[SUCCESS]]></return_code>

<return_msg><![CDATA[获取成功]]></return_msg>

<result_code><![CDATA[SUCCESS]]></result_code>

<mch_id>10000098</mch_id>

<appid><![CDATA[wxe062425f740c30d8]]></appid>

<detail_id><![CDATA[1000000000201503283103439304]]></detail_id>

<partner_trade_no><![CDATA[1000005901201407261446939628]]></partner_trade_no>

<status><![CDATA[SUCCESS]]></status>

<payment_amount>650</payment_amount >

<openid ><![CDATA[oxTWIuGaIt6gTKsQRLau2M0yL16E]]></openid>

<transfer_time><![CDATA[2015-04-21 20:00:00]]></transfer_time>

<transfer_name ><![CDATA[测试]]></transfer_name >

<desc><![CDATA[福利测试]]></desc>

</xml>

错误码

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

1、查询单号对应的数据不存在,请使用正确的商户订单号查询

2、如需查询超过有效期的单据,请登录到商户平台进行查询