开发指引
接入配置
| 配置项 | 提供方式或配置值 |
|---|---|
channelCode / Aes_key / Md5_key | 合作方在微信群提供接收邮箱,自牧通过邮件发送。 |
| 测试域名 | https://qapi-3test.tjzimu.com |
| 生产域名 | https://qapi.tjzimu.com |
整体业务流程和接口调用顺序说明
以下按用户、合作渠道和自牧三个参与方,说明各阶段的系统交互顺序。接口名称可直接进入对应 API 详情。
1授信获取额度
2购物用信
3查账还款
4提额
- 自牧
便荔卡包提额便荔卡包为符合条件的用户提升额度。
- 自牧→合作渠道
提额推送提额完成后,将提额信息推送给合作渠道。
- 合作渠道→用户
提额营销展示渠道展示提额信息,吸引用户进入便荔卡包购物。
5渠道侧进行授信阶段协议的个人签章(可选)
工信部要求个人签章必须进行人脸认证。由于授信阶段在合作方完成,相关授信合同需要借助合作渠道的签章能力完成签署。渠道提交授信申请后,自牧先完成进件校验;校验通过后进入 145 审批中。业务审批阶段完成待签协议生成、渠道签章通知、签章文件回收与校验,校验通过后继续风控审批,终态为 150 审批通过或 151 审批拒绝。
- 合作渠道→自牧
提交授信申请渠道按原授信申请接口提交申请;自牧进件校验通过后,授信查询返回 145 审批中。
- 自牧→合作渠道
待签协议推送自牧向渠道推送待签协议,渠道据此完成用户个人电子签章。
- 合作渠道
处理待签协议渠道下载待签 PDF,在指定签章位置完成人脸认证和用户个人电子签章。
- 合作渠道→自牧
已签章协议上传渠道完成个人电子签章后,回传签章结果和已签章协议。
- 自牧→合作渠道
签章结果查询签章结果回传失败或异常时,自牧通过该接口查询签章处理结果。
- 自牧
签章中通知或查询结果为签章中时,授信查询保持 145 审批中,暂不进入风控审批。
- 自牧→合作渠道
签章失败不进入内部授信,按约定重新发起待签协议推送、安排人工补签或终止流程。
- 自牧
签章校验通过已签章文件内容、用户信息和验签均通过后,进入内部风控审批;授信查询继续保持 145 审批中。
- 自牧→合作渠道
微信小程序加白
合作渠道方有小程序流量,且需要在小程序内访问便荔商城或便荔卡包 H5 页面时,需要先完成以下加白配置。
- 合作渠道
配置小程序域名白名单合作渠道方将下列域名加入小程序业务域名白名单。域名较多,可点击展开并逐条复制。
展开域名列表
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.comhttps://authtx.tjzimu.comhttps://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/
- 合作渠道→自牧
提供小程序校验文件合作渠道方提供小程序校验文件,由自牧加入相关域名根目录。
下一步查看 API 列表 →