接口说明

接口描述：调用该接口可实现通道分账用户的开通和绑定。

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

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

请求方式：POST

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

请求参数

请求示例数据

{
    "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"
}

返回参数

data数据格式

返回示例数据

{
  "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行业经营类目: 文章末尾附件下载