首次授信

接口说明

首次授信通过 H5 页面实现，无需调用 API 接口。第三方系统通过获取 H5 跳转链接，引导用户在粒粒通 H5 页面完成授信资料填写和提交。

授信流程

1. 第三方调用 /api/member/login 获取 H5 跳转链接
   ↓
2. 用户访问跳转链接，自动登录粒粒通系统
   ↓
3. 跳转到授信页面（/credit）
   ↓
4. 用户在 H5 页面填写授信资料并提交
   ↓
5. 系统进行授信审批
   ↓
6. 审批完成后，通过回调通知授信结果
   ↓
7. 用户操作完成后，跳转回第三方指定的 redirectUrl

调用示例

1. 获取 H5 跳转链接

调用 /api/member/login 接口获取授信页面跳转链接：

// 请求
{
  "memberId": 1000001,
  "destCode": "CREDIT",
  "redirectUrl": "https://example.com/credit/callback"
}

// 响应
{
  "code": "0000",
  "message": "成功",
  "data": {
    "pt": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "url": "https://pre.lilitop.com/h5/login/portal?pt=a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6&redirect=%2Fcredit&callback=https%3A%2F%2Fexample.com%2Fcredit%2Fcallback"
  }
}

2. 跳转到授信页面

// 前端代码示例
const response = await fetch('/api/member/login', {
  method: 'POST',
  body: JSON.stringify({
    memberId: 1000001,
    destCode: 'CREDIT',
    redirectUrl: 'https://example.com/credit/callback'
  })
});

const result = await response.json();
if (result.code === '0000') {
  // 跳转到授信页面
  window.location.href = result.data.url;
}

3. 接收回调通知

授信审批完成后，系统会向第三方配置的回调地址发送授信结果通知。详见 授信结果通知 文档。

相关文档

• 获取H5跳转链接 - 详细的接口说明和参数
• 授信结果通知 - 授信审批结果回调通知
• 查询授信结果 - 主动查询授信结果

注意事项

1. Portal Token 有效期：获取的 pt 有效期为 60 秒，请及时使用
2. 一次性使用：pt 使用后立即失效，不可重复使用
3. 回调地址配置：请提前配置好授信结果回调地址
4. redirectUrl 跳转：用户完成授信操作后会跳转到指定的 redirectUrl
5. 移动端适配：H5 页面已适配移动端浏览器