分账业务

业务介绍：商户分账主要用于商户将交易成功的资金，按照一定的周期，分账给其他方，可以是合作伙伴、员工、用户或者其他分润方。

参考微信文档：

微信分账：https://pay.weixin.qq.com/wiki/doc/api/allocation.php?chapter=26_1
支付宝分账： https://opendocs.alipay.com/open/20190308105425129272/intro

接口目录：

绑定分账用户

接口说明

适用对象：普通商户 特约商户

请求URL：https://pay.jeepay.vip/api/division/receiver/bind

请求方式：POST

请求类型：application/json 或 application/x-www-form-urlencoded

请求参数

请求示例数据

{
 'version': '1.0',
'reqTime': '1622016572190',
'signType': 'MD5',
'sign': 'MD5MD5MD5MD5MD5MD5MD5MD5MD5MD5MD5MD5',
'mchNo': 'M1623997000',
'appId': '60cc3ba74ee0e6685f57e000',
'ifCode': 'wxpay',
'receiverAlias': '我的第一个账号',
'receiverGroupId': '100001',
'accType': '0',
'accNo': 'sfsfsd@qq.com',
'accName': '张三',
'relationType': 'OTHERS',
'relationTypeName': '我的员工',
'divisionProfit': '0.3' 
}

返回参数

data数据格式

返回示例数据

{
    "code": 0,
    "data": {
        "accName": "张三",
        "accNo": "sfsfsd@qq.com",
        "accType": 0,
        "appId": "60cc3ba74ee0e6685f57eb1e",
        "bindState": 0,
        "divisionProfit": 0.3,
        "errCode": "NOAUTH",
        "errMsg": "无分账权限",
        "ifCode": "wxpay",
        "mchNo": "M1623997351",
        "receiverAlias": "我的第一个账号",
        "receiverGroupId": 100001,
        "relationType": "OTHERS",
        "relationTypeName": "我的员工"
    },
    "msg": "SUCCESS",
    "sign": "552CB91FA1E1DB378A534B377E4E9403"
}

易宝支付分账绑定示例：

A场景： 已经在易宝系统完成了进件操作， 那么直接传入【易宝子商户号】完成绑定接收方就可以了。

{
    "ifCode": "yeepay",
    "relationType": "PARTNER",
    "accNo": "10090488888",  // 易宝子商户号
    "accName": "张三",
    "sign": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "reqTime": "1721955211",
    "version": "1.0",
    "relationTypeName": "合作伙伴",
    "channelExtInfo": "{}",
    "appId": "668fa492e4b085a7accaa2b2",
    "signType": "MD5",
    "receiverAlias": "张三",
    "accType": 0,
    "divisionProfit": "0.05",
    "mchNo": "M1720689810"
}

B场景： 全新资料录入，并将分账接收方账号绑定到商户下。

{
    "ifCode": "yeepay",
    "relationType": "PARTNER",
    "accNo": "6228487890123456", // 该场景下，传银行卡号即可，当易宝开户成功后系统会自动替换为易宝商户号
    "accName": "张三",
    "sign": "xxxxxxxxxxxxxxxxxxxxxxxxxx",
    "reqTime": "1721956359",
    "version": "1.0",
    "relationTypeName": "合作伙伴",
    "channelExtInfo": "{\"isMchDivisionReceiver\":1,\"merchantType\":1,\"bankAccountType\":\"\",\"mchShortName\":\"张三_商户\",\"idcard1Img\":\"https://devplusmgr.jeepay.vip/api/anon/localOssFiles/applyment/f9b83f2e-ff38-419f-8e4e-d5ba628c99e3.jpg\",\"idcard2Img\":\"https://devplusmgr.jeepay.vip/api/anon/localOssFiles/applyment/4fd25633-1a52-4de0-bf98-e7f9a0346415.jpg\",\"idcardName\":\"张三\",\"idcardNo\":\"130100199012111111\",\"legalPhone\":\"13800138000\",\"areaCode\":[\"110000\",\"110100\",\"110101\"],\"address\":\"北京市西城区xxx号\",\"bankCode\":\"ICBC\",\"settAccountNo\":\"6228487890123456\",\"mchFullName\":\"张三_商户\"}",
    "appId": "668fa492e4b085a7accaa2b2",
    "signType": "MD5",
    "receiverAlias": "张三",
    "accType": 0,
    "divisionProfit": "0.1",
    "mchNo": "M1720689810"
}

