本文笔者将从需求目的、需求描述、数据需求分析等方面来推出省呗撞库联登渠道的需求文档，enjoy~

一、需求目的

1. 需求背景

为配合新产品****的推广，新增省呗撞库联登渠道。因为业务同事市场推广策略会有较频繁的变更，所以需要修改拉新撞库规则，其中主要包括新增撞库准入条件的配置化需求。

2. 上线联登效果预估

引流动用用户量：日均***，动用成本：***（联登合作是对方上线必要条件）。

二、需求描述

1. 整体流程图

2. 撞库准入流程

1）省呗发起用户信息校验

用户点击****的省呗广告进行申请，省呗向市场推广系统发起用户信息校验请求，校验接口传递MD5后的手机号，并附带签名，签名规则详见省呗联合注册接口文档v1.4的【5.】。

2）判断用户类型

市场推广收到校验请求后进入撞库准入流程，根据传入的MD5手机号，查询该用户是否在***动用过：未动用过的话撞库准入通过（默认未动用过的用户撞库准入通过，可更改配置为不通过），动用过的话进入用户风控等级验证流程。

3）用户风控等级验证

若用户的风控等级为A、B、C、D、E、Z，则验证结果为通过（默认全部风控等级的用户结果都为通过，可单独更改每一种风控等级的用户配置为不通过）；若用户的风控等级为空或获取失败，则验证结果为通过。

4）配置需求

***未动用过的用户准入结果可配置：在***未动用过的用户撞库准入结果可配置为通过或不通过（默认通过）。

用户风控等级验证结果可配置：在***动用过的用户，每一级的用户风控等级的撞库准入结果都可单独配置为通过或不通过（默认通过），如下表：

5）撞库准入结果

撞库准入不通过：市场推广的校验接口回值如下表：

撞库准入通过：市场推广进入撞库处理流程。

3. 撞库处理流程

1）动用过****的用户判断

用户信息通过撞库准入后，市场推广会进行撞库处理，查询判断用户是否在****动用过。如果从未动用过，则进入风控4个黑名单库验证流程；如果动用过，则进一步判断该用户上一次在****结清的时间。

2）用户上一次结清时间判断

如果距离用户上一次在****结清的时间不超过30天(天数可配置)或尚未结清，则市场推广得到撞库结果为老用户；如果距离用户上一次结清超过了30天(天数可配置)，则同样进入风控4个黑名单库验证流程。

3）风控4个黑名单库验证

进入黑名单库验证流程的用户包括：从未在****动用过的用户和上一次在****结清的时间超过30天(天数可配置)的用户。市场推广调用风控接口判断是否命中风控4个黑名单，若有任何1个命中，则市场推广得到撞库结果为不通过；若未命中任何1个名单库，则市场推广得到撞库结果为新用户、进入联合注册流程。

4）市场推广校验接口回值

撞库结果为老用户，接口回值如下表：

撞库结果为不通过，接口回值如下表：

撞库结果为新用户，接口回值如下表：

4. 联合注册流程

1）省呗发起联合注册请求

用户在省呗点击广告位发起注册申请后，经过市场推广校验接口判断，如果该用户不是****的老用户（即回值code不为1），省呗就会立即调用注册接口，向市场推广发起联合注册请求。

注册接口发送加密后的用户数据，并附带签名。加密规则及签名规则详见省呗联合注册接口文档v1.4的【4.】及【5.】。

接口参数定义如下表：

2）判断用户是否已注册

市场推广收到注册请求后，调用会员中心接口查询用户在****是否已注册，若已注册，则返回“已注册”（注册接口code返回1）。

若未在****注册，则调用会员中心接口进行注册，注册成功返回“注册成功”（注册接口code返回0），若注册失败则返回“注册失败”（注册接口返回2）。

3）市场推广注册接口回值

已注册：

新用户注册成功：

新用户注册失败：

跳转URL说明省呗接收到市场推广返回的注册结果，跳转到对应的下载URL地址，标志着整个流程撞库联登流程的结束。

通过省呗联合注册渠道注册的用户，用户再次点击时，不会再调用****撞库注册接口，而向用户直接展示****提供的老用户落地页URL1。

三、数据需求

1. 撞库联登数据表头

• 渠道号
• 产品ID
• 明文手机号
• MD5手机号
• 撞库结果码
• 撞库结果说明
• 撞库返回时间戳
• 注册结果码
• 注册结果说明
• 注册返回时间戳

2. 撞库结果说明

• 撞库准入不通过，用户在***未动用；
• 撞库准入不通过，用户的风控等级为“X”被拒绝；
• 撞库处理不通过，撞库结果为老用户；
• 撞库处理不通过，未动用的用户命中了风控黑名单；
• 撞库处理不通过，已动用的沉默被唤醒用户命中了风控黑名单；
• 撞库处理通过，未动用的用户未命中风控黑名单；
• 撞库处理通过，已动用的沉默被唤醒用户未命中风控黑名单。

3. 注册结果说明

• 老用户不可注册
• 注册成功
• 注册失败

4. 补充

出于节省资源考虑，市场推广只记录最近2周的撞库联登数据，超过2周的数据定期删除。

四、其他说明

1. 风控、会员中心接口调用失败需重新发出请求，连续3次失败报警通知到相关责任人（开发，测试，产品，运营）。
2. 调用风控接口查询用户的风控等级，每天的调用上限为4万人，预估后期要支持每天40万撞库查询量。
3. 测试密钥用**********，与省呗测试联调过程中需要提供校验接口url，注册接口url。
4. 产品会提供邮箱给省呗接收线上密钥，上生产时会提供密钥给开发测试，同时需要准备好线上校验接口url，注册接口url，下载url（新、老用户）。
5. 接口约定、加密、签名、接口详细定义详见附件《省呗联合注册接口文档v1.4》。

本文由 @鱼缸外的鱼 原创发布于人人都是产品经理。未经许可，禁止转载

题图来自 Unsplash ，基于 CC0 协议