接口说明

  1. 报文编号：T-M-001-0002

请求报文说明

参数名称 类型 长度 出现要求 参数备注
version String 5 M 版本号4.0.0
merTransNo String [1,64] M 商户自定义的唯一编号，要求 64 个字符内，只能是数字、大小写字母和下划线
orgType String [1,32] M 1 - 企业 2 - 个体工商户
enterpriseName String [1,100] M 企业名称
personName String [1,32] M 法人姓名
regAddress String [1,200] M 企业注册地址
businessLicenseCode String [1,64] M 统一社会信用代码
idIndateBegin String [1,10] M 营业执照有效期开始 格式：yyyy-MM-dd或长期
idIndateEnd String [1,10] M 营业执照有效期结束 格式：yyyy-MM-dd或长期
personIdType String [1,3] M 法人证件类型
personIdIndateBegin String [1,10] M 法人证件有效期开始 格式：yyyy-MM-dd或长期
personIdIndateEnd String [1,10] M 法人证件有效期结束 格式：yyyy-MM-dd或长期
personIdCode String [1,32] M 法人证件号
mobile String [1,11] M 手机号码
businessLicensePic String [1,65532] M 营业执照图片 Base64字符串<200k,苏商企业号填入文件上传接口返回的文件ID
personPicA String [1,65532] M 法人证件正面图片 Base64字符串<200k,苏商企业号填入文件上传接口返回的文件ID
personPicB String [1,65532] M 法人证件反面图片 Base64字符串<200k,苏商企业号填入文件上传接口返回的文件ID
acctNo String [1,32] M 银行账号
acctName String [1,100] M 银行账户名称
opBankCode String [1,32] M 开户行号
opBankName String [1,100] M 开户行名称
businessScope String [1,1024] C 经营范围
regProvince String [1,6] C 企业注册地所在省
regCity String [1,6] C 企业注册地所在市
regArea String [1,6] C 企业注册地所在县/区
linkProvince String [1,6] C 企业联系地址所在省
linkCity String [1,6] C 企业联系地址所在市
linkArea String [1,6] C 企业联系地所在县/区
linkAddress String [1,512] C 企业联系详细地址 苏商银行必填
regCapital String [1,20] C 企业注册资金 单位：元。 苏商银行必填
legalPhone String [1,20] Y 法人电话 苏商银行必填且为11位手机号
shareholderReqDTOList json数组 C 股东信息 支持上送最多4组股东信息
shareholderItems[shareholderName] String [1,20] C 股东或实际控制人姓名
shareholderItems[shareholderIdType] String [1,3] C 证件类型
shareholderItems[shareholderIdNo] String [1,32] C 股东或实际控制人证件号
shareholderItems[shareholderIdEffDate] String [1,20] C 股东或实际控制人证件生效日期 格式：yyyy-MM-dd或长期
shareholderItems[shareholderIdOffDate] String [1,20] C 股东或实际控制人证件失效日期 格式：yyyy-MM-dd或长期
shareholderItems[shareholderPhone] String [1,20] C 股东或实际控制人电话
enterpriseType String [1,6] C 企业类型，类型参看《附录》
enterpriseScale String [1,6] C 企业规模，类型参看《附录》
listingType String [1,6] C 上市类型，类型参看《附录》
economicNature String [1,6] C 企业经济性质，类型参看《附录》
beneficiaryReqDTOList json数组 C 支持上送最多4组受益人信息 苏商银行必填
beneficiaryItems[beneficiaryName] String [1,20] C 苏商银行必填
beneficiaryItems[beneficiaryIdType] String [1,3] C 苏商银行必填
beneficiaryItems[beneficiaryIdNo] String [1,32] C 苏商银行必填
beneficiaryItems[beneficiaryIdEffDate] String [1,10] C 苏商银行必填 格式：yyyy-MM-dd或长期
beneficiaryItems[beneficiaryIdOffDate]] String [1,10] C 苏商银行必填 格式：yyyy-MM-dd或长期
beneficiaryItems[beneficiaryPhone] String [1,20] C 苏商银行必填
beneficiaryItems[beneficiaryAddress] String [1,512] C 受益所有人地址 苏商银行必填
balanceAcctName String [1,100] C 电子账簿账户名称 暂只支持苏商银行，其他银行不填；自定义账户名称，首次开户的账户名称默认为企业名称，二次开户默认与首次开户同名
extra json C 扩展字段
bankType String [1,16] C 银行类型：电子户所属银行类型，类型参看《附录》
bankExtra json C 银行扩展信息 详细见不同银行字段
noticeUrl String [1,255] C 开户和交易的通知地址
merchantName String [1,64] C 所属商户号 (传输规则请联系技术支持)

[bankExtra] 银行扩展信息

  • 苏商企业号扩展信息

参数名称 类型 长度 出现要求 参数备注
userNo String 32 M 接入方用户号（接入方系统用户的唯一标志）
contact json M 联系人信息
contact[name] String [1,200] M 联系人姓名
contact[idType] String [1,3] M 联系人证件类型
contact[idNo] String [1,32] M 联系人证件号
contact[idStartDate] String [1,10] C 联系人证件生效日期 格式：yyyy-MM-dd或长期
contact[idEndDate] String [1,10] C 联系人证件失效日期 格式：yyyy-MM-dd或长期
contact[phone] String [1,11] C 联系人手机号
contact[contactPicA] String [1,255] C 联系人证件正面 文件上传接口返回的文件ID
contact[contactPicB] String [1,255] C 联系人证件反面 文件上传接口返回的文件ID
bindType String [1,2] M 是否本行卡标识 0-他行 1-本行
incomeOwnerProvePicId String [1,255] C 受益所有人识别材料影像 文件上传接口返回的文件ID

返回报文说明

参数名称 类型 长度 出现要求 参数备注
retCode int 4 M 返回码
errorCode String 20 C 错误码
errorMsg String 40 C 错误原因
back1 String 64 O 备用字段
back2 String 64 O
back3 String 100 O 备用字段
merTransNo String [1,64] O
orderNo String [1,64] O 系统订单号
status String [1,32] M 进件状态 processing：处理中 succeeded：已通过 failed：被驳回
failureMsg String [1,256] C 审核失败原因 进件状态为 failed、processing 返回
balanceAcctId String [1,32] C 电子账簿ID 当进件状态为 succeeded 时返回
relAcctNo String [1,32] C 电子账簿账簿号 当进件状态为 succeeded 时返回
memo String [1,255] 备注
bankType String [1,16] M 银行类型
bankExtra json C 银行扩展信息

响应报文判断结构

{
header.sysRespCode：S_0000(请求正常,继续查看body)
    body.retCode：1
         body.status = succeeded (成功)
         body.status = failed (失败)
         body.status = processing (处理中)
    body.retCode：0|2
        body.errorCode = BF0001 (失败)
        body.errorCode = 其他错误码 (异常,调用查询接口)

header.sysRespCode：S_E_9002(未知,调用查询接口)
header.sysRespCode：其他错误码(失败)


}
作者：闫婷  创建时间：2024-12-05 20:31
最后编辑：xingchuanyi  更新时间：2025-04-23 16:43