3.2【个人会员实名及绑卡申请】接口

测试地址：https://ibstest.allinpay.com/yst/yst-service-api/tm/handle

生产地址：https://ibsapi.allinpay.com/yst-service-api/tm/handle

接口代码（transCode）：1010

功能说明：

中信、华通托管：

1.开户场景：

（1）支持未实名的个人会员在银行侧开户+绑卡；

（2）支持已实名未开户的个人会员在银行卡侧开户+绑卡；

（3）中信银行、华通银行支持未实名的个人会员在银行侧开户；

说明：需完成通联认证（身份证二要素认证、银行账户四要素认证）均通过下，发送银行认证，银行自动认证通过，则开户成功；

2.一个会员仅支持开通一个银行子账户，接口实时响应银行子账户开户结果和绑卡结果；

3.开户成功后：

（1）【个人会员管理】菜单保存个人会员信息；

（2）【银行子账户信息管理】菜单落地会员与子账户信息；

（3）若绑卡成功，【银行卡管理】菜单保存会员银行卡信息；

（4）若银行卡通过绑卡方式7/6-快捷签约，则绑卡成功后，则将银行卡预留手机号作为绑定个人手机号，后续无需通过【会员绑定手机号申请】接口完成绑定手机号。

4. 同一个证件开户数：

中信银行：一个证件号可注册用户个数未明确限，按银行风控模型识别出来冻结账户；

华通银行：默认同一身份证号码可开户的最大数量限制为2个；

民生银行；默认同一证件号可开户个数99个；

5.绑卡个数：建议一个用户最好仅绑定一个银行账户；

测试参数说明：

收付通绑卡（绑卡方式6）规则：
卡号0、1、9结尾模拟为成功
卡号2结尾模拟为无效卡号
卡号3结尾模拟为已挂失卡
卡号4结尾模拟为余额不足
卡号5结尾模拟为无此账户
卡号6结尾模拟为无此原交易
卡号7结尾模拟为户名错
卡号8结尾模拟为交易超时

统一认证绑卡（绑卡方式8）模拟规则如下:
{"卡号第四位为0","交易成功"},
{"卡号第四位为1","查开户方原因"},
{"卡号第四位为2","无效卡号 "},
{"卡号第四位为3","已挂失卡"},
{"卡号第四位为4","余额不足"},
{"卡号第四位为5","无此账户"},
{"卡号第四位为6","原交易失败，不收费"},
{"卡号第四位为7","户名错"},
{"卡号第四位为8","交易超时"}

业务请求参数

字段	字段类型	字段长度	必填	字段名称	说明
reqTraceNum	String	50	是	请求流水号
signNum	String	60	是	商户会员编号
memberRole	String	60	否	会员角色	（1）未注册时必须上送角色（2）已注册时，无需上送说明：测试环境，会员角色枚举值详见【接入指引-联调测试】模块
name	String	32	是	姓名	说明：企业法人名称、个人姓名
cerType	String	2	是	证件类型	见枚举值，支持多种证件类型注:绑卡方式8仅支持身份证
cerNum	String	32	是	证件号码 AES加密	AES加密。详细
acctNum	String	32	否	银行卡号 AES加密	详细若绑卡，则银行卡四要素信息字段必须均上送。针对民生银行，【银行账户信息】必填，实现开户+绑卡；华通银行，若绑卡则必填；中信银行，若绑卡则必填；
phone	String	11	否	银行预留手机
bindType	String	1	否	绑卡方式 6-通联通协议支付签约/7-收银宝快捷支付签约/8-银行卡四要素验证说明：非大陆身份证支持绑卡方式6和7、8。
validDate	String	4	否	有效期，格式为月年；如0321，2位月2位年说明：针对信用卡，若商户送，则透传渠道
cvv2	String	3	否	CVV2，3位数字说明：针对信用卡，若商户送，则透传渠道
payBankNumber	String		否	联行号（支付行号）	中信银行：必填；民生银行：必填；
personalDetail	JSONObject		否	个人详细信息	华通银行，必填民生银行：必填详情
bankAcctReqInfo	JSONObject		否	银行开户请求信息	银行托管模式，需请求银行，则上送；详情

响应请求参数

字段	字段类型	字段长度	必填	字段名称	说明
respTraceNum	String	40	否	响应流水号	必填字段校验均通过，返回此字段
signNum	String	60	否	商户会员编号	业务返回码=00000，返回
bankAcctResInfo	JSONObect		否	银行开户响应信息	详情说明：银行托管模式返回开户+绑卡信息
respCode	String	5	是	业务返回码	00000：代表成功 66666、66667：处理中，即当前的请求已受理，需要继续调用关联的确认类接口，或通过发起订单查询、等待异步通知，来获取处理状态。其他返回码：均代表失败
respMsg	String	200	否	业务返回说明

个人详细信息

字段	字段类型	必填	字段名称	说明
phone	String	否	手机号码	针对华通银行，必填
address	String	否	住所/工作地址	针对华通银行，必填
provinceCode	String	否	省行政编码	针对华通银行，必填
cityCode	String	否	市行政编码	针对华通银行，必填
areaCode	String	否	区/县行政编码	针对华通银行，必填详情
country	String	否	国籍、地区编码	针对华通银行，必填详情
profession	String	否	职业	针对华通银行，必填详情
certBeginDate	String	否	证件有效开始日期	针对华通银行，必填
certEndDate	String	否	证件有效截止日期	若长期有效上送“9999-12-31”
certFrontToken	String	否	个人身份证（肖像面）token	通过【文件上传下载接口】上传文件图片后获取的fileId，有效期30分钟，图片不超过2M 身份证证件类型：个人肖像面和国徽面必须同时上传。非身份证证件类型：仅上传“个人身份证（肖像面）token”即可针对华通银行，必填
certBackToken	String	否	个人身份证（国徽面）token
sex	String	否	性别	1：男 0：女民生银行，必填