Appearance
进件接口
接口信息
需对方提供
- 地址:合作机构提供接口地址
- 请求方式:POST
- 接口说明:万利通调用机构进件接口,传入完整用户信息(含明文手机号)
请求参数
在撞库接口参数基础上增加以下字段:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| userId | String | 否 | 撞库阶段返回的用户标识 |
| applyNo | String | 否 | 撞库阶段返回的机构申请号 |
| mobile | String | 是 | 明文手机号 |
| agreementUrl | String | 否 | 万利通提供的个人信息授权协议链接,协议内容包含平台与合作机构双方公司名、产品名 |
说明:
userId和applyNo至少保留一个- 其他字段与撞库接口保持一致
authUrl仍表示机构回调万利通地址,不代表授权协议链接
响应参数
| 参数 | 类型 | 说明 |
|---|---|---|
| code | Integer | 0-成功 |
| msg | String | 响应消息 |
| data | Object | 响应数据 |
data 字段
| 参数 | 类型 | 说明 |
|---|---|---|
| url | String | 最终授权/跳转地址 |
| authUrl | String | 最终授权/跳转地址(兼容字段) |
| jumpUrl | String | 最终授权/跳转地址(兼容字段) |
响应示例
json
{
"code": 0,
"msg": "成功",
"data": {
"url": "https://institution.example.com/auth?token=xxx"
}
}注意事项
- 该接口由万利通在用户点击产品时实时调用。
- 机构应返回最终授权 URL。
- 若结算依赖回调,机构后续仍需回调万利通。
agreementUrl仅用于协议展示,authUrl仅用于回调,二者不可混用。