半流程进件返 - 进件接口

接口信息

需对方提供

• 地址：合作机构提供接口地址
• 请求方式：POST
• 接口说明：用户在万利通产品页点击产品后，万利通调用机构正式进件接口

请求参数

在撞库接口参数基础上，机构需支持接收以下核心字段：

参数	类型	必填	说明
userId	String	否	撞库阶段返回的用户标识
applyNo	String	否	撞库阶段返回的机构申请号
mobile	String	是	明文手机号
authUrl	String	是	万利通回调地址
agreementUrl	String	否	万利通提供的个人信息授权协议链接，协议内容包含平台与合作机构双方公司名、产品名

说明：

• userId 和 applyNo 至少保留一个
• 其他用户资质字段与撞库接口一致
• agreementUrl 用于协议展示，authUrl 用于机构回调

响应参数

参数	类型	说明
code	Integer	0-成功
msg	String	响应消息
data.url	String	最终授权/跳转地址

响应示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "url": "https://institution.example.com/auth?token=xxx"
  }
}

注意事项

1. 该接口由万利通在用户点击产品时实时调用
2. 机构应返回最终授权 URL
3. 若结算依赖回调，机构后续仍需回调万利通
4. agreementUrl 不代表回调地址，不能替代 authUrl