银行账户受益人补充
此接口用于银行账户受益人补充。此接口3.19可正常使用
|
报文编号 |
版本号 |
| 请求 |
BNK1-1001-004-01 |
1.0.0 |
| 应答 |
BNK1-1001-004-01 |
1.0.0 |
对接要求：需要签名验签，部分敏感字段推荐单独加密
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 统一会员号 |
uid |
string(64) |
Y |
|
| 商户请求流水号 |
orderId |
string(64) |
Y |
|
| 原开户请求流水号 |
oriOrderId |
string(64) |
Y |
|
| 银行类型 |
bankType |
string(16) |
Y |
SSQY-MC：苏商企业号-多渠道 |
| 受益人信息 |
shareholdersInfo |
json数组 |
Y |
支持上送最多4组受益人信息 |
| 银行扩展信息 |
bankExtra |
json |
N |
|
shareholdersInfo受益人信息字段
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 受益人名称 |
beneficiaryName |
string(32) |
Y |
受益人名称 |
| 证件类型 |
beneficiaryIdType |
string(16) |
Y |
见附录：证件类型 |
| 证件号码 |
beneficiaryIdNo |
string(32) |
Y |
证件号码 |
| 证件有效期开始时间 |
beneficiaryIdEffDate |
string(16) |
Y |
yyyy-MM-dd |
| 证件有效期过期时间 |
beneficiaryIdOffDate |
string(16) |
Y |
yyyy-MM-dd（长期传9999-12-30） |
| 出生日期 |
beneficiaryBirth |
string(16) |
Y |
出生日期，yyyy-MM-dd |
| 联系地址 |
beneficiaryAddress |
string(64) |
Y |
联系地址 |
| 联系方式 |
beneficiaryPhone |
string(20) |
N |
联系方式 |
| 性别 |
beneficiaryGender |
string(1) |
Y |
1-男，2-女 |
| 国籍 |
beneficiaryCountry |
string(3) |
Y |
156-中国 |
| 受益人证件正面影像 |
beneficiaryIdFrontPicId |
string(100) |
Y |
文件上传接口返回的文件id |
| 受益人证件反面影像 |
beneficiaryIdBackPicId |
string(100) |
Y |
文件上传接口返回的文件id |
| 受益所有权关系类型 |
beneficiaryRelType |
string(1) |
Y |
1-25%以上股权/股份；2-25%以上合伙权益；3-25%以上收益权；4-25%以上表决权；5-实际控制；6-日常经营管理 |
| 受益人关系开始时间 |
beneficiaryRelStartDt |
string(16) |
Y |
yyyy-MM-dd |
| 受益人关系终止时间 |
beneficiaryRelEndDt |
string(16) |
Y |
yyyy-MM-dd |
公共报文 - 返回参数
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| code |
返回码 |
string(64) |
C |
|
| message |
返回信息 |
string(32) |
C |
|
| success |
响应状态 |
Boolean |
Y |
true：响应成功 false：业务异常 |
| data |
返回参数 |
json |
C |
见下方开户申请返回参数 |
企业受益人信息补录 - 返回参数 (data)
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| orderNo |
系统订单号 |
string(64) |
Y |
|
| status |
状态 |
string(20) |
Y |
F：失败 S：成功 |
| returnMsg |
返回信息 |
string(256) |
C |
错误描述 |
