资源中心数据反馈说明
您可以点击纯净版进行查看

流程概况

在使用芝麻信用的信用服务后,商户须及时通过芝麻信用开放平台数据反馈接口,按照相应模板反馈数据。

商家数据反馈包含 5 个步骤,如下图:

各步骤详情如下:

  1. 确认反馈模板:商户确认反馈字段,包括内容及格式;
  2. 反馈接口联调:基于反馈模板加工测试文件,通过获取到的接口测试 type_id 将其上传,实现接口联调。联调完成后,获取芝麻提供的正式 type_id
  3. 正式反馈数据加工:商户基于反馈模板进行正式反馈数据加工,并组装成 JSON 文件;
  4. 推送正式反馈数据:使用正式 type_id 推送正式反馈数据,并配合芝麻完成数据质量校验;
  5. 反馈数据应用:质量校验通过后,芝麻将反馈数据进行信用奖惩等应用。

若对数据反馈流程存疑,请联系芝麻信用商户服务进行咨询。

接入步骤

总共五步,如下所示。

第一步:确认反馈模版

请根据芝麻信用通知为准(依据协议中的约定:反馈起始时间、反馈频率及实际字段,具体以芝麻信用通知或在芝麻信用平台公告的行业反馈标准为准),我们将在商户在正式调用芝麻分,行业关注名单一段时间后,数据反馈模板将发送至商户的数据反馈接口人邮箱。商户也可以联系芝麻信用商户服务获取反馈模板及相关文档。

第二步:反馈接口联调

商户数据反馈接口人邮箱同时会收到测试 type_id、反馈接口文档链接和模板下载地址。商户须根据接口文档说明,通过反馈接口 zhima.data.batch.feedback (批量数据反馈服务),以测试 type_id 为标识,进行接口联调。

数据反馈测试要点如下:

测试文件格式

文件名以.json结尾,不推荐使用中文;文件内容为json格式,最外层是”records”字段,该字段的值是一个数组,包含一条或多条反馈记录。

测试文件大小

小于10K

测试反馈字段

使用反馈模板字段,确保无字段缺失;无值字段须置空,例如【"memo":""】

测试文件编码

确保 JSON 文件的编码和服务 SDK 中设定的编码一致,否则文件解析将出现乱码。例如 JSON 文件采用 GBK 编码,则 req.setFileCharset("GBK")

反馈字段格式

严格按照反馈模板对字段格式的要求,确保文件解析正确。

注:type_id 是商户推送反馈数据的特有标识。测试反馈和正式反馈(见第三、四步)需分别使用测试 type_id 和正式 type_id

第三步:正式反馈数据加工

一般在测试成功后 2-3 个工作日内,数据反馈接口人会收到正式 type_id 邮件。商家根据反馈模板的字段规范和示例,加工正式反馈数据。

数据加工的要点如下:

节点

在用户产生申请流水、产生实际订单、流水/订单状态更新(包括不限于变更、结清、付款等状态变化)、用户违约等时间点的次日进行数据反馈

反馈内容

反馈内容具体见数据反馈模板的字段说明

数据格式

1. 如果日期是精确到秒的,格式为2015-08-30 12:59:58
2. 如果日期是精确到天的,格式为2015-01-01
3. 如果日期是精确到月的,格式为2015-01
4. 金额单位统一为元
5. 小数格式且位数超过2位的,保留2位小数
6. 无值字段置空反馈,如【"memo":""】
7. 证件号码为身份证号码时,最后一位若为字母(罗马数字10),则为大写X

8. 使用模板中的字段编码,统一使用小写字母

第四步:推送正式反馈数据

将反馈数据转换成 JSON 文件,以正式 type_id 为标识,使用 zhima.data.batch.feedback 接口, T+1 按日持续反馈。加工完成的单个数据文件不应超过 50M;超过 50M 的数据文件,需拆分为多个独立的 JSON 文件,确保单文件小于 50M。

JSON 样例如下:

{
    "records": [{
        "user_name": "张三",
        "user_credentials_type": "0",
        "user_credentials_no": "33092219890726331X",
        "order_no": "30032015073000055125",
        "biz_type": "1",
        "order_status": "04",
        "create_amt": "19000.00",
        "pay_month": "7",
        "gmt_ovd_date": "2015-05-01",
        "overdue_days": "3",
        "overdue_amt": "1800.79",
        "gmt_pay": "",
        "memo": ""
    }, {
        "user_name": "李四",
        "user_credentials_type": "0",
        "user_credentials_no": "330922197907263315",
        "order_no": "30032015073000055126",
        "biz_type": "1",
        "order_status": "04",
        "create_amt": "29000.00",
        "pay_month": "12",
        "gmt_ovd_date": "2015-05-01",
        "overdue_days": "",
        "overdue_amt": "",
        "gmt_pay": "2015-04-30",
        "memo": ""
    }]
}

