企业微信付款接口

企业付款

简介

企业付款业务是基于微信支付商户平台的资金管理能力，为了协助商户方便地实现企业向个人付款，针对部分有开发能力的商户，提供通过API完成企业付款的功能。

比如目前的保险行业向客户退保、给付、理赔。

企业付款将使用商户的可用余额，需确保可用余额充足。查看可用余额、充值、提现请登录商户平台“资金管理”进行操作。https://pay.weixin.qq.com/

注意：与商户微信支付收款资金并非同一账户，需要单独充值。

接口介绍

业务流程	接口	简介
付款	企业付款	用于企业向微信用户个人付款 目前支持向指定微信用户的openid付款。（获取openid参见微信公众平台开发者文档： 网页授权获取用户基本信息）

接口调用规则：
◆ 给同一个实名用户付款，单笔单日限额2W/2W

◆ 不支持给非实名用户打款

◆ 一个商户同一日付款总额限额100W

◆ 单笔最小金额默认为1元

◆ 每个用户每天最多可付款10次，可以在商户平台--API安全进行设置

◆ 给同一个用户付款时间间隔不得低于15秒

注意1-当返回错误码为“SYSTEMERROR”时，一定要使用原单号重试，否则可能造成重复支付等资金风险。

注意2-新申请商户号使用企业付款需要满足两个条件：1、入驻时间超过90天 2、连续正常交易30天。

接口地址

接口链接：https://api.mch.weixin.qq.com/mmpaymkttransfers/promotion/transfers

是否需要证书

请求需要双向证书。 详见证书使用

请求参数

变量名

字段名	必填	示例值	类型	描述
商户账号appid	mch_appid	是	wx8888888888888888	String	微信分配的账号ID（企业号corpid即为此appId）
商户号	mchid	是	1900000109	String(32)	微信支付分配的商户号
设备号	device_info	否	013467007045764	String(32)	微信支付分配的终端设备号
随机字符串	nonce_str	是	5K8264ILTKCH16CQ2502SI8ZNMTM67VS	String(32)	随机字符串，不长于32位
签名	sign	是	C380BEC2BFD727A4B6845133519F3AD6	String(32)	签名，详见签名算法
商户订单号	partner_trade_no	是	10000098201411111234567890	String	商户订单号，需保持唯一性 (只能是字母或者数字，不能包含有符号)
用户openid	openid	是	oxTWIuGaIt6gTKsQRLau2M0yL16E	String	商户appid下，某用户的openid
校验用户姓名选项	check_name	是	FORCE_CHECK	String	NO_CHECK：不校验真实姓名 FORCE_CHECK：强校验真实姓名
收款用户姓名	re_user_name	可选	马花花	String	收款用户真实姓名。 如果check_name设置为FORCE_CHECK，则必填用户真实姓名
金额	amount	是	10099	int	企业付款金额，单位为分
企业付款描述信息	desc	是	理赔	String	企业付款操作说明信息。必填。
Ip地址	spbill_create_ip	是	192.168.0.1	String(32)	调用接口的机器Ip地址

数据示例：

<xml>

<mch_appid>wxe062425f740c30d8</mch_appid>

<mchid>10000098</mchid>

<nonce_str>3PG2J4ILTKCH16CQ2502SI8ZNMTM67VS</nonce_str>

<partner_trade_no>100000982014120919616</partner_trade_no>

<openid>ohO4Gt7wVPxIT1A9GjFaMYMiZY1s</openid>

<check_name>FORCE_CHECK</check_name>

<re_user_name>张三</re_user_name>

<amount>100</amount>

<desc>节日快乐!</desc>

<spbill_create_ip>10.2.3.10</spbill_create_ip>

<sign>C97BDBACF37622775366F38B629F45E3</sign>

</xml>

返回参数

字段名	变量名	必填	示例值	类型	描述
返回状态码	return_code	是	SUCCESS	String(16)	SUCCESS/FAIL 此字段是通信标识，非交易标识，交易是否成功需要查看result_code来判断
返回信息	return_msg	否	签名失败	String(128)	返回信息，如非空，为错误原因 签名失败 参数格式校验错误

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

字段名	变量名	必填	示例值	类型	描述
商户appid	mch_appid	是	wx8888888888888888	String	微信分配的公众账号ID（企业号corpid即为此appId）
商户号	mchid	是	1900000109	String(32)	微信支付分配的商户号
设备号	device_info	否	013467007045764	String(32)	微信支付分配的终端设备号，
随机字符串	nonce_str	是	5K8264ILTKCH16CQ2502SI8ZNMTM67VS	String(32)	随机字符串，不长于32位
业务结果	result_code	是	SUCCESS	String(16)	SUCCESS/FAIL
错误代码	err_code	否	SYSTEMERROR	String(32)	错误码信息
错误代码描述	err_code_des	否	系统错误	String(128)	结果信息描述

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

成功示例：

<xml>

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

<return_msg><![CDATA[]]></return_msg>

<mch_appid><![CDATA[wxec38b8ff840bd989]]></mch_appid>

<mchid><![CDATA[10013274]]></mchid>

<device_info><![CDATA[]]></device_info>

<nonce_str><![CDATA[lxuDzMnRjpcXzxLx0q]]></nonce_str>

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

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

<payment_no><![CDATA[1000018301201505190181489473]]></payment_no>

<payment_time><![CDATA[2015-05-19 15：26：59]]></payment_time>

</xml>

错误示例：

<xml>

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

<return_msg><![CDATA[系统繁忙,请稍后再试.]]></return_msg>

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

<err_code><![CDATA[SYSTEMERROR]]></err_code>

<err_code_des><![CDATA[系统繁忙,请稍后再试.]]></err_code_des>

</xml>

错误码

错误代码	描述	原因	解决方案
NOAUTH	没有权限	没有授权请求此api	请联系微信支付开通api权限
AMOUNT_LIMIT	付款金额不能小于最低限额	付款金额不能小于最低限额	每次付款金额必须大于1元
PARAM_ERROR	参数错误	参数缺失，或参数格式出错，参数不合法等	请查看err_code_des，修改设置错误的参数
OPENID_ERROR	Openid错误	Openid格式错误或者不属于商家公众账号	请核对商户自身公众号appid和用户在此公众号下的openid。
NOTENOUGH	余额不足	帐号余额不足	请用户充值或更换支付卡后再支付
SYSTEMERROR	系统繁忙，请稍后再试。	系统错误，请重试	请使用原单号以及原请求参数重试，否则可能造成重复支付等资金风险
NAME_MISMATCH	姓名校验出错	请求参数里填写了需要检验姓名，但是输入了错误的姓名	填写正确的用户姓名
SIGN_ERROR	签名错误	没有按照文档要求进行签名	签名前没有按照要求进行排序。 没有使用商户平台设置的密钥进行签名 参数有空格或者进行了encode后进行签名。
XML_ERROR	Post内容出错	Post请求数据不是合法的xml格式内容	修改post的内容
FATAL_ERROR	两次请求参数不一致	两次请求商户单号一样，但是参数不一致	如果想重试前一次的请求，请用原参数重试，如果重新发送，请更换单号。
CA_ERROR	证书出错	请求没带证书或者带上了错误的证书	到商户平台下载证书 请求的时候带上该证书
V2_ACCOUNT_SIMPLE_BAN	无法给非实名用户付款	用户微信支付账户未知名，无法付款	引导用户在微信支付内进行绑卡实名