接口说明

适用描述:查询分账用户的绑定状态及信息。

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

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

请求方式:POST

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