企业内部开发 服务端API 企业支付 向员工付款 向员工付款
向员工付款

API接口协议

接口调用规则:

  • 给同一个实名用户付款,单笔单日限额200/200元
  • 一个商户同一日付款总额限额10W
  • 如需提额,可以在微信支付商户平台-产品中心-我的产品-运营工具-企业付款到零钱-产品设置中设置
  • 不支持给非实名用户打款
  • 单笔最小金额默认为1元
  • 每个用户每天最多可付款10次,可以在商户平台--API安全进行设置
  • 给同一个用户付款时间间隔不得低于15秒

请求示例:

<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>

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

证书使用详见:https://pay.weixin.qq.com/wiki/doc/api/tools/mch_pay.php?chapter=4_3

参数说明:

字段名字段必填示例值类型说明
公众账号appidappidwx8888888888888888String(128)微信分配的公众账号ID(企业微信corpid即为此appid)
商户号mch_id1900000109String(32)微信支付分配的商户号
设备号device_info013467007045764String(32)微信支付分配的终端设备号
随机字符串nonce_str5K8264ILTKCH16CQ2502SI8ZNMTM67VSString(32)随机字符串,不长于32位
微信支付签名signC380BEC2BFD727A4B6845133519F3AD6String(32)参见“签名算法
商户订单号partner_trade_no10000098201411111234567890String(32)商户订单号,需保持唯一性(只能是字母或者数字,不能包含有符号)
用户openidopenidoxTWIuGaIt6gTKsQRLau2M0yL16EString(64)商户appid下,某用户的openid。获取用户openid参见:http://work.weixin.qq.com/api/doc#11279
校验用户姓名选项check_nameFORCE_CHECKString(16)NO_CHECK:不校验真实姓名 FORCE_CHECK:强校验真实姓名
收款用户姓名re_user_name马花花String(64)收款用户真实姓名。 如果check_name设置为FORCE_CHECK,则必填用户真实姓名
金额amount10099int企业微信企业付款金额,单位为分
付款说明desc六月出差报销费用String(81)向员工付款说明信息。必填
Ip地址spbill_create_ip192.168.0.1String(32)调用接口的机器Ip地址
企业微信签名workwx_signC380BEC2BFD727A4B6845133519F3AD6String(128)参见“签名算法
付款消息类型ww_msg_typeNORMAL_MSGStringNORMAL_MSG:普通付款消息 APPROVAL _MSG:审批付款消息
审批单号approval_number201705160008Stringww_msg_type为APPROVAL _MSG时,需要填写approval_number
审批类型approval_type1intww_msg_type为APPROVAL _MSG时,需要填写1
项目名称act_name产品部门报销String项目名称,最长50个utf8字符
付款的应用idagentid1unsigned int以企业应用的名义付款,企业应用id,整型,可在企业微信管理端应用的设置页面查看。

返回结果 :

<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 220559]]></payment_time>
</xml>

返回参数:

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

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

字段名字段必填示例值类型说明
商户appidappidwx8888888888888888String(128)微信分配的公众账号ID(企业微信corpid即为此appid)
商户号mch_id1900000109String(32)微信支付分配的商户号
设备号device_info013467007045764String(32)终端设备号
随机字符串nonce_str5K8264ILTKCH16CQ2502SI8ZNMTM67VSString(32)随机字符串,不长于32位
业务结果result_codeSUCCESSString(16)SUCCESS/FAIL,注意:当状态为FAIL时,存在业务结果未明确的情况,所以如果状态为FAIL,请务必再请求一次查询接口,通过查询接口确认此次付款结果。如果要重试,请使用原商户订单号+原参数重试,避免重复付款。
错误代码err_codeSYSTEMERRORString(32)错误码信息
错误代码描述err_code_des系统错误String(128)结果信息描述

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

字段名字段必填示例值类型说明
商户订单号partner_trade_no1217752501201407033233368018String(32)商户订单号,需保持唯一性(只能是字母或者数字,不能包含有符号)
微信订单号payment_no1007752501201407033233368018String(64)企业微信企业付款成功,返回的微信订单号
微信支付成功时间payment_time2017-07-19 15:26:59String(32)企业微信企业付款成功时间

错误码:

错误码错误描述原因解决方式
NOAUTH没有权限没有授权请求此api请联系微信支付开通api权限
AMOUNT_LIMIT付款金额不能小于最低限额付款金额不能小于最低限额每次付款金额必须大于1元
PARAM_ERROR参数错误参数缺失,或参数格式出错,参数不合法等请查看err_code_des,修改设置错误的参数
OPENID_ERROROpenid错误Openid格式错误或者不属于商家公众账号请核对商户自身公众号appid和用户在此公众号下的openid
NOTENOUGH余额不足帐号余额不足请用户充值后再支付
SYSTEMERROR系统繁忙,请稍后再试系统错误,请重试使用原单号以及原请求参数重试
NAME_MISMATCH姓名校验出错请求参数里填写了需要检验姓名,但是输入了错误的姓名填写正确的用户姓名
SIGN_ERROR微信支付签名错误没有按照文档要求进行签名1.签名前没有按照要求进行排序。
2.没有使用商户平台设置的密钥进行签名
3.参数有空格或者进行了encode后进行签名。
XML_ERRORPost内容出错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安全配置,如果要继续付款必须使用原商户订单号重试。
上一篇
查询红包记录
下一篇
查询付款记录