接口说明
适用描述:查询分账用户的绑定状态及信息。
适用对象:普通商户 特约商户
请求URL:https://pay.jeepay.vip/api/division/receiver/bindQuery
请求方式:POST
请求类型:application/json 或 application/x-www-form-urlencoded
请求参数
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 商户号 | mchNo | 是 | String(64) | M1708583228 | 商户号 |
| 应用ID | appId | 是 | String(64) | 66c6ff5a3d7a5d7a8999bd22 | 应用ID |
| 分账接收者ID | receiverId | 否 | long | 800019 | 分账接收者ID,与商户分账用户ID二传一即可,优先级高于商户分账用户ID |
| 商户分账用户ID | mchReceiverId | 否 | String(64) | M00000001 | 商户分账用户ID,与分账接收者ID二传一即可 |
| 请求时间 | reqTime | 是 | long | 1622016572190 | 请求接口时间,13位时间戳 |
| 接口版本 | version | 是 | String(3) | 1.0 | 接口版本号,固定:1.0 |
| 签名 | sign | 是 | String(32) | 539CC4CF5D99475D313BE1065F9F1C08 | 签名值,详见签名算法 |
| 签名类型 | signType | 是 | String(32) | MD5 | 签名类型,目前只支持MD5或RSA2方式 |
请求示例数据
{
"version": "1.0",
"reqTime": "1622016572190",
"signType": "MD5",
"sign": "539CC4CF5D99475D313BE1065F9F1C08",
"mchNo": "M1708583228",
"appId": "66c6ff5a3d7a5d7a8999bd22",
"receiverId": "800019"
}返回参数
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 返回状态 | code | 是 | int | 0 | 0-处理成功,其他-处理有误,详见错误码 |
| 返回信息 | msg | 否 | String(128) | SUCCESS | 具体错误原因,例如:签名失败、参数格式校验错误 |
| 签名信息 | sign | 否 | String(32) | 4AAD8F50C9F2897D4292F28FE5DFAADB | 对data内数据签名,如data为空则不返回 |
| 返回数据 | data | 否 | String(512) | {} | 返回下单数据,json格式数据 |
data数据格式
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 绑定账号ID | receiverId | 是 | long | 800019 | 绑定账号ID, 订单分账将使用该ID |
| 商户分账用户ID | mchReceiverId | 否 | String(64) | M00000001 | 商户分账用户ID |
| 接收者账号别名 | receiverAlias | 是 | String(64) | 延迟3m成功 | 接收者账号别名 |
| 分账接收账号类型 | accType | 是 | int | 1 | 分账接收账号类型: 0-个人(对私) 1-商户(对公) |
| 分账接收账号 | accNo | 是 | String(10) | 1231312@qq.com | 分账接收账号 |
| 分账接收账号名称 | accName | 否 | String(30) | 王五 | 分账接收账号名称 |
| 分账关系类型 | relationType | 是 | String(30) | demomockpay | 分账关系类型 |
| 渠道特殊信息 | channelExtInfo | 否 | String(256) | {} | 渠道特殊信息 |
| 签约绑定信息 | authInfo | 否 | String(256) | {} | 签约绑定信息,特殊渠道需进行签约绑定,见下方渠道说明 |
| 默认分账比例 | divisionProfit | 是 | String(10) | demomockpay | 默认分账比例 |
| 绑定成功时间 | bindSuccessTime | 否 | Long | 1734075275000 | 绑定成功时间 |
| 绑定状态 | bindState | 是 | int | 1 | 绑定状态 1-绑定成功, 0-绑定异常 2-绑定中 |
| 渠道错误码 | errCode | 否 | String | 上游渠道返回的错误码 | |
| 渠道错误描述 | errMsg | 否 | String | 上游渠道返回的错误描述 |
返回示例数据
{
"code": 0,
"data": {
"accName": "王五",
"accNo": "221111",
"accType": 0,
"appId": "66c6ff5a3d7a5d7a8999bd22",
"bindState": 1,
"bindSuccessTime": 1734075275000,
"divisionProfit": 0.05,
"ifCode": "demomockpay",
"mchNo": "M1708583228",
"receiverAlias": "延迟3m成功",
"receiverId": 800019,
"relationType": "SERVICE_PROVIDER",
"relationTypeName": "服务商"
},
"msg": "SUCCESS",
"sign": "4AAD8F50C9F2897D4292F28FE5DFAADB"
}
## 易宝渠道特殊信息说明
当使用易宝渠道添加入账方并使用全新资料录入时,如果绑定状态为绑定中,authInfo会返回签约链接,需入账方和商户分别打开链接进行签约。
`返回示例数据`{
“receiverSignUrl”: “https://mp.yeepay.com/0/xxxx\", // 入账方签约地址
“merchantSignUrl”: “https://mp.yeepay.com/0/xxxx\", // 商户签约地址
“state”: “BIND_ING” // 签约绑定状态:SIGN-待签约 SIGN_FINISH-已签约 SIGN_FAILED-签约失败 BIND_ING-绑定中 BIND_FAILED-绑定失败
}`
文档更新时间: 2026-03-12 11:51 作者:大森林