向员工付款
POST
https://api.mch.weixin.qq.com/mmpaymkttransfers/promotion/paywwsptrans2pocket
服务端API企业内部开发
API接口协议
是否需要证书：请求需要双向证书。
| 字段名 | 字段 | 必填 | 示例值 | 类型 | 说 明 |
|---|---|---|---|---|---|
| 商户appid | appid | 是 | wx8888888888888888 | String(128) | 微信分配的公众账号ID（企业微信corpid即为此appid） |
| 商户号 | mch_id | 是 | 1900000109 | String(32) | 微信支付分配的商户号 |
| 设备号 | device_info | 否 | 013467007045764 | String(32) | 终端设备号 |
| 随机字符串 | nonce_str | 是 | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS | String(32) | 随机字符串，不长于32位 |
| 业务结果 | result_code | 是 | SUCCESS | String(16) | SUCCESS/FAIL，注意：当状态为FAIL时，存在业务结果未明确的情况，所以如果状态为FAIL，请务必再请求一次查询接口，通过查询接口确认此次付款结果。如果要重试，请使用原商户订单号+原参数重试，避免重复付款。 |
| 错误代码 | err_code | 否 | SYSTEMERROR | String(32) | 错误码信息 |
| 错误代码描述 | err_code_des | 否 | 系统错误 | String(128) | 结果信息描述 |
| 字段名 | 字段 | 必填 | 示例值 | 类型 | 说明 |
|---|---|---|---|---|---|
| 商户订单号 | partner_trade_no | 是 | 1217752501201407033233368018 | String(32) | 商户订单号，需保持唯一性(只能是字母或者数字，不能包含有符号) |
| 微信订单号 | payment_no | 是 | 1007752501201407033233368018 | String(64) | 企业微信企业付款成功，返回的微 信订单号 |
| 微信支付成功时间 | payment_time | 是 | 2017-07-19 15：26：59 | String(32) | 企业微信企业付款成功时间 |
| 错误码 | 错误描述 | 原因 | 解决方式 |
|---|---|---|---|
| NOAUTH | 没有权限 | 没有授权请求此api | 请联系微信支付开通api权限 |
| AMOUNT_LIMIT | 付款金额不能小于最低限额 | 付款金额不能小于最低限额 | 每次付款金额必须大于1元 |
| PARAM_ERROR | 参数错误 | 参数缺失，或参数格式出错，参数不合法等 | 请查看err_code_des，修改设置错误的参数 |
| OPENID_ERROR | Openid错误 | Openid格式错误或者不属于商家公众账号 | 请核对商户自身公众号appid和用户在此公众号下的openid |
| NOTENOUGH | 余额不足 | 帐号余额不足 | 请用户充值后再支付 |
| SYSTEMERROR | 系统繁忙，请稍后再试 | 系统错误，请重试 | 使用原单号以及原请求参数重试 |
| NAME_MISMATCH | 姓名校验出错 | 请求参数里填写了需要检验姓名，但是输入了错误的姓名 | 填写正确的用户姓名 |
| SIGN_ERROR | 微信支付签名错误 | 没有按照文档要求进行签名 | 1.签名前没有按照要求进行排序。 2.没有使用商户平台设置的密钥进行签名 3.参数有空格或者进行了encode后进行签名。 |
| XML_ERROR | Post内容出错 | Post请求数据不是合法的xml格式内容 | 修改post的内容 |
| HTTP_METHOD_ERROR | 发 送请求方式错误 | 发送请求方式错误 | 改为使用http post的方式来请求 |
| FATAL_ERROR | 两次请求参数不一致 | 两次请求商户单号一样，但是参数不一致 | 如果想重试前一次的请求，请用原参数重试，如果重新发送，请更换单号 |
| CA_ERROR | 证书出错 | 请求没带证书或者带上了错误的证书 | 1.到商户平台下载证书 2.请求的时候带上该证书 3.请通过查询接口确认此次付款结果；如果要重试，请使用原商户订单号+原参数重试，避免重复付款。 |
| V2_ACCOUNT_SIMPLE_BAN | 无法给非实名用户付款 | 用户微信支付账户未知名，无法付款 | 引导用户在微信支付内进行绑卡实名 |
| WORKWX_MCHID_ERROR | 企业微信商户号和企业关系校验失败 | 企业微信商户号和企业关系校验失败 | 确认是否已经绑定商户号和企业微信的关系 |
| WORKWX_SIGN_ERROR | 企业微信签名错误 | 企业微信签名校验失败 | 按文档要求重新生成签名后再重试 |
| SENDNUM_LIMIT | 用户今日付款次数超过限制 | 用户今日付款次数超过限制 | 登录微信支付商户平台更改API安全配置，如果要继续付款必须使用原商户订单号重试。 |
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/90278
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.mch.weixin.qq.com/mmpaymkttransfers/promotion/paywwsptrans2pocket' \
--header 'Content-Type: application/xml' \
--data-raw '<xml>
<appid>wxe062425f740c8888</appid>
<mch_id>1900000109</mch_id>
<device_info>013467007045764</device_info>
<nonce_str>3PG2J4ILTKCH16CQ2502SI8ZNMTM67VS</nonce_str>
<sign>C97BDBACF37622775366F38B629F45E3</sign>
<partner_trade_no>100000982017072019616</partner_trade_no>
<openid>ohO4Gt7wVPxIT1A9GjFaMYMiZY1s</openid>
<check_name>NO_CHECK</check_name>
<re_user_name>张三</re_user_name>
<amount>100</amount>
<desc>六月出差报销费用</desc>
<spbill_create_ip>10.2.3.10</spbill_create_ip>
<workwx_sign>99BCDAFF065A4B95628E3DB468A874A8</workwx_sign>
<ww_msg_type>NORMAL_MSG</ww_msg_type>
<act_name>示例项目</act_name>
</xml>'响应示例响应示例
<xml>
<return_code><![CDATA[SUCCESS]]></return_code>
<return_msg><![CDATA[ok]]></return_msg>
<appid><![CDATA[wxec38b8ff840b8888]]></appid>
<mch_id><![CDATA[1900000109]]></mch_id>
<device_info><![CDATA[013467007045764]]></device_info>
<nonce_str><![CDATA[lxuDzMnRjpcXzxLx0q]]></nonce_str>
<result_code><![CDATA[SUCCESS]]></result_code>
<partner_trade_no><![CDATA[100000982017072019616]]></partner_trade_no>
<payment_no><![CDATA[1000018301201505190181489473]]></payment_no>
<payment_time><![CDATA[2017-07-20 22：05：59]]></payment_time>
</xml>
请求参数
Body 参数application/xml
返回响应
扫码加入交流群修改于 2022-01-14 04:25:44