channelExtInfo: 说明：

【小微开户】

{
    "isMchDivisionReceiver": 1,     // 是否分账接收方   固定传1
    "merchantType": 1,   // 商户类型  1-个人（小微）, 2-个体工商户, 3-企业
    "bankAccountType": "", // 账户类型  ENTERPRISE_ACCOUNT(对公账户)--个体和企业可选     DEBIT_CARD(借记卡)--个体和小微可选（小微已经默认上送了借记卡，接口可不用再上送）
    "mchShortName": "张三_商户",  // 商户简称
    "idcard1Img": "https://devplusmgr.jeepay.vip/api/anon/localOssFiles/applyment/f9b83f2e-ff38-419f-8e4e-d5ba628c99e3.jpg",  //  法人证件人像面照片 需外网可访问地址
    "idcard2Img": "https://devplusmgr.jeepay.vip/api/anon/localOssFiles/applyment/4fd25633-1a52-4de0-bf98-e7f9a0346415.jpg",  // 法人证件非人像面照片  需外网可访问地址
    "idcardName": "张三",  // 法人姓名
    "idcardNo": "130100199012111111",  // 法人身份证号
    "legalPhone": "13800138000", // 法人手机号
    "areaCode": ["110000", "110100", "110101"],   // 经营地址，三个值顺序固定 省编码，市编码，区编码（直筒子市传对应的乡镇编码，在文档上也在区编码那一列查找就好）
    "address": "北京市西城区xxx号",  // 经营地址 不需要再次上送省市区
    "bankCode": "ICBC",  // 开户总行编码（https://yeepay.feishu.cn/sheets/MmMfsrTbnhn744tjYdEcvoNmn83）
    "settAccountNo": "6228487890123456", // 银行账户号码
    "mchFullName": "张三", // 商户签约名称 与商户证件主体名称一致（个体、企业填写营业执照名称，小微不用再上送（默认固定为了法人名称））
    "mchSettleCycle": "D1_MANUAL", //  结算方式,非必填，默认D1   D1:自动结算, D1_MANUAL:手动结算
}

【企业开户】

{
    "isMchDivisionReceiver": 1,     // 是否分账接收方   固定传1
    "mchSettleCycle": "D1_MANUAL", //  结算方式,非必填，默认D1   D1:自动结算, D1_MANUAL:手动结算
    "contactName": "联系人姓名",
    "contactIdcardNo": "联系人身份证号",
    "contactPhone": "13800138001",  // 联系人手机号
    "servicePhone": "13800138003",   // 客服电话  
    "merchantType": 3,  // 3-企业
    "bankAccountType": "ENTERPRISE_ACCOUNT", // 账户类型  ENTERPRISE_ACCOUNT(对公账户)
    "licenseImg": "http://127.0.0.1:9217/20240929/3b48414f-b5a7-4d59-b374-ecfc0a96f9cc.jpg",  // 营业执照照片  需外网可访问地址
    "mchFullName": "营业执照名称",
    "mchShortName": "商户简称",
    "licenseNo": "营业执照号",
    "idcard1Img": "http://127.0.0.1:9217/20240929/cb0e2f9c-a9bf-4ec0-8013-4e1708ce0ae7.jpg",   //  法人证件人像面照片 需外网可访问地址
    "idcard2Img": "http://127.0.0.1:9217/20240929/7c85ce17-ade2-47d0-a803-40755d01a385.jpg",  // 法人证件非人像面照片  需外网可访问地址
    "idcardName": "法人姓名",
    "idcardNo": "法人身份证号",
    "legalPhone": "13800138000", // 法人手机号
    "mccCode": "",   // 非必填。 特殊场景填入， 参考文档  示例： 120_120006 ( 一级_二级)
    "areaCode": ["110000", "110100", "110101"],   // 经营地址，三个值顺序固定 省编码，市编码，区编码（直筒子市传对应的乡镇编码，在文档上也在区编码那一列查找就好）
    "address": "北京市西城区xxx号",  // 经营地址 不需要再次上送省市区
    "contactEmail": "法人邮箱@qq.com",  // 法人邮箱
    "bankCode": "CCB",  // 开户总行编码（https://yeepay.feishu.cn/sheets/MmMfsrTbnhn744tjYdEcvoNmn83）
    "settAccountNo": "62结算账号8888888", // 银行账户号码
    "companyAccountLicenseImg": "http://127.0.0.1:9217/ap9/416c4ad6-8046-4c93-bcc2-c98b15a9ffdc.jpg"  // 开户许可证照片  需外网可访问地址
}

