接口用于宝付账簿开户,开户成功后每个账户下面会有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 | 返回数据列表 |
参数名称 | 类型 | 长度 | 出现要求 | 参数备注 |
---|---|---|---|---|
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
}