测试地址:http://116.228.64.55:28082/yst-service-api/tm/handle
生产地址:https://ibsapi.allinpay.com/yst-service-api/tm/handle
接口代码(transCode):1027
功能说明:
(1)该接口支持查询个人会员、企业会员的会员信息。
(2)所有会员状态均支持查询会员信息。
(3)支持查询信息类型
(4)“查询信息类型”字段,支持多个枚举值通过逗号上送(兼容逗号的中英文),比如“1,2”/“2,3,4”,则返回对应查询信息;
信息类型 |
返回数据说明 |
1-基本信息 |
返回个人会员、企业会员基本信息 |
2-银行账户信息 |
返回个人会员(绑定状态=已绑定)的银行账户列表 返回企业会员(【企业会员实名开户】接口)设置的银行账户信息 |
3-协议信息 |
返回该会员签订的收款协议、账户提现协议、分账协议、授权委托书(所有签约状态的协议) |
4-影印件ocr核对信息 |
返回影印件识别比对结果 |
5-绑定手机信息 |
返回会员绑定的手机号 |
6-支付账户信息 |
返回会员支付账户信息 |
7-支付账户审核结果详情 |
返回会员支付账户审核结果详情 |
8-银行子账户信息 |
返回银行子账户信息(子账户、绑卡信息) |
9-待结算户信息 |
返回待结算户信息 |
10-会员交易控制类型 |
返回会员交易控制标识 |
业务请求参数
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
signNum |
String |
60 |
是 |
商户会员编号 |
平台则上送“#yunBizUserId_B2C” |
infoType |
String |
1 |
是 |
查询信息类型 |
1-基本信息 2-银行账户信息 3-协议信息 4-影印件ocr核对信息 5-绑定手机号信息 6-支付账户信息 7-支付账户审核结果详情 8-银行子账户信息 9-待结算户信息 10-会员交易控制类型 |
业务响应参数
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
respCode |
String |
5 |
是 |
业务码 |
00000:代表成功 66666、66667:处理中,即当前的请求已受理,需要继续调用关联的确认类接口,或通过发起订单查询、等待异步通知,来获取处理状态。 其他返回码:均代表失败 |
respMsg |
String |
200 |
否 |
失败原因 |
|
signNum |
String |
60 |
否 |
商户会员编号 |
|
memberBasicInfo |
JSONObject |
否 |
会员基本信息 |
||
acctInfo |
JSONArray |
否 |
银行账户信息 |
支持返回多个银行账户信息 |
|
agreementArray |
JSONArray |
否 |
协议信息 |
||
ocrResultJson |
JSONObject |
否 |
影印件OCR核对结果 |
||
bindPhoneJson |
JSONObject |
否 |
绑定手机号信息 |
||
payAcctOpenJson |
JSONObject |
否 |
支付账户开户信息 |
||
payAcctAuditJson |
JSONObject |
否 |
支付账户审核结果详情 |
||
bankSubAcctInfo |
JSONObject |
|
否 |
银行子账户信息 |
|
settleAcctInfo |
JSONObject |
|
否 |
待结算户信息 |
详情 |
memberControlInfo |
JSONObject |
|
否 |
会员交易控制类型 |
详情 |
个人基本信息JSON(memberBasicInfo)
字段 |
字段类型 |
必填 |
字段名 |
说明 |
name |
String |
否 |
姓名 |
|
cerType |
String |
否 |
证件类型 |
|
cerNum |
String |
否 |
身份证号码 |
SM4加密 |
isWithdraw |
String |
否 |
是否可提现 |
1:是 0:否 |
phone |
String |
否 |
绑定手机 |
|
idValidStartDate |
String |
否 |
证件有效开始日期 |
格式:9999-12-31 |
idValidEndDate |
String |
否 |
证件有效截止日期 |
格式:9999-12-31 |
registerTime |
String |
是 |
注册时间 |
格式:yyyy-MM-dd HH:mm:ss |
isRealNameAuth |
String |
否 |
是否实名认证 |
1:是 0:否 |
realNameAuthTime |
String |
否 |
实名认证时间 |
yyyy-MM-dd HH:mm:ss |
memberStatus |
String |
是 |
会员状态 |
|
memberRole |
String |
是 |
会员角色 |
|
memberType |
String |
是 |
会员类型 |
3:个人会员 |
企业基本信息JSON(memberBasicInfo)
字段 |
类型 |
必填 |
字段名称 |
说明 |
memberRole |
String |
是 |
会员角色 |
|
memberType |
String |
是 |
会员类型 |
2:企业会员 3:个人会员 |
enterpriseName |
String |
否 |
企业名称 |
|
addressCode |
String |
是 |
地区码 |
见数据字典 |
enterpriseAdress |
String |
否 |
企业注册地址 |
|
enterpriseNature |
String |
否 |
企业性质 |
1:企业 2:个体户 3:事业单位 无值,则不返回 |
unifiedSocialCredit |
String |
否 |
统一社会信用 |
|
busLicenseValidDate |
String |
否 |
营业证件有效期 |
|
phone |
String |
否 |
绑定手机 |
|
legalPersonName |
String |
否 |
法人姓名 |
|
legalPersonCerType |
String |
否 |
法人证件类型 |
|
legalPersonCerNum |
String |
否 |
法人证件号码 |
SM4加密,详细 |
idValidStartDate |
String |
否 |
法人证件有效开始日期 |
格式:9999-12-31 |
idValidEndDate |
String |
否 |
法人证件有效截止日期 |
格式:9999-12-31 |
legalPersonPhone |
String |
否 |
法人手机号码 |
|
memberStatus |
String |
是 |
会员状态 |
|
auditTime |
String |
否 |
审核时间 yyyy-MM-dd HH:mm:ss |
|
isWithdraw |
String |
否 |
簿记账户可提现标识 |
1:是 0:否 |
respMsg |
String |
否 |
审核失败原因 |
银行账户信息JSON(acctInfo)
字段 |
类型 |
必填 |
字段名称 |
说明 |
bankCardNo |
String |
是 |
银行卡号 |
SM4加密,详细。 |
bankAccountName |
String |
是 |
银行户名 |
|
bankName |
String |
是 |
银行名称 |
|
bindTime |
String |
是 |
绑定时间 |
yyyy-MM-dd HH:mm:ss |
cardType |
String |
是 |
银行卡类型 |
|
bindStatus |
String |
是 |
绑定状态 |
|
bankReservePhone |
String |
否 |
银行预留手机号码 |
|
bindType |
String |
否 |
绑卡方式 |
对公,为空 |
acctAttr |
String |
是 |
银行卡/账户属性 |
0:对私 1:对公 |
openBankBranchName |
String |
否 |
开户行支行名称 |
如:“中国工商银行股份有限公司北京樱桃园支行” |
payBankNumber |
String |
否 |
支付行号 |
12位数字 |
openBankProvince |
String |
否 |
开户行所在省 |
开户行所在市必须同时上送 根据中国省市表的“省份”内容填写。详情 |
openBankCity |
String |
否 |
开户行所在市 |
开户行所在省必须同时上送 根据中国省市表的“城市”内容填写。详情 |
isSpecifyAcct |
String |
是 |
是否为支付账户指定出入金银行账户 |
|
协议信息JSON(agreementArray)
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
signAccount |
String |
是 |
签约户名 |
|
agreementType |
String |
是 |
协议类型 |
1-账户提现协议 2-收款协议 3-分账协议 4-授权委托协议 5-支付账户协议 6-平台抽佣协议 7-收单协议
|
signResult |
String |
是 |
签约结果 |
1:签约成功 2:签约失败 3:签约中 0:未签约 |
agreeNo |
String |
是 |
协议编号 |
|
signTime |
String |
是 |
签约时间 |
|
anotherMemberInfo |
JSONObject |
否 |
另一方(收款方/分账方)签约信息 |
3-分账协议,返回 |
另一方(收款方/分账方)签约信息JSON(anotherMemberInfo)
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
signAccount |
String |
是 |
另一方会员编号 |
返回收款方、分账方的会员编号 |
signNum |
String |
是 |
另一方签约户名 |
返回收款方、分账方的签约户名 |
影印件ocr核对信息JSON(ocrResultJson)
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
enterpriseCompareResult |
String |
否 |
OCR识别与企业工商认证信息是否一致: 1-是 2-否 3-识别失败 |
|
legalPersonCompareResult |
String |
否 |
OCR识别与企业法人实名信息是否一致: 1-是 2-否 3-识别失败 |
绑定手机号JSON(bindPhoneJson)
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
isBind |
String |
是 |
是否已绑定手机 |
0-否 1-是 |
phone |
String |
否 |
绑定手机 |
支付账户信息JSON(payAcctOpenJson)
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
cusId |
String |
是 |
统一客户号 |
|
payAcctNo |
String |
是 |
支付账户号 |
|
payAcctNoStatus |
String |
是 |
支付账户状态 |
0:待激活 2:正常 3:冻结 4:业务暂停 5:关停 6:涉案冻结 7:注销 |
openAcctTime |
String |
是 |
开户时间 |
格式如:2024-4-15 16:40:54 |
支付账户审核结果详情JSON(payAcctAuditJson)
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
enterpriseVerifyResult |
String |
否 |
工商验证 |
0:无材料 1:待审核 2:系统验证通过 3:人工验证通过 4:系统验证不通过 5:人工验证不通过 |
legaIdCardVerifyResult |
String |
否 |
法人验证 |
|
bankAcctVerifyResult |
String |
否 |
银行结算账户验证 |
|
unifiedCreditPhotoResult |
String |
否 |
统一信用证照片验证 |
|
legalCerPhotoResult |
String |
否 |
法人证件照片验证 |
|
settleAcctPhotoResult |
String |
否 |
结算账户照 |
|
busOutdoorPhotoResult |
String |
否 |
经营门头照片 |
|
busInnerPhotoResult |
String |
否 |
经营内景照 |
|
acctManOutdoorPhotoResult |
String |
否 |
客户经理与门头照 |
|
acctManWithIdPhotoResult |
String |
否 |
客户经理手持身份证照片 |
|
busCoopConfirmResult |
String |
否 |
客户业务合作确认函 |
|
nonNatBenfitInfoResult |
String |
否 |
非自然人客户受益所有人信息登记表 |
|
tlPayAcctNoAgreeResult |
String |
否 |
通联单位支付账户服务协议 |
待结算户信息JSON-settleAcctInfo
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
vspCusId |
String |
是 |
收银宝商户号 |
|
acctNo |
String |
是 |
待结算账户号 |
|
status |
String |
是 |
待结算户状态 |
0:待激活 1:正常 2:冻结 |
会员交易控制标识JSON-memberControlInfo
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
sepOutFlag |
String |
否 |
分账出金 |
1:允许 0:不允许 |
sepInFlag |
String |
否 |
分账入金 |
1:允许 0:不允许 |
memberWithdrawFlag |
String |
否 |
会员提现 |
1:允许 0:不允许 |