接口说明
适用描述:支持变更分账用户结算卡信息。
适用对象:普通商户 特约商户
请求URL:https://pay.jeepay.vip/api/division/receiver/settle/update
请求方式:POST
请求类型:application/json 或 application/x-www-form-urlencoded
请求参数
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 商户号 | mchNo | 是 | String(64) | M1708583228 | 商户号 |
| 应用ID | appId | 是 | String(64) | 66c6ff5a3d7a5d7a8999bd22 | 应用ID |
| 分账接收者ID | receiverId | 是 | long | 800019 | 分账接收者ID |
| 结算账号名称 | settAccountName | 是 | String(30) | 张三 | 结算账号名称,如:银行卡开户名称 |
| 结算账号 | settAccountNo | 是 | String(512) | 62823432136126 | 结算账号,如:银行卡号 |
| 银行名称 | settAccountBankName | 否 | String(512) | 中国工商银行 | 银行总行名称 |
| 开户支行联行号 | settAccountBankBranchCode | 条件必传 | String(64) | 102585486855 | 开户支行联行号,<企业>类型分账用户必传 |
| 开户支行名称 | settAccountBankBranchName | 否 | String(512) | 中国工商银行王府井支行 | 开户支行名称 |
| 渠道特殊信息 | channelExtInfo | 否 | String(64) | {} | 渠道特殊信息,json格式字符串 |
| 请求时间 | reqTime | 是 | long | 1622016572190 | 请求接口时间,13位时间戳 |
| 接口版本 | version | 是 | String(3) | 1.0 | 接口版本号,固定:1.0 |
| 签名 | sign | 是 | String(32) | 539CC4CF5D99475D313BE1065F9F1C08 | 签名值,详见签名算法 |
| 签名类型 | signType | 是 | String(32) | MD5 | 签名类型,目前只支持MD5或RSA2方式 |
请求示例数据
{
"settAccountBankBranchName": "中国工商银行王府井支行",
"settAccountName": "张三",
"receiverId": 800019,
"settAccountBankName": "中国工商银行",
"appId": "667d06f00d1436b4ad7669e1",
"settAccountBankBranchCode": "102585486855",
"settAccountNo": "62823432136126",
"mchNo": "M1719469808"
}渠道特殊——易宝订单分账接收方修改结算卡
{
"settAccountBankBranchName": "中国工商银行王府井支行",
"settAccountName": "张三",
"receiverId": 800019,
"settAccountBankName": "中国工商银行",
"appId": "667d06f00d1436b4ad7669e1",
"settAccountBankBranchCode": "102585486855",
"settAccountNo": "62823432136126",
"mchNo": "M1719469808",
"channelExtInfo": "{\"defaultSettleCard\":\"true\",\"bankAccountType\":\"DEBIT_CARD\",\"bankCode\":\"\",\"authorizationUrl\":\"\"}"
}渠道特殊——易宝订单分账接收方修改结算卡对应channelExtInfo说明
{
"defaultSettleCard": "true", // 同时结算到本次变更的账户,非必填,默认true
"bankAccountType":"DEBIT_CARD", // 银行卡账户类型,非必填,默认DEBIT_CARD 其他可选值:【ENTERPRISE_ACCOUNT:对公账户 DEBIT_CARD:个人借记卡 DEBIT_CARD_1:对私法人 DEBIT_CARD_2:对私非法人】
"bankCode": "", // 开户总行编码(开户总行编码和开户支行联行号[settAccountBankBranchCode]二选一必填)
"authorizationUrl": "" // 非同名结算授权文件地址,外网可访问,非必填
}渠道特殊——易宝余额分账入账方修改结算卡
{
"settAccountBankBranchName": "中国工商银行王府井支行",
"settAccountName": "张三",
"receiverId": 800019,
"settAccountBankName": "中国工商银行",
"appId": "667d06f00d1436b4ad7669e1",
"settAccountBankBranchCode": "102585486855",
"settAccountNo": "62823432136126",
"mchNo": "M1719469808",
"channelExtInfo": "{\"bankCode\":\"CCB\"}"
}渠道特殊——易宝余额分账入账方修改结算卡对应channelExtInfo说明
{
"bankCode": "CCB" // 开户总行编码,必填([https://yeepay.feishu.cn/sheets/MmMfsrTbnhn744tjYdEcvoNmn83](https://yeepay.feishu.cn/sheets/MmMfsrTbnhn744tjYdEcvoNmn83))
}返回参数
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 返回状态 | code | 是 | int | 0 | 0-处理成功,其他-处理有误,详见错误码 |
| 返回信息 | msg | 否 | String(128) | SUCCESS | 具体错误原因,例如:签名失败、参数格式校验错误 |
| 签名信息 | sign | 否 | String(32) | 4AAD8F50C9F2897D4292F28FE5DFAADB | 对data内数据签名,如data为空则不返回 |
| 返回数据 | data | 否 | String(512) | {} | 返回下单数据,json格式数据 |
返回示例数据
{
"code": 0,
"data": {},
"msg": "SUCCESS",
"sign": "4AAD8F50C9F2897D4292F28FE5DFAADB"
}文档更新时间: 2026-03-12 11:51 作者:大森林