④ 建收款人
散户扫脸通过后,调本接口把散户 + 银行卡报给工行,在指定回收企业下建成"收款人"。下面是工行的全部字段,原样传即可;标「中台填」的是平台凭据,开灵自动补,你不用传。
接口
POST https://openapi.kailingteck.com/api/v1/icbc/receiver/add
鉴权:请求头 X-App-Key + X-Sign + X-Timestamp(同其它开灵接口)。
请求参数(工行全字段 · 原样传)
| 工行字段 | 必填 | 大白话说明 |
|---|---|---|
appId | 中台填 | 平台编号(开灵自动填,你不用传) |
appIdSub | 再生资源必填 | 付方 / 回收企业编号(businessType=0004、0005 时必填) |
outUserId | 必填 | 散户在你们系统的唯一编号(同一档案下不能重复) |
businessType | 必填 | 业务类型:0004-再生资源 / 0005-农产品收购 / 0006-开票业务 |
accountKind | 必填 | 账户类型:02-个人 |
receiverType | 必填 | 用户类型:03-自然人 |
receiverAccount | 必填 | 散户收款的银行卡号 |
receiverName | 必填 | 收款人户名(要和银行卡绑定的名字一致) |
accountCode | 必填 | 是不是工行卡:0-非工行卡 / 1-工行卡 |
bankName | 非工行卡填 | 开户行名称(accountCode=0 时填) |
bankCode | 非工行卡填 | 开户行联行号(accountCode=0 时填) |
mobile | 必填 | 散户手机号 |
idType | 必填 | 证件类型:0-身份证(目前只支持身份证) |
idNo | 必填 | 身份证号 |
occupation | 无工行账户时必填 | 职业:1公务员/2事业单位/3公司员工/4军警/5工人/6农民/7管理/8技术/9私营业主/10文体明星/11自由职业/12学生/13无职业/14其他/15退休 |
address | 无工行账户时必填 | 常用住址(不少于 4 个汉字或 7 个字符) |
signDate | 必填 | 身份证签发日期,格式 yyyy-MM-dd |
validityPeriod | 必填 | 身份证截止日期 yyyy-MM-dd(永久有效填 9999-12-30) |
callbackUrl | 中台填 | 审核结果通知地址(开灵自动填成回调口) |
返回(工行原样返回)
| 工行字段 | 大白话说明 |
|---|---|
return_code | 返回码 |
return_message | 返回码说明 |
outUserId | 入驻的散户编号 |
applyTime | 申请入驻时间 |
auditTime | 审核通过时间 |
autoAuditStatus | 自动审核状态:0-失败 / 1-成功 |
受理后需工行分行审核,审核结果走 ⑤ 入驻审核结果。未配工行凭据时返回 { mock: true };配好后工行响应字段原样返回。