接口说明

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

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

请求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   作者:大森林