测试和正式反馈数据的对象、逻辑以及推送的对比如下:

 

反馈接口联调阶段

正式数据反馈阶段

反馈接口

zhima.data.batch.feedback

推送数据的标识

测试type_id

正式type_id

文件格式

反馈数据的文件名以.json结尾,不推荐使用中文;文件内容为json格式,最外层是”records”字段,该字段的值是一个数组,包含要反馈的一条或多条记录

文件大小

需小于10K

json单文件不超过50M,对于超过50M的数据文件,需要拆分为多个独立的json文件进行反馈,确保单文件小于50M

反馈对象

 

所有调用芝麻信用服务且产生业务行为的用户数据

反馈频率

 

T+1按日持续反馈

反馈节点

 

在用户产生申请流水、产生实际订单、流水/订单状态更新(包括不限于变更、结清、付款等状态变化)以及用户违约等时间点的次日进行数据反馈

反馈内容

见反馈模板的字段说明

数据格式

1. 如果日期精确到秒,格式为2015-08-30 12:59:58
2. 如果日期精确到天,格式为2015-01-01
3. 如果日期精确到月,格式为2015-01
4. 金额单位统一为元
5. 小数格式且位数超过2位的,保留2位小数
6. 无值字段置空反馈,如【"memo":""】
7. 证件号码为身份证号码时,最后一位若为字母(罗马数字10),则为大写X

8. 使用模板中的字段编码,统一使用小写字母

通过该阶段标准

数据格式正确

1. 保证数据准确真实,数据格式正确,无字段间的逻辑矛盾。(数据的格式、字段间逻辑要求见数据反馈模板);

2. 反馈业务全流程全场景数据且按时更新。例如使用贷款版的商户,需反馈申请、放款、履约、违约等数据

正式推送的反馈数据将经过数据质量校验;对于质量有问题的数据,商户在接到通知后须及时修复。当数据质量达到校验标准后,芝麻将通知商户数据反馈接口人,并对数据进行应用(如:负面披露)。

数据质量校验对商家的要求如下:

  1. 保证数据准确真实,数据格式正确,无字段间的逻辑矛盾。(数据的格式、字段间逻辑要求见数据反馈模板);
  2. 反馈业务全流程全场景数据且按时更新。例如使用贷款版的商户,需反馈申请、放款、履约、违约等数据。

常见质量校验问题:

编码问题

json文件编码和 req.setFileCharset("")的不一致,导致文件解析出现乱码。例如json文件是GBK编码的,但是 req.setFileCharset("UTF-8"),编码不一致,会导致姓名等中文值字段内容乱码。

格式问题

无值字段未推送。例如memo字段无值,应该使用【"memo":""】来反馈数据。

字段格式不符合要求。例如姓名含有非法字符、金额字段小数超过两位、时间未使用模板中说明的格式、身份证格式不符合标准、身份证最后一位为罗马数字10时未使用大写X等。

逻辑问题

表示逾期与否的字段相互矛盾。例如当前逾期天数为0,但当前逾期金额非0;或者,当前逾期天数非0,但结清时间(gmt_pay)非空(表示已结清)。

唯一性问题。一笔订单的放款金额(create_amt)只有一个值,一笔订单的结清时间(gmt_pay)只有一个值,一笔订单只对应一个用户的信息等。

第五步:反馈数据应用

通过质量校验后,反馈数据将进入应用阶段。以负面披露为例,芝麻将与商户异议接口人进行负面和异议沟通,商户须提供异议支持。负面记录将披露在违约用户的芝麻信用 APP 端,影响用户的信用评估和其他信用服务,有助于违约用户的回款。

负面披露的用户触达路径如下:

接口介绍和技术文档

接口名称 zhima.data.batch.feedback点击跳转到技术文档
接口中文名称 批量数据反馈服务
接口描述信息 商户通过该接口把数据以json文件形式批量反馈给芝麻信用,接口最大支持50M的单文件,需要注意的是,在测试的时候请使用10k大小以内的文件对于超过50M的数据文件,需要拆分为多个独立的json文件进行反馈,确保单json文件小于50M。
  1. 流程概况
  2. 接入步骤
  3. 第一步:确认反馈模版
  4. 第二步:反馈接口联调
  5. 第三步:正式反馈数据加工
  6. 第四步:推送正式反馈数据
  7. 第五步:反馈数据应用
  8. 接口介绍和技术文档
onlineServer