作者:重庆互联网小徐 发布时间:2024-02-07 浏览:28290 赞(2860) 收藏 评论(0)
应用场景
微信订单支付成功后,服务商代子商户发起分账请求,将结算后的钱分到分账接收方。多次分账请求仅会按照传入的分账接收方进行分账,不会对剩余的金额进行任何操作。故操作成功后,在待分账金额不等于零时,订单依旧能够再次进行分账。
多次分账,可以将本商户作为分账接收方直接传入,实现释放资金给本商户的功能
对同一笔订单最多能发起20次多次分账请求
接口限频:
单个服务商(请求分账) 300QPS,如果超过频率限制,会报错FREQUENCY_LIMITED,请降低频率请求。
单个交易收款商户(请求分账) 30QPS,如果超过频率限制,会报错FREQUENCY_LIMITED,请降低频率请求。同时,建议对同一主体的商户拆分多个商户号进行交易,避免交易集中到单个商户。
http://api.weixin.qq.com/_/pay/multiprofitsharing
名称 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|---|
子商户号 | sub_mch_id | 是 | string(32) | 1900000109 | 微信支付分配的子商户号 |
子商户公众账号ID | sub_appid | 否 | string(32) | wx8888888888888888 | 微信分配的子商户公众账号ID |
随机字符串 | nonce_str | 是 | string(32) | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS | 随机字符串,不长于32位。推荐随机数生成算法 |
微信订单号 | transaction_id | 是 | string(32) | 4208450740201411110007820472 | 微信支付订单号 |
商户分账单号 | out_order_no | 是 | string(64) | P20150806125346 | 商户系统内部的分账单号,在商户系统内部唯一(单次分账、多次分账、完结分账应使用不同的商户分账单号),同一分账单号多次请求等同一次。只能是数字、大小写字母_-|*@ |
分账接收方列表 | receivers | 是 | String(10240) | [ { "type": "MERCHANT_ID", "account":"190001001", "amount":100, "description": "分到商户" }, { "type": "PERSONAL_WECHATID", "account":"86693952", "amount":888, "description": "分到个人" } ] | 分账接收方列表,不超过50个json对象,可以设置出资子商户作为分账接受方 点击行前的+展开字段详情 |
receivers 是个 JSON 序列化后的字符串,JSON 序列化前是个对象数组,其中的对象的定义如下:
名称 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|---|
-分账接收方类型 | type | 是 | string(32) | MERCHANT_ID | MERCHANT_ID:商户ID PERSONAL_OPENID:个人openid(由父商户APPID转换得到)PERSONAL_SUB_OPENID: 个人sub_openid(由子商户APPID转换得到) |
-分账接收方账号 | account | 是 | string(64) | 86693852 | 类型是MERCHANT_ID时,是商户ID 类型是PERSONAL_OPENID时,是个人openid 类型是PERSONAL_SUB_OPENID时,是个人sub_openid |
-分账金额 | amount | 是 | int | 888 | 分账金额,单位为分,只能为整数,不能超过原订单支付金额及最大分账比例金额 |
-分账描述 | description | 是 | string(80) | 分给商户A | 分账的原因描述,分账账单中需要体现 |
-分账个人接收方姓名 | name | 否 | string(64) | 张三 | 可选项,在接收方类型为个人的时可选填,若有值,会检查与 name 是否实名匹配,不匹配会拒绝分账请求 1、分账接收方类型是PERSONAL_OPENID时,是个人姓名(选传,传则校验) |
字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|---|
返回状态码 | return_code | 是 | String(16) | SUCCESS | SUCCESS/FAIL |
返回信息 | return_msg | 否 | String(128) | 签名失败 | 返回信息,如非空,为错误原因。如 签名失败、参数格式校验错误 |
重庆互联网项目从2004年开始为各行各业提供互联网发展解决方案,专业从事网站、小程序、微信公众号、APP、电商平台、系统等互联网平台开发,帮助企业实现从传统行业到互联网的完美转型。截止目前,重庆互联网合作的企业遍布全国各地,19年的开发经验和完善的售后服务体系获得合作客户的高度认可!
关注重庆互联网官方公众号,即可获取粉丝专享福利!
欢迎广大用户为此页面进行评价,评价成功将获得积分奖励!