产品文档 / 流量接入 / 开发指引

开发指引

接入配置

配置项提供方式或配置值
channelCode / Aes_key / Md5_key合作方在微信群提供接收邮箱,自牧通过邮件发送。
测试域名https://qapi-3test.tjzimu.com
生产域名https://qapi.tjzimu.com

整体业务流程和接口调用顺序说明

以下按用户、合作渠道和自牧三个参与方,说明各阶段的系统交互顺序。接口名称可直接进入对应 API 详情。

1授信获取额度

  1. 用户合作渠道

    发起额度申请用户在合作渠道提交信息并申请便荔卡包购物额度。

  2. 合作渠道自牧

    预审进行准入判断。

  3. 合作渠道自牧

    获取静态协议获取协议模板,用于向用户展示。

  4. 合作渠道自牧

    提交授信申请提交用户的授信申请。

  5. 合作渠道自牧

    查询授信状态查询授信结果和额度。

  6. 自牧合作渠道

    授信结果推送自牧主动推送授信结果。

  7. 合作渠道用户

    展示授信额度渠道向用户展示授信结果和可用额度。

2购物用信

  1. 合作渠道自牧

    查询额度查询用户额度状态,额度有效时可发起购物用信。

  2. 合作渠道自牧

    获取商城 URL获取便荔卡包商城首页的 URL。

  3. 合作渠道用户

    引导用户购物渠道引导用户进入便荔卡包商城。

  4. 用户自牧

    商城购物下单成功用户在便荔卡包商城购物下单成功。

  5. 自牧合作渠道

    订单推送用户在商城购物下单成功后,将订单借据信息推送给渠道。

  6. 自牧合作渠道

    订单状态推送用户退货或结清时,主动推送订单状态变化。

3查账还款

  1. 合作渠道自牧

    还款计划(合并)查询用户当月总待还金额。

  2. 合作渠道自牧

    还款计划(明细)查询用户每笔购物借据的待还信息。

  3. 合作渠道自牧

    获取商城 URL获取便荔卡包首页 URL,页面将继续引导用户还款。

  4. 合作渠道用户

    引导用户还款渠道展示还款信息并引导用户进入便荔卡包。

  5. 用户自牧

    查账并还款用户在便荔卡包页面查看账单并完成还款。

4提额

  1. 自牧

    便荔卡包提额便荔卡包为符合条件的用户提升额度。

  2. 自牧合作渠道

    提额推送提额完成后,将提额信息推送给合作渠道。

  3. 合作渠道用户

    提额营销展示渠道展示提额信息,吸引用户进入便荔卡包购物。

5渠道侧进行授信阶段协议的个人签章(可选)

工信部要求个人签章必须进行人脸认证。由于授信阶段在合作方完成,相关授信合同需要借助合作渠道的签章能力完成签署。渠道提交授信申请后,自牧先完成进件校验;校验通过后进入 145 审批中。业务审批阶段完成待签协议生成、渠道签章通知、签章文件回收与校验,校验通过后继续风控审批,终态为 150 审批通过或 151 审批拒绝。

  1. 合作渠道自牧

    提交授信申请渠道按原授信申请接口提交申请;自牧进件校验通过后,授信查询返回 145 审批中。

  2. 自牧合作渠道

    待签协议推送自牧向渠道推送待签协议,渠道据此完成用户个人电子签章。

  3. 合作渠道

    处理待签协议渠道下载待签 PDF,在指定签章位置完成人脸认证和用户个人电子签章。

  4. 合作渠道自牧

    已签章协议上传渠道完成个人电子签章后,回传签章结果和已签章协议。

  5. 自牧合作渠道

    签章结果查询签章结果回传失败或异常时,自牧通过该接口查询签章处理结果。

  6. 自牧

    签章中通知或查询结果为签章中时,授信查询保持 145 审批中,暂不进入风控审批。

  7. 自牧合作渠道

    签章失败不进入内部授信,按约定重新发起待签协议推送、安排人工补签或终止流程。

  8. 自牧

    签章校验通过已签章文件内容、用户信息和验签均通过后,进入内部风控审批;授信查询继续保持 145 审批中。

  9. 自牧合作渠道

    返回授信终态内部授信完成后,渠道通过授信结果查询授信结果推送获得 150 审批通过或 151 审批拒绝。

微信小程序加白

合作渠道方有小程序流量,且需要在小程序内访问便荔商城或便荔卡包 H5 页面时,需要先完成以下加白配置。

  1. 合作渠道

    配置小程序域名白名单合作渠道方将下列域名加入小程序业务域名白名单。域名较多,可点击展开并逐条复制。

    展开域名列表
    • https://nectar.tjzimu.com/
    • https://m.tjzimu.com/
    • https://sc.tjzimu.com/
    • https://pay.tjzimu.com/
    • https://vcc.tjzimu.com/
    • https://vcc-spider.tjzimu.com/
    • https://h5-auth.tjzimu.com/
    • https://h5.tjzimu.com/
    • https://appsync.lkbang.net/
    • https://mall.tjzimu.com/
    • https://kefu.tjzimu.com/
    • https://mall.zkshiju.com/
    • https://appbackend.xyqb.com
    • https://authtx.tjzimu.com
    • https://saas.q-gp.com/
    • https://quantum-h5.q-gp.com/
    • https://kefu.q-gp.com/
    • https://page.q-gp.com/
    • https://vip-customer.q-gp.com/
    • https://mall.q-gp.com/
  2. 合作渠道自牧

    提供小程序校验文件合作渠道方提供小程序校验文件,由自牧加入相关域名根目录。

搜索功能即将开放

目前可以通过左侧目录浏览文档。