测试地址: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)“查询信息类型”字段,支持多个枚举值通过逗号上送(兼容逗号的中英文),比如“1,2”/“2,3,4”,则返回对应查询信息;
业务请求参数
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
reqTraceNum |
String |
是 |
请求流水号 |
|
signNum |
String |
是 |
商户会员编号 |
|
infoType |
Long |
是 |
查询信息类型 |
1-基本信息 2-银行账户信息 3-协议信息 4-影印件ocr核对信息 5-绑定手机号信息 8-银行子账户信息查询(仅银行管理模式,可上送) 10-会员交易控制类型 |
业务响应参数
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
respTraceNum |
String |
否 |
响应流水号 |
|
respCode |
String |
是 |
业务码 |
00000:代表成功 66666、66667:处理中,即当前的请求已受理,需要继续调用关联的确认类接口,或通过发起订单查询、等待异步通知,来获取处理状态。 其他返回码:均代表失败 |
respMsg |
String |
否 |
失败原因 |
|
signNum |
String |
是 |
商户会员编号 |
|
memberBasicInfo |
JSONObject |
否 |
会员基本信息 |
|
acctInfo |
JSONArray |
否 |
银行账户信息 |
支持返回多个银行账户信息 |
agreementArray |
JSONArray |
否 |
协议信息 |
|
ocrResultJson |
JSONObject |
否 |
影印件OCR核对结果 |
|
bindPhoneJson |
JSONObject |
否 |
绑定手机号信息 |
|
bankSubAcctInfo |
JSONObject |
否 |
银行子账户信息 |
|
memberControlInfo |
JSONObject |
|
否 |
个人基本信息(获取)(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:个人会员 |
企业基本信息(获取)(memberBasicInfo)
字段 |
类型 |
必填 |
字段名称 |
说明 |
memberRole |
String |
是 |
会员角色 |
|
memberType |
String |
是 |
会员类型 |
2:企业会员 3:个人会员 |
enterpriseName |
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:否 |
addressCode |
String |
是 |
地区码 |
见数据字典 |
respMsg |
String |
否 |
审核失败原因 |
银行账户信息(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 |
是 |
是否为支付账户指定出入金银行账户 |
|
影印件ocr核对信息JSON(ocrResultJson)
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
enterpriseCompareResult |
String |
否 |
OCR识别与企业工商认证信息是否一致 |
0-否 1-是 |
legalPersonCompareResult |
String |
否 |
OCR识别与企业法人实名信息是否一致 |
0-否 1-是 |
result |
String |
否 |
比对结果说明 |
存在多种结果信息一起返回,使用“;”进行拼接 |
协议信息(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-分账协议,返回 |
另一方(收款方/分账方)签约信息
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
signAccount |
String |
是 |
另一方会员编号 |
返回收款方、分账方的会员编号 |
signNum |
String |
是 |
另一方签约户名 |
返回收款方、分账方的签约户名 |
绑定手机号(bindPhoneJson)
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
isBind |
String |
是 |
是否已绑定手机 |
0-否 1-是 |
phone |
String |
否 |
绑定手机 |
银行子账户信息(bankSubAcctInfo)
字段 |
字段类型 |
必填 |
字段名 |
说明 |
openBankNo |
String |
是 |
开户银行编码 |
中信银行:1001 |
subAcctNo |
String |
是 |
银行子账号 |
开户成功,则返回 |
subAcctStatus |
String |
是 |
银行子账户状态 |
|
openAcctTime |
String |
是 |
开户时间 |
开户成功,则返回 格式:202404251647 |
cardList |
List |
否 |
银行绑卡信息 |
银行绑卡信息
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
cardNo |
String |
是 |
银行卡号 |
明文返回 |
bindState |
String |
是 |
卡状态 |
1:已绑定 0:未绑定 2: 已解绑 3:已冻结(账号暂不可用) |
会员交易控制标识JSON-memberControlInfo
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
sepOutFlag |
String |
否 |
分账出金 |
1:允许 0:不允许 |
sepInFlag |
String |
否 |
分账入金 |
1:允许 0:不允许 |
memberWithdrawFlag |
String |
否 |
会员提现 |
1:允许 0:不允许 |