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

测试地址：http://116.228.64.55:28082/yst-service-api/tm/handle

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

接口代码（transCode）：1010

功能说明：

中信、华通托管：

1.开户场景：

（1）支持仅上送实名二要素信息完成会员实名，开通银行子账户（已实名个人会员进行再次实名，则提示“会员已实名!”）；

（2）支持上送实名二要素+银行账户四要素信息完成实名及绑卡，实现银行子账户开户及绑卡；

（3）支持已实名（开户）的个人会员，上送银行账户四要素完成绑卡；

2. 仅当通联认证（身份证二要素认证、银行账户四要素认证）均通过下，发送银行认证，银行自动认证通过，则开户成功；

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

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

处理逻辑：

（1）银行子账户开户成功，【个人会员管理】菜单保存个人会员信息；

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

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

测试参数说明：

收付通绑卡（绑卡方式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。
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	否	住所/工作地址	针对华通银行，所有要素必填
areaCode	String	否	地区码（省市区/县）	针对华通银行，所有要素必填详情
country	String	否	国籍、地区编码	针对华通银行，所有要素必填详情
profession	String	否	职业	针对华通银行，所有要素必填详情
certBeginDate	String	否	证件有效开始日期	针对华通银行，所有要素必填
certEndDate	String	否	证件有效截止日期	若长期有效上送“9999-12-31”
certFrontToken	String	否	个人身份证（肖像面）token	通过【文件上传下载接口】上传文件图片后获取的fileId，有效期30分钟，图片不超过2M 身份证证件类型：个人肖像面和国徽面必须同时上传。非身份证证件类型：仅上传“个人身份证（肖像面）token”即可针对华通银行，所有要素必填
certBackToken	String	否	个人身份证（国徽面）token