易宝银行编码查询： https://yeepay.feishu.cn/sheets/MmMfsrTbnhn744tjYdEcvoNmn83
易宝省市编码查询：https://yeepay.feishu.cn/file/HMtPbm3XPofOWbxMu1mcrZtInch
易宝支付MCC行业经营类目: 文章末尾附件下载

发起订单分账

当订单下单时传入的分账模式 divisionMode = 2商户手动分账(解冻商户金额)，支持商户手动发起订单分账。
注意：需要在订单支付完成后（建议1分钟后）调用分账接口。

接口说明

适用对象：普通商户 特约商户

请求URL：https://pay.jeepay.vip/api/division/exec

请求方式：POST

请求类型：application/json 或 application/x-www-form-urlencoded

请求参数

请求示例数据

{
 'version': '1.0',
'reqTime': '1622016572190',
'signType': 'MD5',
'sign': '1',
'mchNo': 'M1623997351',
'appId': '60cc3ba74ee0e6685f57eb1e',
'payOrderId': 'P202108271011463510002',
'useSysAutoDivisionReceivers': '0',
'receivers': '[{"receiverGroupId":"","receiverId":"800029","divisionProfit":"0.0001"},{"receiverGroupId":"","receiverId":"800028","divisionProfit":"0.0002"}]' 
}

data数据格式

返回示例数据

{
    "code": 0,
    "data": {
        "errCode": "unknown-sub-code",
        "errMsg": "Business Failed【未知的错误码ACQ.ROYALTY_ACCOUNT_NOT_EXIST】",
        "state": 2
    },
    "msg": "SUCCESS",
    "sign": "56836E18015DD7E4FAFE45380C0AD098"
}

订单分账查询

订单分账结果的查询。

接口说明

适用对象：普通商户 特约商户

请求URL：https://pay.jeepay.vip/api/division/query

请求方式：POST

请求类型：application/json 或 application/x-www-form-urlencoded

请求参数

请求示例数据

{
 'version': '1.0',
'reqTime': '1622016572190',
'signType': 'MD5',
'sign': '1',
'mchNo': 'M1623997351',
'appId': '60cc3ba74ee0e6685f57eb1e',
'payOrderId': 'P202108271011463510002',
'batchOrderId': 'D99832829483234'
}

data数据格式

records数据格式

返回示例数据

{
"code":0,
"data":{
"batchOrderId":"D1792435159956271105",
"records":"[{\"accName\":\"A\",\"accNo\":\"A\",\"accType\":0,\"batchOrderId\":\"D1792435159956271105\",\"calDivisionAmount\":1980,\"divisionProfit\":0.200000,\"receiverAlias\":\"A\",\"receiverGroupId\":100001,\"receiverId\":800001,\"recordId\":1007,\"state\":1},{\"accName\":\"B\",\"accNo\":\"B\",\"accType\":0,\"batchOrderId\":\"D1792435159956271105\",\"calDivisionAmount\":990,\"divisionProfit\":0.100000,\"receiverAlias\":\"B\",\"receiverGroupId\":100001,\"receiverId\":800002,\"recordId\":1008,\"state\":1}]"
},
"msg":"SUCCESS",
"sign":"ABA5F4300D536E10CCB1FC677847773D"
}

订单分账完结

