【支付】企业付款开发者文档
简介
企业付款业务是基于支付商户平台的资金管理能力,为了协助商户方便地实现企业向个人付款,针对部分有开发能力的商户,提供通过API完成企业付款的功能。
比如目前的保险行业向客户退保、给付、理赔。
企业付款将使用商户的可用余额,需确保可用余额充足。查看可用余额、充值、提现请登录商户平台“资金管理”进行操作。pay.weixin.qq/
注意:与商户支付收款资金并非同一账户,需要单独充值。
接口介绍
业务流程
接口
简介
付款
企业付款
用于企业向用户个人付款
目前支持向指定用户的openid付款。(获取openid参见公众平台开发者文档: 网页授权获取用户基本信息)
接口调用规则:
◆ 给同一个实名用户付款,单笔单日限额2W/2W
◆ 不支持给非实名用户打款
◆ 一个商户同一日付款总额限额100W
◆ 单笔最小金额默认为1元
◆ 每个用户每天最多可付款10次,可以在商户平台--API安全进行设置
◆ 给同一个用户付款时间间隔不得低于15秒
注意1-当返回错误码为“SYSTEMERROR”时,一定要使用原单号重试,否则可能造成重复支付等资金风险。
注意2-根据监管要求,新申请商户号使用企业付款需要满足两个条件:1、入驻时间超过90天 2、连续正常交易30天。
接口地址
接口链接:h.weixin.qq/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地址
数据示例:
返回参数
字段名
变量名
必填
示例值
类型
描述
返回状态码
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的时候有返回
字段名
变量名
必填
示例值
类型
描述
商户订单号
partner_trade_no
121775*********7033233368018
String(32)
商户订单号,需保持唯一性
(只能是字母或者数字,不能包含有符号)
订单号
payment_no
1007752501201407033233368018
String
企业付款成功,返回的订单号
支付成功时间
payment_time
2015-05-19 15:26:59
String
企业付款成功时间
成功示例: