接口说明

适用描述:支持变更分账用户结算卡信息。

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

请求URL:https://pay.jeepay.vip/api/division/receiver/settle/update

请求方式:POST

请求类型:application/jsonapplication/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   作者:大森林