2.13【查询会员信息】接口


测试地址:https://ibstest.allinpay.com/yst/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-会员交易控制类型

返回会员交易控制标识

12-个人支付账户信息

返回个人支付账户开户、限额信息

业务请求参数

字段

字段类型

字段长度

必填

字段名称

说明

signNum

String

60

是

商户会员编号

平台则上送“#yunBizUserId_B2C”

infoType

String

1

是

查询信息类型

1-基本信息

2-银行账户信息

3-协议信息

4-影印件ocr核对信息

5-绑定手机号信息

6-支付账户信息

7-支付账户审核结果详情

8-银行子账户信息

9-待结算户信息

10-会员交易控制类型

12-个人支付账户信息

业务响应参数

字段

字段类型

字段长度

必填

字段名称

说明

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

JSONArray

 

否

银行子账户信息

 

settleAcctInfo

JSONObject

 

否

待结算户信息

 详情

memberControlInfo

JSONObject

 

否

会员交易控制类型

详情

memberSelfPayAcctInfo

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

是

银行名称

   

openBankNo

String

8

否

银行代码

对私卡:根据绑定的卡BIN识别对应银行代码

对公卡:请求上送的银行代码

字典

cardType

String

是

银行卡类型

详细

 

bindStatus

String

是

绑定状态

详细

 

bankReservePhone

String

否

银行预留手机号码

   

bindType

String

否

绑卡方式

详细

对公,为空

 

acctAttr

String

是

银行卡/账户属性

0:对私

1:对公

 

openBankBranchName

String

否

开户行支行名称

如:“中国工商银行股份有限公司北京樱桃园支行”

 

payBankNumber

String

否

支付行号

12位数字

 

openBankProvince

String

否

开户行所在省

开户行所在市必须同时上送

根据中国省市表的“省份”内容填写。详情

 

openBankCity

String

否

开户行所在市

开户行所在省必须同时上送

根据中国省市表的“城市”内容填写。详情

 

isSpecifyAcct

String

是

是否为支付账户指定出入金银行账户

  1. 是;
  2. 否
 

协议信息JSON(agreementArray)

字段

字段类型

必填

字段名称

说明

signAccount

String

是

签约户名

 

agreementType

String

是

协议类型

1-账户提现协议

2-收款协议

3-分账协议

4-授权委托协议

5-支付账户协议

6-平台抽佣协议

7-收单协议

8-通联支付特约商户综合服务协议

 

signResult

String

是

签约结果

1:签约成功

2:签约失败

3:签约中

0:未签约

agreeNo

String

是

协议编号

 

signTime

String

是

签约时间

 

anotherMemberInfo

JSONObject

否

另一方(收款方/分账方)签约信息

3-分账协议,返回

详细

另一方(收款方/分账方)签约信息JSON(anotherMemberInfo)

字段

字段类型

必填

字段名称

说明

signNum

String

是

另一方会员编号

返回收款方、分账方的签约户名

signAccount

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:不允许

 

个人支付账户信息-memberSelfPayAcctInfo

字段

字段类型

必填

字段名称

说明

payAcctNo

String

是

支付账户号

 

payAcctNoStatus

String

是

支付账户状态

0:待激活

2:正常

3:冻结

4:业务暂停

5:关停

6:涉案冻结

7:注销

openAcctTime

String

是

开户时间

格式如:2024-4-15 16:40:54

acctLevel

String

是

支付账户类别

1:一类

2:二类

3:三类

yearAmtLmt

String

是

人行年限额

返回剩余人行年限额

单位:分


2026年9月23日 11:06 收藏文档