测试地址:https://ibstest.allinpay.com/idea/precusapi/api
生产地址:https://ibsapi.allinpay.com/yst-service-api/cusapi
接口代码(transCode):1070
接口说明:
代理商进件场景中,方便代理商拓展人快速完成商户进件,新增【会员进件H5】接口,对接收银宝商户进件H5接口,实现H5进件能力
业务请求参数
|
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
|
reqTraceNum |
String |
50 |
是 |
进件请求流水号 |
|
|
signNum |
String |
60 |
是 |
商户会员编号 |
|
|
memberRole |
String |
60 |
是 |
会员角色 |
仅支持收款方的角色 不送默认“收单商户” |
|
notifyUrl |
String |
256 |
是 |
会员进件结果通知地址 |
|
|
expandUser |
String |
|
是 |
拓展人 |
代理商所属拓展人,格式如:测试(13800000000) |
|
merAddBasicInfo |
JSONObject |
是 |
会员基本信息 |
||
|
merAddBankAcctInfo |
JSONObject |
否 |
银行账户信息 |
业务响应参数
|
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
取值 |
|
reqTraceNum |
String |
50 |
是 |
进件请求流水号 |
业务正常处理,则返回 |
|
respTraceNum |
String |
40 |
是 |
响应流水号 |
业务正常处理,则返回 |
|
respCode |
String |
5 |
是 |
业务返回码 |
00000:代表成功 66666、66667:处理中,即当前的请求已受理,需要继续调用关联的确认类接口,或通过发起订单查询、等待异步通知,来获取处理状态。 其他返回码:均代表失败 |
|
respMsg |
String |
200 |
否 |
业务返回说明 |
|
|
signNum |
String |
60 |
是 |
商户会员编号 |
|
|
auditStatus |
String |
否 |
审核状态 |
respCode为00000-交易成功时返回 00-受理成功待提交审核 01-审核中 02-审核通过 03-审核失败 04-提交审核失败 |
会员基本信息json(merAddBasicInfo)
|
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
|
comProperty |
String |
1 |
是 |
商户性质: 1.企业 3.个体户 4.个人 5.其他组织 6.事业单位 |
|
|
creditCode |
String |
32 |
否 |
统一社会信用代码 |
商户性质非个人,必填 |
|
legalIdNo |
String |
50 |
否 |
法人证件号码 |
SM4加密,详细 商户性质个人必填 |
银行账户信息json(merAddBankAcctInfo)
|
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
|
acctAttr |
String |
是 |
账户类型 |
0:对私(银行账户名称默认为法人姓名) 1:对公(银行账户名称默认为企业名称) |
|
acctNum |
String |
是 |
账号 |
对公户支持数字和“-”字符 SM4加密,详细 |
|
bankReservePhone |
String |
否 |
银行预留手机 |
账户类型=0-对私时需要填写 |
|
openBankNo |
String |
是 |
银行代码 |
详见字典,查看 |
|
openBankBranchName |
String |
否 |
开户行支行名称 |
如:“中国工商银行股份有限公司北京樱桃园支行” 账户类型=1-对公时需要填写 |
|
payBankNumber |
String |
否 |
支付行号,12位数字 |
账户类型=1-对公时需要填写, |
|
openBankProvince |
String |
否 |
开户行所在省 |
根据中国省市表的“省份”内容填写,中文。详情 账户类型=1-对公时需要填写 |
|
openBankCity |
String |
否 |
开户行所在市 |
根据中国省市表的“城市”内容填写,中文。详情 账户类型=1-对公时需要填写 |
【会员进件结果通知】
接口代码(transCode):1071
接口说明:
【会员进件接口】响应已受理后,通过该接口通知该会员的进件审核结果;
|
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
|
reqTraceNum |
String |
50 |
是 |
进件请求流水号 |
商户系统内保持唯一,定义长度为50位 |
|
signNum |
String |
60 |
是 |
商户会员编号 |
|
|
respCode |
String |
5 |
是 |
业务返回码 |
|
|
respMsg |
String |
200 |
否 |
业务返回说明 |
|
|
auditStatus |
String |
1 |
是 |
审核状态 |
01-审核中 02-审核通过 03-审核失败 04-提交审核失败 |
|
cusId |
String |
32 |
否 |
通联收银宝商户号 |
事后校验通过时返回 |