微信开发：企业微信支付之API参考接口文档

微信邦

企业付款

API介绍
1.简介企业付款业务是基于微信支付商户平台的资金管理能力，为了协助商户方便地实现企业向个人付款，针对部分有开发能力的商户，提供通过API完成企业付款的功能。
比如目前的保险行业向客户退保、给付、理赔。

企业付款将使用商户的可用余额，需确保可用余额充足。查看可用余额、充值、提现请登录商户平台“资金管理”进行操作。https://pay.weixin.qq.com/
注意：与商户微信支付收款资金并非同一账户，需要单独充值。

2.接口介绍

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

3.接口说明

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

请求Url:https://api.mch.weixin.qq.com/mm ... promotion/transfers

是否需要证书：是

请求参数:

字段名	字段	必填	示例值	类型	说明
公众账号appid	mch_appid	是	wx8888888888888888	String	商户appid
商户号	mchid	是	1900000109	String(32)	微信支付分配的商户号
子商户号	sub_mch_id	否	1900000109	String(32)	微信支付分配的子商户号，受理模式下必填
设备号	device_info	否	013467007045764	String(32)	微信支付分配的终端设备号
随机字符串	nonce_str	是	5K8264ILTKCH16CQ2502SI8ZNMTM67VS	String(32)	随机字符串，不长于32位
签名	sign	是	C380BEC2BFD727A4B6845133519F3AD6	String(32)	生成签名方式查看2.1节
商户订单号	partner_trade_no	是	10000098201411111234567890	String	商户订单号，需保持唯一性
用户openid	openid	是	oxTWIuGaIt6gTKsQRLau2M0yL16E	String	商户appid下，某用户的openid
校验用户姓名选项	check_name	是	OPTION_CHECK	String	NO_CHECK：不校验真实姓名 FORCE_CHECK：强校验真实姓名（未实名认证的用户会校验失败，无法转账） OPTION_CHECK：针对已实名认证的用户才校验真实姓名（未实名认证用户不校验，可以转账成功）
收款用户姓名	re_user_name	可选	马花花	String	收款用户真实姓名。 如果check_name设置为FORCE_CHECK或OPTION_CHECK，则必填用户真实姓名
金额	amount	是	10099	Uint64_t	企业付款金额，单位为分
企业付款描述信息	desc	是	理赔	String	企业付款操作说明信息。必填。
Ip地址	spbill_create_ip	是	192.168.0.1	String(32)	调用接口的机器Ip地址

数据示例：

Xml待补充

返回参数

字段名	变量名	必填	示例值	类型	说明
返回状态码	return_code	是	SUCCESS	String(16)	SUCCESS/FAIL 此字段是通信标识，非交易标识，交易是否成功需要查看result_code来判断
返回信息	return_msg	否	签名失败	String(128)	返回信息，如非空，为错误原因 签名失败 参数格式校验错误
以下字段在return_code为SUCCESS的时候有返回
商户appid	mch_appid	是		String	商户appid
商户号	mchid	是		String(32)	微信支付分配的商户号
设备号	device_info	否		String(32)	微信支付分配的终端设备号，
随机字符串	nonce_str	是		String(32)	随机字符串，不长于32位
签名	sign	是	C380BEC2BFD727A4B6845133519F3AD6	String(32)	生成签名方式查看2.1节
业务结果	result_code	是		String(16)	SUCCESS/FAIL
错误代码	err_code	否		String(32)	错误码信息
错误代码描述	err_code_des	否		String(128)	结果信息描述
以下字段在return_code 和result_code都为SUCCESS的时候有返回
商户订单号	partner_trade_no	是		String(32)	商户订单号，需保持唯一性
微信订单号	payment_no	是		String	企业付款成功，返回的微信订单号
微信成功时间	payment_time	是		String	企业付款成功时间

示例：

Xml待补充

错误码

错误代码	描述	原因	解决方案