企业内部开发
基础
连接微信
办公
会议
会议统计管理
企业内部开发
服务端API
企业支付
向员工付款
查询付款记录
查询付款记录
最后更新:2020/01/13

API接口协议

用于商户的企业微信企业付款操作进行结果查询,返回付款操作详细结果。
查询企业微信企业付款API只支持查询30天内的订单,30天之前的订单请登录商户平台查询。

 

请求方式:POST(HTTPS
请求地址:https://api.mch.weixin.qq.com/mmpaymkttransfers/promotion/querywwsptrans2pocket
是否需要证书:请求需要双向证书。 详见证书使用
数据格式:xml

请求示例:

<xml>
     <sign><![CDATA[E1EE61A91C8E90F299DE6AE075D60A2D]]></sign>
     <partner_trade_no><![CDATA[0010010404201411170000046545]]></partner_trade_no>
     <mch_id ><![CDATA[10000097]]></mch_id >
     <appid><![CDATA[wxe062425f740c8888]]></appid>
     <nonce_str><![CDATA[50780e0cca98c8c8e814883e5caa672e]]></nonce_str>
</xml>

参数说明:

字段名字段必填示例值类型说明
随机字符串nonce_str5K8264ILTKCH16CQ2502SI8ZNMTM67VSString(32)随机字符串,不长于32位
微信支付签名signC380BEC2BFD727A4B6845133519F3AD6String(32)参见“签名算法
商户订单号partner_trade_no10000098201411111234567890String(28)商户调用企业微信企业付款API时使用的商户订单号
商户号mch_id10000098String(32)微信支付分配的商户号
Appidappidwxe062425f740d30d8String(128)商户号的appid

返回结果 :

<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[0010010404201411170000046545]]></partner_trade_no>
<status><![CDATA[SUCCESS]]></status>
<payment_amount>100</payment_amount >
<openid ><![CDATA[oxTWIuGaIt6gTKsQRLau2M0yL16E]]></openid>
<transfer_time><![CDATA[2017-07-22 20:10:15]]></transfer_time>
<transfer_name ><![CDATA[测试]]></transfer_name >
<desc><![CDATA[付款测试]]></desc>
</xml>

返回参数:

字段名字段必填示例值类型说明
返回状态码return_codeSUCCESSString(16)SUCCESS/FAIL此字段是通信标识,非交易标识,交易是否成功需要查看result_code来判断
返回信息return_msg签名失败String(128)返回信息,如非空,为错误原因

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

字段名字段必填示例值类型说明
业务结果result_codeSUCCESSString(16)SUCCESS/FAIL
错误代码err_codeSYSTEMERRORString(32)错误码信息
错误代码描述err_code_des系统错误String(128)结果信息描述

以下字段在return_code 和result_code都为SUCCESS的时候有返回:

字段名字段必填示例值类型说明
商户订单号partner_trade_no10000098201411111234567890String(32)商户使用查询API填写的单号的原路返回
商户号mch_id10000098String(32)微信支付分配的商户号
付款单号detail_id1000000000201503283103439304String(64)调用企业微信企业付款API时,微信系统内部产生的单号
转账状态statusSUCCESSstring(16)SUCCESS:转账成功 FAILED:转账失败 PROCESSING:处理中
失败原因reason余额不足String(128)如果失败则有失败原因
收款用户openidopenidoxTWIuGaIt6gTKsQRLau2M0yL16EString(64)转账的openid
收款用户姓名transfer_name马华String(64)收款用户姓名
付款金额payment_amount5000int付款金额单位分
转账时间transfer_time2015-04-21 20:00:00String(32)发起转账的时间
付款描述desc用车补贴String(100)付款时候的描述

错误码:

错误码错误描述解决方式
CA_ERROR请求未携带证书,或请求携带的证书出错到商户平台下载证书,请求带上证书后重试
SIGN_ERROR微信支付签名错误按文档要求重新生成签名后再重试
NO_AUTH没有权限请联系微信支付开通api权限
FREQ_LIMIT受频率限制请对请求做频率控制
XML_ERROR请求的xml格式错误,或者post的数据为空检查请求串,确认无误后重试
PARAM_ERROR参数错误请查看err_code_des,修改设置错误的参数
SYSTEMERROR系统繁忙,请再试系统繁忙
NOT_FOUND指定单号数据不存在查询单号对应的数据不存在,请使用正确的商户订单号查询
WORKWX_MCHID_ERROR企业微信商户号和企业关系校验失败确认是否已经绑定商户号和企业微信的关系
WORKWX_SIGN_ERROR企业微信签名错误按文档要求重新生成签名后再重试
上一篇向员工付款
下一篇向员工收款
    本节内容
服务端API
基础
连接微信
办公
会议
会议统计管理
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们