Skip to content

进件接口

接口信息

需对方提供

  • 地址:合作机构提供接口地址
  • 请求方式:POST
  • 接口说明:万利通调用机构进件接口,传入完整用户信息(含明文手机号)

请求参数

在撞库接口参数基础上增加以下字段:

参数类型必填说明
userIdString撞库阶段返回的用户标识
applyNoString撞库阶段返回的机构申请号
mobileString明文手机号
agreementUrlString万利通提供的个人信息授权协议链接,协议内容包含平台与合作机构双方公司名、产品名

说明:

  • userIdapplyNo 至少保留一个
  • 其他字段与撞库接口保持一致
  • authUrl 仍表示机构回调万利通地址,不代表授权协议链接

响应参数

参数类型说明
codeInteger0-成功
msgString响应消息
dataObject响应数据

data 字段

参数类型说明
urlString最终授权/跳转地址
authUrlString最终授权/跳转地址(兼容字段)
jumpUrlString最终授权/跳转地址(兼容字段)

响应示例

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

注意事项

  1. 该接口由万利通在用户点击产品时实时调用。
  2. 机构应返回最终授权 URL。
  3. 若结算依赖回调,机构后续仍需回调万利通。
  4. agreementUrl 仅用于协议展示,authUrl 仅用于回调,二者不可混用。