接口用于宝付账簿开户,开户成功后每个账户下面会有2个类型账户:在途户+可用余额户。基于资金的分账,分账到二级户的资金只能到可用余额户。基于订单的分账,分账到二级户的资金先记账在途户,资金结算后才会到可用余额户。可用余额户的资金可以提现。


接口说明

成功判定标准:应答报文中retCode =1,且result中state =1为成功。

请求参数

参数名称 类型 长度 出现要求 参数备注
version String 5 M 版本号1.0.0
accType int 1 M 账户类型:1-个人,2-企业/个体
accInfo Object M 开户具体信息根据类型不同,信息不同,现只支持单笔开户
noticeUrl String 256 M 开户结果通知地址,通知参数详见开户结果通知
businessType String 32 M 宝财通3: BCT3

accType=1个人用户开户信息列表accInfo

参数名称 类型 长度 出现要求 参数备注
transSerialNo String 200 M 请求流水号
loginNo String 32 M 登录号,商户自定义要求全局唯一,长度11位以上
customerName String 32 M 客户名称与持卡人姓名一致
certificateType String 16 M 证件类型,身份证: ID
certificateNo String 64 M 身份证号码
cardUserName String 20 M 持卡人姓名
needUploadFile boolean M 是否需要上传附件,true/false
platformNo String 32 C 平台号 (代理模式下此处为业务方商户号非代理商商户号)
platformTerminalId String 32 C 终端号(代理模式必传)
qualificationTransSerialNo String 128 C 资质文件流水,是否上传请咨询业务对接人

请求参数示例

{
    "noticeUrl": "http://10.0.60.55:8083/BctJavaDemo2.0/NorifyServlet/open/1",
    "accType": "1",
    "businessType": "BCT3",
    "version": "1.0.0",
    "accInfo": {
        "needUploadFile": false,
        "loginNo": "person002",
        "certificateNo": "340101198108119852",
        "transSerialNo": "TSN314778753119603185643720",
        "customerName": "张宝",
        "certificateType": "ID"
    }
}

返回参数

参数名称 类型 长度 出现要求 参数备注
version String 5 O 版本号1.0.0
retCode int 4 M 返回码 1 成功 0 失败
errorCode String 20 C 错误码
errorMsg String 40 C 错误原因
back1 String 64 O 备用字段
back2 String 64 O 备用字段
back3 String 100 O 备用字段
result List 返回数据列表


列表result

参数名称 类型 长度 出现要求 参数备注
state String 4 M 状态 1 成功 0 失败 -1 异常 2开户处理中
errorCode String 20 C 错误码
errorMsg String 40 C 错误原因
transSerialNo String 200 M 请求流水号
loginNo String 128 M 登录号
customerName String 64 M 商户名称
contractNo String 64 C 商户客户号
- - - C 上级平台商户号

返回参数示例

{
    "result": [{
        "customerName": "张宝",
        "loginNo": "person002",
        "state": 2,
        "transSerialNo": "TSN314778753119603185643720"
    }],
    "retCode": 1
}