万利通开放平台

Appearance

渠道接入说明 ​

适用范围 ​

本文档适用于调用万利通平台开放接口的渠道合作方。

接入前确认 ​

流程选择 ​

流程适用场景特点
半流程撞库返需要先授权再进件撞库阶段返回授权落地页
半流程进件返需要先收集完整资料再跳转撞库阶段仅返回产品信息和进件标识
API 全流程追求实时闭环处理撞库命中后直接进件并返回结果

1. 半流程撞库返 ​

mermaid
sequenceDiagram
    participant 合作方
    participant 万利通平台
    participant 用户

    合作方->>万利通平台: 1. 调用撞库接口
    万利通平台-->>合作方: 2. 返回 applyNo 与授权落地页
    合作方->>用户: 3. 引导进入授权页
    用户->>万利通平台: 4. 完成授权
    万利通平台-->>合作方: 5. 回调授权成功
    合作方->>万利通平台: 6. 调用进件接口
    万利通平台-->>合作方: 7. 返回进件结果

流程：

  1. 渠道合作方调用万利通撞库接口
  2. 万利通完成匹配并返回 applyNo 与授权落地页
  3. 用户进入授权页完成授权
  4. 万利通收到授权完成状态
  5. 万利通回调渠道方
  6. 渠道合作方再调用万利通进件接口
  7. 万利通完成正式进件并结算

接口入口：

2. 半流程进件返 ​

mermaid
sequenceDiagram
    participant 合作方
    participant 万利通平台
    participant 用户

    合作方->>万利通平台: 1. 调用撞库接口
    万利通平台-->>合作方: 2. 返回产品信息与进件标识
    用户->>合作方: 3. 点击展示产品
    合作方->>万利通平台: 4. 调用进件接口
    万利通平台-->>合作方: 5. 返回平台产品页
    合作方->>用户: 6. 打开平台产品页
    用户->>万利通平台: 7. 点击产品申请
    万利通平台-->>用户: 8. 返回最终跳转链接
    用户->>目标页面: 9. 完成后续操作
    万利通平台-->>合作方: 10. 回调成功状态

流程：

  1. 合作方调用万利通撞库接口
  2. 万利通完成匹配处理
  3. 万利通响应撞库成功，只返回产品信息和后续进件标识，不返回授权页面
  4. 用户点击合作方展示的产品后，合作方调用万利通进件接口
  5. 万利通接收用户完整资料，并返回平台产品页
  6. 用户进入万利通平台产品页，点击产品申请
  7. 万利通发起正式进件处理
  8. 万利通返回最终跳转 URL
  9. 用户进入目标页面完成后续操作
  10. 万利通收到成功状态后完成结算
  11. 万利通回调合作方成功

接口入口：

3. API 全流程 ​

mermaid
sequenceDiagram
    participant 合作方
    participant 万利通平台

    合作方->>万利通平台: 1. 调用撞库接口
    万利通平台-->>合作方: 2. 返回命中结果
    合作方->>万利通平台: 3. 调用进件接口
    万利通平台-->>合作方: 4. 返回进件成功与跳转结果

流程：

  1. 渠道合作方调用万利通撞库接口
  2. 万利通实时完成匹配处理
  3. 命中后立即响应渠道方撞库成功
  4. 渠道合作方调用万利通进件接口
  5. 万利通实时完成正式进件
  6. 进件成功后，万利通立即响应渠道方进件成功并完成结算

接口入口：

环境地址 ​

联调时平台提供

  • 测试：联调时平台提供
  • 生产：联调时平台提供

渠道信息 ​

联调时平台提供

  • channelCode：渠道编码
  • aesKey：AES密钥（16字节）

联调准备 ​

联调前需要确认以下信息：

  • 环境地址和可访问白名单
  • 渠道编码 channelCode
  • AES 密钥 aesKey
  • 使用的流程模式及对应回调要求

加密规范摘要 ​

  • 算法：AES/ECB/PKCS5Padding
  • 密钥长度：128 位（16 字节）
  • 输出格式：Base64

统一响应说明 ​

json
{
  "code": 0,
  "msg": "",
  "data": {}
}

不同流程下 data 字段结构不同，详见对应流程页。

通用错误码 ​

code说明
0成功
400请求参数错误
500服务器内部错误