1、调用此接口，可将订单剩余金额解冻给商户。
2、订单分账完结后，不可再次发起分账。
3、返回完结处理中状态时，可调用支付订单查询接口查询最终分账完结状态。

接口说明

适用对象：普通商户 特约商户

请求URL：https://pay.jeepay.vip/api/division/finish

请求方式：POST

请求类型：application/json 或 application/x-www-form-urlencoded

请求参数

请求示例数据

{
 'version': '1.0',
'reqTime': '1622016572190',
'signType': 'MD5',
'sign': '1',
'mchNo': 'M1623997351',
'appId': '60cc3ba74ee0e6685f57eb1e',
'payOrderId': 'P202108271011463510002'
}

data数据格式

返回示例数据

{
    "code":0,
    "data":{
        "batchOrderId":"D1792435159956271105",
        "state":"1",
    },
    "msg":"SUCCESS",
    "sign":"ABA5F4300D536E10CCB1FC677847773D"
}

查询分账用户的可用余额

调用该接口实时查询渠道侧的分账用户的可用余额。

接口说明

适用对象：普通商户 特约商户

请求URL：https://pay.jeepay.vip/api/division/receiver/channelBalanceQuery

请求方式：POST

请求类型：application/json 或 application/x-www-form-urlencoded

请求参数

请求示例数据

{
 'version': '1.0',
'reqTime': '1622016572190',
'signType': 'MD5',
'sign': '1',
'receiverId': '800021',
'appId': '60cc3ba74ee0e6685f57eb1e'
}

data数据格式

返回示例数据

{
    "code": 0,
    "data": {
        "balanceAmount": 0,
        "receiverId": 800021
    },
    "msg": "SUCCESS",
    "sign": "5F16138F18AC367165B60CD97BA8CA27"
}

对分账用户的渠道余额发起提现

调用该接口实时调起三方的提现接口， 将实时到结算银行卡。 建议调用前先调用余额查询接口。

接口说明

适用对象：普通商户 特约商户

请求URL：https://pay.jeepay.vip/api/division/receiver/channelBalanceCashout

请求方式：POST

请求类型：application/json 或 application/x-www-form-urlencoded

请求参数

请求示例数据

{
 'version': '1.0',
'reqTime': '1622016572190',
'signType': 'MD5',
'sign': '1',
'receiverId': 800021,
'cashoutAmount': 10,
'appId': '60cc3ba74ee0e6685f57eb1e'
}

data数据格式

返回示例数据

{
    "code": 0,
    "data": {
        "receiverId": 801
        "state": 1,
    },
    "msg": "SUCCESS",
    "sign": "5F16138F18AC367165B60CD97BA8CA27"
}

余额提现记录查询 (未正式发布)

接口说明

适用对象：普通商户 特约商户

请求URL：https://pay.jeepay.vip/api/division/receiver/cashoutRecordQuery

请求方式：POST

请求类型：application/json 或 application/x-www-form-urlencoded

请求参数

请求示例数据

{
 'version': '1.0',
'reqTime': '1622016572190',
'signType': 'MD5',
'sign': '1',
'receiverId': 800021,
'appId': '60cc3ba74ee0e6685f57eb1e',
'mchNo': 'M1000001',
'pageSize': 1, 
'pageNumber': 1
}

返回示例数据

{
    "code": 0,
    "data": {
        "current": 1,
        "hasNext": false,
        "receiverId": 800005,
        "records": [
            {
                "ifCode": "yeepay",
                "mchOrderNo": "e06d47135be94b57a093daa7c6c9e88a",
                "errMsg": "无可结算的结算明细。",
                "rid": "C1856945042336866306",
                "isvNo": "V1682566503",
                "createdAt": "2024-11-14 14:19:33",
                "appId": "66b31b433d7ad4ada9ac7f83",
                "state": 3,
                "mchNo": "M1723013954",
                "updatedAt": "2024-11-14 14:19:34",
                "cashoutAmount": 155,
                "mchName": "易宝",
                "errCode": "400032",
                "channelSubMchId": "10090474424"
            }
        ],
        "total": 2
    },
    "msg": "SUCCESS",
    "sign": "C75572E6D2AFE2ED35FA827049A29C1E"
}