分账接口
业务介绍：商户分账主要用于商户将交易成功的资金，按照一定的周期，分账给其他方，可以是合作伙伴、员工、用户或者其他分润方。
参考微信文档：
微信分账：https://pay.weixin.qq.com/wiki/doc/api/allocation.php?chapter=26_1
支付宝分账： https://opendocs.alipay.com/open/20190308105425129272/intro
接口目录：
绑定分账用户
接口说明：调用该接口可实现通道分账用户的开通和绑定。
适用对象：普通商户 特约商户
请求URL：https://pay.yintongzaixian.com/api/division/receiver/bind
请求方式：POST
请求类型：application/json 或 application/x-www-form-urlencoded
请求参数
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 商户号 | mchNo | 是 | String(64) | M1621873433953 | 商户号 |
| 应用ID | appId | 是 | String(64) | 60cc09bce4b0f1c0b83761c9 | 应用ID |
| 接口代码 | ifCode | 是 | String(20) | wxpay | wxpay-微信官方接口 ; alipay-支付宝官方接口 |
| 接收者账号别名 | receiverAlias | 是 | String(64) | 张三 | 接收者账号别名 |
| 组ID | receiverGroupId | 是 | long | 10001 | 需先登录商户系统查找待加入的组ID |
| 分账接收账号类型 | accType | 是 | int | 1 | 分账接收账号类型: 0-个人(对私) 1-商户(对公) |
| 分账接收账号 | accNo | 是 | String(512) | 10092311042 | 分账接收账号, 指三方支付侧的账号。如：易宝支付的分账接收账号:10092311042；嘉联支付场景A：渠道侧账户号；嘉联支付场景B：用户结算卡号；微信个人是openid, 企业是商户号；支付宝可以是userId或登录名 |
| 分账接收账号名称 | accName | 否 | String(30) | 张三 | 微信选填（当填入则验证），支付宝账号必填；其他三方支付账号填正确名字即可 |
| 分账关系类型 | relationType | 是 | String(30) | wxpay | 分账关系类型：SERVICE_PROVIDER：服务商 STORE：门店 STAFF：员工 STORE_OWNER：店主 PARTNER：合作伙伴 HEADQUARTER：总部BRAND：品牌方 DISTRIBUTOR：分销商 USER：用户 SUPPLIER：供应商 CUSTOM：自定义 |
| 分账关系类型名称 | relationTypeName | 否 | String(30) | wxpay | 当relationType=CUSTOM 必填 |
| 渠道特殊信息 | channelExtInfo | 否 | String(256) | {} | 渠道特殊信息，如果没有账号；则需录入全新资料开户，具体参数见下面说明 |
| 默认分账比例 | divisionProfit | 是 | String(10) | 0.3 | 若分账30% 则填入 0.3。只是默认比例，实际分账时可指定其他比例值。 |
| 请求时间 | reqTime | 是 | long | 1622016572190 | 请求接口时间,13位时间戳 |
| 接口版本 | version | 是 | String(3) | 1.0 | 接口版本号，固定：1.0 |
| 签名 | sign | 是 | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 签名值，详见签名算法 |
| 签名类型 | signType | 是 | String(32) | MD5 | 签名类型，目前只支持MD5或RSA2方式 |
请求示例数据JSON
{
"ifCode": "yeepay",
"relationType": "CUSTOM",
"accNo": "125305314010",
"accName": "广安文化旅发展有限公司",
"sign": "CAC80F3B53FA3EFD6755BDE69B63BB8C",
"reqTime": "1766474603",
"version": "1.0",
"relationTypeName": "商家",
"channelExtInfo": "{\"bankCode\":\"BOC\",\"legalPhone\":\"18090281196\",\"licenseNo\":\"91511600MA11822K3R\",\"address\":\"四川省广安市广安区协兴镇坊路99号13幢\",\"servicePhone\":\"18090281196\",\"contactEmail\":\"1563374611@qq.com\",\"contactName\":\"吴忆\",\"idcardNo\":\"51362219820205110X\",\"idcardName\":\"吴*忆\",\"mchShortName\":\"广安文化旅发展有限公司\",\"mchFullName\":\"广安文化旅发展有限公司\",\"contactIdcardNo\":\"51362219812205530X\",\"licenseImg\":\"https://oss-print.oss-cn-hangzhou.aliyuncs.com/document/20251223/eaa25755ca6e4939bab3c4b94bd368c7.jpg\",\"settlementDirection\":\"BANKCARD\",\"idcard1Img\":\"https://oss-print.oss-cn-hangzhou.aliyuncs.com/document/20251223/471e568d92a849099a39fb6ce6c7d911.jpg\",\"idcard2Img\":\"https://oss-print.oss-cn-hangzhou.aliyuncs.com/document/20251223/4eaaa738eae84721944250339d46c111.jpg\",\"areaCode\":[\"510000\",\"511600\",\"511602\"],\"bankAccountType\":\"ENTERPRISE_ACCOUNT\",\"settAccountNo\":\"125305324210\",\"mchSettleCycle\":\"D1\",\"contactPhone\":\"18090282116\",\"merchantType\":3}",
"appId": "686b44f7e4b04a64de38d13c",
"signType": "MD5",
"receiverAlias": "广安文化旅发展有限公司",
"accType": 1,
"divisionProfit": "0.9",
"mchNo": "M1751860471"
}返回参数
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 返回状态 | code | 是 | int | 0 | 0-处理成功，其他-处理有误，详见错误码 |
| 返回信息 | msg | 否 | String(128) | 签名失败 | 具体错误原因，例如：签名失败、参数格式校验错误 |
| 签名信息 | sign | 否 | String(32) | CCD9083A6DAD9A2DA9F668C3D4517A84 | 对data内数据签名,如data为空则不返回 |
| 返回数据 | data | 否 | String(512) | {} | 返回下单数据,json格式数据 |
data数据格式
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 分账接收者ID | receiverId | 是 | long | 10001 | 绑定的分账接收者ID, 订单分账时使用 |
| 接收者账号别名 | receiverAlias | 是 | String(64) | 张三 | 接收者账号别名 |
| 商户分账用户ID | mchReceiverId | 否 | String(64) | M00000001 | 商户分账用户ID |
| 分账接收账号类型 | accType | 是 | int | 1 | 分账接收账号类型: 0-个人 1-企业 |
| 分账接收账号 | accNo | 是 | String(10) | 10092311042 | 分账接收账号 |
| 分账接收账号名称 | accName | 否 | tring(30) | 张三 | 分账接收账号名称 |
| 分账关系类型 | relationType | 是 | String(30) | SERVICE_PROVIDER | 分账关系类型 |
| 渠道特殊信息 | channelExtInfo | 否 | String(256) | {} | 渠道特殊信息 |
| 默认分账比例 | divisionProfit | 是 | String(10) | 0.3 | 默认分账比例 |
| 绑定成功时间 | bindSuccessTime | 否 | Long | 1622016572190 | 绑定成功时间 |
| 绑定状态 | bindState | 是 | int | 1 | 绑定状态 1-绑定成功, 0-绑定异常 2-绑定中；如果绑定中则需调用查询接口，看是否需要签约，确认最终状态 |
| 渠道错误码 | errCode | 否 | String | ACQ.PAYMENT_AUTH_CODE_INVALID | 上游渠道返回的错误码 |
| 渠道错误描述 | errMsg | 否 | String | Business Failed 失败 | 上游渠道返回的错误描述 |
返回示例数据‘json
{
"accName": "广安文化旅发展有限公司",
"accNo": "125305314010",
"accType": 1,
"appId": "686b44f7e4b04a64de38d13c",
"bindState": 1,
"bindSuccessTime": 1766474641000,
"channelExtInfo": "{\"bankCode\":\"BOC\",\"legalPhone\":\"18090281196\",\"licenseNo\":\"91511600MA11822K3R\",\"address\":\"四川省广安市广安区协兴镇坊路99号13幢\",\"servicePhone\":\"18090281196\",\"contactEmail\":\"1563374611@qq.com\",\"contactName\":\"吴忆\",\"idcardNo\":\"51362219820205110X\",\"idcardName\":\"吴*忆\",\"mchShortName\":\"广安文化旅发展有限公司\",\"mchFullName\":\"广安文化旅发展有限公司\",\"contactIdcardNo\":\"51362219812205530X\",\"licenseImg\":\"https://oss-print.oss-cn-hangzhou.aliyuncs.com/document/20251223/eaa25755ca6e4939bab3c4b94bd368c7.jpg\",\"settlementDirection\":\"BANKCARD\",\"idcard1Img\":\"https://oss-print.oss-cn-hangzhou.aliyuncs.com/document/20251223/471e568d92a849099a39fb6ce6c7d911.jpg\",\"idcard2Img\":\"https://oss-print.oss-cn-hangzhou.aliyuncs.com/document/20251223/4eaaa738eae84721944250339d46c111.jpg\",\"areaCode\":[\"510000\",\"511600\",\"511602\"],\"bankAccountType\":\"ENTERPRISE_ACCOUNT\",\"settAccountNo\":\"125305324210\",\"mchSettleCycle\":\"D1\",\"contactPhone\":\"18090282116\",\"merchantType\":3}",
"divisionProfit": 0.9,
"ifCode": "yeepay",
"mchNo": "M1751860471",
"receiverAlias": "广安文化旅发展有限公司",
"receiverId": 808585,
"relationType": "CUSTOM",
"relationTypeName": "商家",
"key": "q4GX8XQRhzIi2ZXILEVCdL7RQUG2SuIF3inBCcrfaNeleLzYQYw6ztpnsUqFWyEB"
}易宝支付分账绑定示例
易宝支付ifCode固定值：yeepay (具体值请与技术对接联系)
易宝支持订单分账和余额分账双模式，两种模式在添加接收对象方面有差异，使用订单分账要添加订单分账接收方，使用余额分账需添加余额分账入账方。
1. 订单分账
订单_A场景：已经在易宝系统完成了进件操作， 那么直接传入【易宝子商户号】完成绑定接收方就可以了。 （易宝订单分账子商户号格式：11位长度，100开头的纯数字）
{
"ifCode": "yeepay",
"relationType": "PARTNER",
"accNo": "10090488888", // 易宝子商户号
"accName": "张三",
"sign": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"reqTime": "1721955211",
"version": "1.0",
"relationTypeName": "合作伙伴",
"channelExtInfo": "{\"channelAccnoScene\":\"ORDER\"}", // channelAccnoScene非必传，不传或上送ORDER时都按订单分账处理
"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": "{\"channelAccnoScene\":\"ORDER\",\"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说明：
订单分账【小微开户】
{
"channelAccnoScene": "ORDER", // channelAccnoScene非必传，不传或上送ORDER时都按订单分账处理
"merchantType": 1, // 商户类型 1-个人（小微）, 2-个体工商户, 3-企业, 4-事业单位
"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", // 结算方式,非必填，默认D1 D1:自动结算, D1_MANUAL:手动结算
}订单分账【企业开户】
{
"channelAccnoScene": "ORDER", // channelAccnoScene非必传，不传或上送ORDER时都按订单分账处理
"mchSettleCycle": "D1", // 结算方式,非必填，默认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" // 开户许可证照片 需外网可访问地址
}2. 余额分账
余额_A场景： 已经在易宝系统完成了添加入账方的操作， 那么传入【易宝子商户号】并且在channelExtInfo参数中声明使用场景channelAccnoScene为余额分账，完成绑定接收方就可以了。（易宝余额分账子商户号格式：19位长度，R开头，第2位开始纯数字）
{
"ifCode": "yeepay",
"relationType": "PARTNER",
"accNo": "10090488888", // 易宝子商户号
"accName": "张三",
"sign": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"reqTime": "1721955211",
"version": "1.0",
"relationTypeName": "合作伙伴",
"channelExtInfo": "{\"channelAccnoScene\":\"BALANCE\"}", // channelAccnoScene固定上送BALANCE
"appId": "668fa492e4b085a7accaa2b2",
"signType": "MD5",
"receiverAlias": "张三",
"accType": 0,
"divisionProfit": "0.05",
"mchNo": "M1720689810"
}余额_B场景： 全新资料录入，并将余额分账入账方账号绑定到商户下。
流程：
1、调用《绑定分账用户》接口(当前页面)，传入余额入账方资料信息，创建分账接收人账号。
2、调用《分账用户绑定查询 》接口，响应参数“authInfo”返回签约链接，需入账方和商户分别打开链接进行签约。
3、等双方均签约完成后，继续调用《分账用户绑定查询 》接口，当返回的接收方绑定状态为绑定成功时，说明绑定完成。
{
"ifCode": "yeepay",
"relationType": "PARTNER",
"accNo": "6228487890123456", // 该场景下，传银行卡号即可，当易宝开户成功后系统会自动替换为易宝商户号
"accName": "张三",
"sign": "xxxxxxxxxxxxxxxxxxxxxxxxxx",
"reqTime": "1721956359",
"version": "1.0",
"relationTypeName": "合作伙伴",
"channelExtInfo": "{\"channelAccnoScene\":\"BALANCE\",\"balanceReceiverType\":\"TO_PUBLIC_MANAGER\",\"idcardName\":\"法人姓名\",\"idcardNo\":\"法人身份证号\",\"contactPhone\":\"13800138000\",\"bankCode\":\"CCB\",\"settAccountNo\":\"62结算账号8888888\"}",
"appId": "668fa492e4b085a7accaa2b2",
"signType": "MD5",
"receiverAlias": "张三",
"accType": 0,
"divisionProfit": "0.1",
"mchNo": "M1720689810"
}易宝余额分账channelExtInfo说明：
余额分账【入账方对象为个人】
{
"channelAccnoScene": "BALANCE", // BALANCE 表示余额分账
"balanceReceiverType": "TO_PRIVATE_MANAGER", // 入账方类型 TO_PRIVATE_MANAGER:对私 （入账方类型优先取此值的上送，如果未传值且添加的入账方为个人时，入账方类型默认为对私）
"idcardName": "法人姓名",
"idcardNo": "法人身份证号",
"contactPhone": "13800138000", // 联系人手机号
"bankCode": "CCB", // 开户总行编码（https://yeepay.feishu.cn/sheets/MmMfsrTbnhn744tjYdEcvoNmn83）
"settAccountNo": "62结算账号8888888" // 银行账户号码
}余额分账【入账方对象为企业或个体】
{
"channelAccnoScene": "BALANCE", // BALANCE 表示余额分账
"balanceReceiverType": "TO_PUBLIC_MANAGER", // 入账方类型 TO_PUBLIC_MANAGER:对公（入账方类型优先取此值的上送，如果未传值且添加的入账方为企业或个体时，入账方类型默认为对公）
"mchFullName": "营业执照名称",
"licenseNo": "营业执照号",
"idcardName": "法人姓名",
"idcardNo": "法人身份证号",
"contactPhone": "13800138000", // 联系人手机号
"bankCode": "CCB", // 开户总行编码（https://yeepay.feishu.cn/sheets/MmMfsrTbnhn744tjYdEcvoNmn83）
"settAccountNo": "62结算账号8888888" // 银行账户号码
}易宝银行编码查询： https://yeepay.feishu.cn/sheets/MmMfsrTbnhn744tjYdEcvoNmn83
易宝省市编码查询：https://yeepay.feishu.cn/file/HMtPbm3XPofOWbxMu1mcrZtInch
易宝支付MCC行业经营类目: 文章末尾附件下载
嘉联支付分账绑定示例
嘉联支付ifCode固定值：jlpay (具体值请与技术对接联系)
A场景： 已经在嘉联系统完成了进件操作， 那么直接传入【嘉联子商户号】完成绑定接收方就可以了。
channelExtInfo说明：
分账协议(非必填)：divisionAgreePic，分账协议说明：出账方与分账接收方之间的分账业务合作协议（无模版），例：连锁品牌，加盟客户，供应链上下游等场景客户，提供商户与合作方之间签署的业务合作协议，内容明确约定业务分账比例，附件图片形式最多20张，多张图片链接以英文 , 隔开
{
"ifCode": "jlpay",
"relationType": "PARTNER",
"accNo": "849145453888888", // 嘉联子商户号
"accName": "张三",
"sign": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"reqTime": "1721955211",
"version": "1.0",
"relationTypeName": "合作伙伴",
"channelExtInfo": "{\"divisionAgreePic\":\"http://127.0.0.1:9217/20250305/61e07621-2b06-43c0-93d2-f87060c26281.jpg,http://127.0.0.1:9217/20250305/61e07621-2b06-43c0-93d2-f87060c26282.jpg\"}",
"appId": "668fa492e4b085a7accaa2b2",
"signType": "MD5",
"receiverAlias": "张三",
"accType": 0,
"divisionProfit": "0.05",
"mchNo": "M1720689810"
}B场景： 全新资料录入，并将分账接收方账号绑定到商户下。
流程：
1、调用《绑定分账用户》接口，传入接收方资料信息，创建分账接收方账号。
2、调用《分账用户绑定查询》接口，响应参数“authInfo”返回签约链接，访问链接进行签约。
3、继续调用《分账用户绑定查询》接口，当返回的接收方绑定状态为绑定成功时，说明绑定完成。
{
"ifCode": "jlpay",
"relationType": "PARTNER",
"pas": "jeepayVFhsnD0AK",
"accNo": "123123",
"accName": "张三",
"sign": "F5790462818333495BAE2187CBD37894",
"reqTime": "1741249880",
"version": "1.0",
"relationTypeName": "合作伙伴",
"channelExtInfo": "{\"merchantType\":2,\"idcard1Img\":\"http://127.0.0.1:9217/applyment/20250306/03530539-f28d-4acf-b5b6-c6ed516c8661.jpg\",\"idcard2Img\":\"http://127.0.0.1:9217/applyment/20250306/0b375f9e-090f-481b-ba53-76729149101e.jpg\",\"idcardEffectBegin\":\"2019-02-19\",\"idcardEffectEnd\":\"2029-02-19\",\"idcardName\":\"张三\",\"idcardNo\":\"36232419981XXXXXXX\",\"idcardAddress\":\"江西省XXXXXX\",\"legalPersonPhone\":\"132125XXXXX\",\"settAccountName\":\"张三\",\"settAccountNo\":\"123123\",\"divisionAgreePic\":\"http://127.0.0.1:9217/applyment/20250306/81edaf2e-2d93-4401-aa8c-4e21b51f2759.png\"}",
"appId": "667d06f00d1436b4ad7669e1",
"signType": "MD5",
"receiverAlias": "张三",
"accType": 0,
"divisionProfit": "0.1",
"mchNo": "M1719469808"
}channelExtInfo: 说明：
【小微开户】
{
"merchantType": 2, // 开户类型：固定值：2，代表：小微
"idcard1Img": "http://127.0.0.1:9217/applyment/20250306/03530539-f28d-4acf-b5b6-c6ed516c8661.jpg", // 法人证件人像面照片 需外网可访问地址
"idcard2Img": "http://127.0.0.1:9217/applyment/20250306/0b375f9e-090f-481b-ba53-76729149101e.jpg", // 法人证件非人像面照片 需外网可访问地址
"idcardEffectBegin": "2019-02-19", // 证件有效期开始日期，格式为：yyyy-MM-dd
"idcardEffectEnd": "2029-02-19", // 证件有效期结束日期，非长期格式为：yyyy-MM-dd，长期：长期
"idcardName": "张三", // 法人姓名
"idcardNo": "36232419981XXXXXXX", // 法人身份证号
"idcardAddress": "江西省XXXXXX", // 法人身份证地址
"legalPersonPhone": "132125XXXXX", // 法人手机号
"settAccountLicenseImg": "银行卡照片", // 结算银行卡正面照片
"settAccountName": "张三", // 结算账户名称
"settAccountNo": "123123", // 结算账户
"divisionAgreePic": "http://127.0.0.1:9217/applyment/20250306/81edaf2e-2d93-4401-aa8c-4e21b51f2759.png" // 分账协议照片
}【企业开户】
{
"merchantType": 1, // 开户类型：固定值：1，代表：企业
"idcard1Img": "http://127.0.0.1:9217/applyment/20250306/03530539-f28d-4acf-b5b6-c6ed516c8661.jpg", // 法人证件人像面照片 需外网可访问地址
"idcard2Img": "http://127.0.0.1:9217/applyment/20250306/0b375f9e-090f-481b-ba53-76729149101e.jpg", // 法人证件非人像面照片 需外网可访问地址
"idcardEffectBegin": "2019-02-19", // 证件有效期开始日期，格式为：yyyy-MM-dd
"idcardEffectEnd": "2029-02-19", // 证件有效期结束日期，格式为：yyyy-MM-dd
"idcardName": "张三", // 法人姓名
"idcardNo": "36232419981XXXXXXXX", // 法人身份证号
"idcardAddress": "江西省XXXXXX", // 法人身份证地址
"legalPersonPhone": "132125XXXXX", // 法人手机号
"settAccountLicenseImg": "银行卡照片", // 结算银行卡正面照片
"settAccountName": "张三", // 结算账户名称
"settAccountNo": "123123", // 结算账户
"bankBranchId": "123", // 结算卡联行号
"divisionAgreePic": "http://127.0.0.1:9217/applyment/20250306/81edaf2e-2d93-4401-aa8c-4e21b51f2759.png", // 分账协议照片
"licenseImg": "http://127.0.0.1:9217/applyment/20250306/2375f1cb-b81e-45c0-9972-10efd0b28e1d.jpg", // 营业执照照片 需外网可访问地址
"licenseNo": "91440400XXXXX", // 营业执照号
"mchFullName": "企业名称", // 营业执照名称
"licenseAddress": "营业执照地址", // 营业执照注册地址
"licenseEffectBegin": "2021-02-03", // 营业执照有效期开始日期，格式为：yyyy-MM-dd
"licenseEffectEnd": "长期" // // 营业执照有效期结束日期，非长期格式为：yyyy-MM-dd，长期：长期
}SDK调用示例（Java）：
JeepayClient jeepayClient = JeepayClient.getInstance(Jeepay.appId, Jeepay.apiKey, Jeepay.getApiBase());
DivisionReceiverBindRequest request = new DivisionReceiverBindRequest();
DivisionReceiverBindReqModel model = new DivisionReceiverBindReqModel();
model.setMchNo(Jeepay.mchNo); // 商户号
model.setAppId(jeepayClient.getAppId()); // 应用ID
request.setBizModel(model);
try {
DivisionReceiverBindResponse response = jeepayClient.execute(request);
_log.info("验签结果：{}", response.checkSign(Jeepay.apiKey));
if (response.isSuccess(Jeepay.apiKey)) {
_log.info("data：{}", response.getData());
} else {
_log.info("请求失败：mchNo={}, msg={}", Jeepay.mchNo, response.getMsg());
}
} catch (JeepayException e) {
_log.error(e.getMessage());
}发起订单分账
当订单下单时传入的分账模式 divisionMode = 2商户手动分账(解冻商户金额)，支持商户手动发起订单分账。
注意：需要在订单支付完成后（建议1分钟后）调用分账接口。
接口说明
适用对象：普通商户 特约商户
请求URL：https://pay.yintongzaixian.com/api/division/exec
请求方式：POST
请求类型：application/json 或 application/x-www-form-urlencoded
请求参数
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 商户号 | mchNo | 是 | String(64) | M1621873433953 | 商户号 |
| 应用ID | appId | 是 | String(64) | 60cc09bce4b0f1c0b83761c9 | 应用ID |
| 支付订单号 | payOrderId | 否 | String(30) | P20160427210604000490 | 支付中心生成的支付订单号，与mchOrderNo二者传一即可 |
| 商户单号 | mchOrderNo | 否 | String(64) | 20160427210604000490 | 商户生成的支付单号，与payOrderId二者传一即可 |
| 是否使用系统配置的自动分账组 | useSysAutoDivisionReceivers | 是 | int | 1 | 是否使用系统配置的自动分账组： 0-否 1-是 |
| 分账接收者账号列表 | receivers | 否 | String(512) | [] | 接收者账号列表（JSONArray 转换为字符串类型）仅当useSysAutoDivisionReceivers=0 时该字段值有效。参考：方式1： 按账号维度[{receiverId: 800001,divisionProfit: 0.1, //(实际分账比例 如分账10%传入0.1， 若不填入则使用系统默认配置值)divisionAmount: 100, //(实际分账金额，单位：分，与分账比例二选一， 若比例和金额两个都填写，以分账金额为准。)}]方式2： 按组维度[{receiverGroupId: 100001, //(该组所有 当前订单的渠道账号并且可用状态的全部参与分账)divisionProfit: 0.1 (每个账号的分账比例， 若不填入则使用系统默认配置值， 建议不填写)}]注意： 分账的比例和金额不支持共传，若同时存在将会导致分账计算金额错误，接口调用时请先确定一种计算方式 |
| 请求时间 | reqTime | 是 | long | 1622016572190 | 请求接口时间,13位时间戳 |
| 接口版本 | version | 是 | String(3) | 1.0 | 接口版本号，固定：1.0 |
| 签名 | sign | 是 | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 签名值，详见签名算法 |
| 签名类型 | signType | 是 | String(32) | MD5 | 签名类型，目前只支持MD5或RSA2方式 |
请求示例数据JSON
{
'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"}]'
}| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 返回状态 | code | 是 | int | 0 | 0-处理成功，其他-处理有误，详见错误码 |
| 返回信息 | msg | 否 | String(128) | 签名失败 | 具体错误原因，例如：签名失败、参数格式校验错误 |
| 签名信息 | sign | 否 | String(32) | CCD9083A6DAD9A2DA9F668C3D4517A84 | 对data内数据签名,如data为空则不返回 |
| 签名信息 | data | 否 | String(512) | {} | 返回下单数据,json格式数据 |
data数据格式
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 分账状态 | state | 是 | int | 2 | 分账状态 1-分账成功, 2-分账失败, 3-分账处理中，4-分账已受理 |
| 上游分账批次号 | channelBatchOrderId | 否 | String(30) | T20160427210604000490 | 上游分账批次号 |
| 系统分账批次号 | batchOrderId | 否 | String(30) | D1792435159956271105 | 系统分账批次号 v3.7.0新增 |
| 渠道错误码 | errCode | 否 | String | 1002 | 渠道返回错误码 |
| 渠道错误描述 | errMsg | 否 | String | ERROR | 渠道返回错误描述 |
返回示例数据JSON
{
"code": 0,
"data": {
"errCode": "unknown-sub-code",
"errMsg": "Business Failed【未知的错误码ACQ.ROYALTY_ACCOUNT_NOT_EXIST】",
"state": 2
},
"msg": "SUCCESS",
"sign": "56836E18015DD7E4FAFE45380C0AD098"
}订单分账查询
订单分账结果的查询。
接口说明
适用对象：普通商户 特约商户
请求URL：https://pay.yintongzaixian.com/api/division/query
请求方式：POST
请求类型：application/json 或 application/x-www-form-urlencoded
请求参数
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 商户号 | mchNo | 是 | String(64) | M1621873433953 | 商户号 |
| 应用ID | appId | 是 | String(64) | 60cc09bce4b0f1c0b83761c9 | 应用ID |
| 支付订单号 | payOrderId | 否 | String(30) | P20160427210604000490 | 支付中心生成的支付订单号，与mchOrderNo二者传一即可 |
| 商户单号 | mchOrderNo | 否 | String(64) | 20160427210604000490 | 商户生成的支付单号，与payOrderId二者传一即可 |
| 系统分账批次号 | batchOrderId | 是 | String(30) | D1622016572190 | 分账接口返回的系统分账批次号 |
| 分账接收者ID | receiverId | 否 | long | 80000021 | 非必填，若传入则仅查询该ID的分账结果 |
| 请求时间 | reqTime | 是 | long | 1622016572190 | 请求接口时间,13位时间戳 |
| 接口版本 | version | 是 | String(3) | 1.0 | 接口版本号，固定：1.0 |
| 签名 | sign | 是 | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 签名值，详见签名算法 |
| 签名类型 | signType | 是 | String(32) | MD5 | 签名类型，目前只支持MD5或RSA2方式 |
请求示例数据JSON
{
'version': '1.0',
'reqTime': '1622016572190',
'signType': 'MD5',
'sign': '1',
'mchNo': 'M1623997351',
'appId': '60cc3ba74ee0e6685f57eb1e',
'payOrderId': 'P202108271011463510002',
'batchOrderId': 'D99832829483234'| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 返回状态 | code | 是 | int | 0 | 0-处理成功，其他-处理有误，详见错误码 |
| 返回信息 | msg | 否 | String(128) | 签名失败 | 具体错误原因，例如：签名失败、参数格式校验错误 |
| 签名信息 | sign | 否 | String(32) | CCD9083A6DAD9A2DA9F668C3D4517A84 | 对data内数据签名,如data为空则不返回 |
| 返回数据 | data | 否 | String(512) | {} | 返回下单数据,json格式数据 |
data数据格式
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 支付系统订单号 | payOrderId | 是 | Stirng | P92332433423442 | 支付系统订单号 |
| 系统分账批次号 | batchOrderId | 是 | String(30) | D20160427210604000490 | 系统分账批次号 |
| 上游分账批次号 | channelBatchOrderId | 否 | String(30) | TGES202106040 | 上游分账批次号,可能为空 |
| 详细信息 | records | 否 | String | JSON数组，String类型 | 详细信息 |
records数据格式
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 分账记录ID | recordId | 是 | Stirng | 1007 | 分账记录ID |
| 状态 | state | 否 | int | 1 | 状态: 0-待分账 1-分账成功, 2-分账失败, 3-分账处理中，4-分账已受理 |
| 分账接收者ID | receiverId | 否 | Long | 800001 | 分账接收者ID |
| 组ID | receiverGroupId | 否 | Long | 9801 | 组ID |
| 分账接收者别名 | receiverAlias | 否 | String | 张三 | 分账接收者别名 |
| 分账接收账号 | accNo | 否 | String | 628480039999330009 | 分账接收账号 |
| 分账接收账号名称 | accName | 否 | String | 张三 | 分账接收账号名称 |
| 分账接收账号类型 | accType | 否 | int | 1 | 0-个人 1-商户 |
| 系统分账批次号 | batchOrderId | 否 | String | D1000001 | 系统分账批次号 |
| 上游分账批次号 | channelBatchOrderId | 否 | String(30) | TGES202106040 | 上游分账批次号,可能为空 |
| 计算该接收方的分账金额 | calDivisionAmount | 否 | String | 1908 | 计算该接收方的分账金额,单位分 |
| 实际分账比例 | divisionProfit | 否 | Decimal | 0.200000 | 实际分账比例 |
返回示例数据JSON
{
"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"
}查询分账用户的可用余额
调用该接口实时查询渠道侧的分账用户的可用余额。
接口说明
适用对象：普通商户 特约商户
请求URL：https://pay.yintongzaixian.com/api/division/receiver/channelBalanceQuery
请求方式：POST
请求类型：application/json 或 application/x-www-form-urlencoded
请求参数
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 商户号 | mchNo | 是 | String(64) | M1621873433953 | 商户号 |
| 应用ID | appId | 是 | String(64) | 60cc09bce4b0f1c0b83761c9 | 应用ID |
| 分账用户ID | receiverId | 是 | Long | 800021 | 分账用户ID(创建成功后返回) |
| 请求时间 | reqTime | 是 | long | 1622016572190 | 请求接口时间,13位时间戳 |
| 接口版本 | version | 是 | String(3) | 1.0 | 接口版本号，固定：1.0 |
| 签名 | sign | 是 | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 签名值，详见签名算法 |
| 签名类型 | signType | 是 | String(32) | MD5 | 签名类型，目前只支持MD5或RSA2方式 |
请求示例数据JSON
{
'version': '1.0',
'reqTime': '1622016572190',
'signType': 'MD5',
'sign': '1',
'receiverId': '800021',
'appId': '60cc3ba74ee0e6685f57eb1e'
}| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 返回状态 | code | 是 | int | 0 | 0-处理成功，其他-处理有误，详见错误码 |
| 返回信息 | msg | 否 | String(128) | 签名失败 | 具体错误原因，例如：签名失败、参数格式校验错误 |
| 签名信息 | sign | 否 | String(32) | CCD9083A6DAD9A2DA9F668C3D4517A84 | 对data内数据签名,如data为空则不返回 |
| 返回数据 | data | 否 | String(512) | {} | 返回下单数据,json格式数据 |
data数据格式
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 分账用户ID | receiverId | 是 | int | 800021 | 分账用户ID |
| 余额 | balanceAmount | 是 | Long | 20 | 余额， 单位：分 |
返回示例数据JSON
{
"code": 0,
"data": {
"balanceAmount": 0,
"receiverId": 800021
},
"msg": "SUCCESS",
"sign": "5F16138F18AC367165B60CD97BA8CA27"
}对分账用户的渠道余额发起提现
调用该接口实时调起三方的提现接口， 将实时到结算银行卡。 建议调用前先调用余额查询接口。
接口说明
适用对象：普通商户 特约商户
请求URL：https://pay.yintongzaixian.com/division/receiver/channelBalanceCashout
请求方式：POST
请求类型：application/json 或 application/x-www-form-urlencoded
请求参数
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 商户号 | mchNo | 是 | String(64) | M1621873433953 | 商户号 |
| 应用ID | appId | 是 | String(64) | 60cc09bce4b0f1c0b83761c9 | 应用ID |
| 分账用户ID | receiverId | 是 | Long | 800021 | 分账用户ID(创建成功后返回) |
| 提现金额 | cashoutAmount | 是 | Long | 100 | 提现金额，单位分 |
| 请求时间 | reqTime | 是 | long | 1622016572190 | 请求接口时间,13位时间戳 |
| 接口版本 | version | 是 | String(3) | 1.0 | 接口版本号，固定：1.0 |
| 签名 | sign | 是 | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 签名值，详见签名算法 |
| 签名类型 | signType | 是 | String(32) | MD5 | 签名类型，目前只支持MD5或RSA2方式 |
请求示例数据JSON
{
'version': '1.0',
'reqTime': '1622016572190',
'signType': 'MD5',
'sign': '1',
'receiverId': 800021,
'cashoutAmount': 10,
'appId': '60cc3ba74ee0e6685f57eb1e'
}| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 返回状态 | code | 是 | int | 0 | 0-处理成功，其他-处理有误，详见错误码 |
| 返回信息 | msg | 否 | String(128) | 签名失败 | 具体错误原因，例如：签名失败、参数格式校验错误 |
| 签名信息 | sign | 否 | String(32) | CCD9083A6DAD9A2DA9F668C3D4517A84 | 对data内数据签名,如data为空则不返回 |
| 返回数据 | data | 否 | String(512) | {} | 返回下单数据,json格式数据 |
data数据格式
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 分账用户ID | receiverId | 是 | int | 800021 | 分账用户ID |
| 状态 | state | 是 | byte | 1 | 提现状态: 1-成功, 0-失败 |
| 渠道错误码 | errCode | 否 | String | 1002 | 渠道返回错误码 |
| 渠道错误描述 | errMsg | 否 | String | ERROR | 渠道返回错误描述 |
返回示例数据JSON
{
"code": 0,
"data": {
"receiverId": 801
"state": 1,
},
"msg": "SUCCESS",
"sign": "5F16138F18AC367165B60CD97BA8CA27"
}