API Reference
English

名单上报

功能说明

借助名单上报接口,可以自动应用TrustDecision全球联防联控的扩展分析模型,根据客户上报的名单做自动回溯分析、特征挖掘、模式匹配、关联传播,从而加快或自动完成策略模型的定制开发,提升贷前决策的精准度和召回率,从而提高贷前决策的准确性和全面性

API 方式

Base URL

新加坡站点:https://sg-feedback.apitd.net/credit/fraud (非印尼合作方接入)
印尼站点:https://id-feedback.apitd.net/credit/fraud(仅支持印尼合作方接入)

API

URLHTTP 请求方式入参格式输出格式字符集Charset
api-base-url?partner_code=xxx&partner_key=xxxPOSTapplication/jsonjsonUTF-8

认证参数

字段类型含义建议备注
partner_codeString合作方标识必须由TD分配
partner_keyString合作方密钥必须由TD分配

请求参数

字段

类型

含义

建议

备注

data_type

String

上报数据类别

必须

枚举值
1、postloandata

blacklist

Array

扩展信息

条件必须

一次最多传50条数据

postloandata数据对象

字段

类型

含义

建议

备注

approval_result

String

审批结果

建议

枚举值:
approval_rejection:审批拒绝
approval_pass:审批通过
others:其他

type

String

拒绝原因

建议

枚举值:
white_list:正常还款
actual_overdue:事实逾期
black_list:内部/外部黑名单
fraud_risk 欺诈风险
related_risk:关联风险
credit_report_issues:征信问题
insufficient_credit_limit:额度不足
others:其他

installment_period_unit

String

期数单位

建议

枚举值:
weeks:周
months:月

installment

int

产品期数

建议

begin_overdue_installment

int

第几期开始逾期

建议

overdue_statue

String

当前是否逾期

建议

枚举值:
Y:是
N:否

current_installment

int

截至当前期数

建议

从授信距今月份数

max_overdue_day

int

历史最大逾期天数

建议

从授信距今最大逾期的天数

overdue_start_time

String

逾期开始日期

建议

建议格式 YYYY-MM-DD

apply_time

String

申请日期

建议

建议格式 YYYY-MM-DDTHH:mm:ss.sssZ ,例如 2021-10-12T14:20:50.521+07:00

customer_type

String

客户类型

建议

枚举:
new: 新客
existing: 老客

name

String

姓名

建议

phone

phone

手机/电话

建议

id

id

证件信息

建议

sequence_id

String

AFD接口响应参数

建议

同盾AFD接口响应参数,之前调用的seqid(建议提供AFD 授信/用信事件的sequence_id)

gaid

String

谷歌广告id

建议

device_id

String

TD设备指纹返回的设备ID

建议

请求示例

{
    "data_type": "postloandata",
    "postloandata": [
        {
            "approval_result": "approval_rejection",
            "type": "black_list",
            "installment_period_unit": "weeks",
            "installment": 1,
            "begin_overdue_installment": 1,
            "overdue_statue": "Y",
            "current_installment": 1,
            "max_overdue_day": 1,
            "overdue_start_time": "2024-10-01",
            "apply_time": "2024-10-12T14:20:50.521+07:00",
            "customer_type": "new",
            "name": "magaoyun",
            "phone": {
                "country_code": "62",
                "phone_number": "0812***67898"
            },
            "id": {
                "id_country": "ID",
                "id_type": "identity_card",
                "id_number": "3273*****3950002",
                "valid_date": "2039-10-01"
            },
            "sequence_id": "123",
            "gaid": "f65****c-**21**f7-b**1-06*****baa",
            "device_id": "123456"
        }
    ]
}

响应参数

字段类型含义建议备注
codeIntegerAPI 状态码必须返回的状态码,详见后面 API 状态码部分
messageString状态信息必须接口状态码对应的具体原因说明
sequence_idString响应唯一码必须用于跟踪每次请求记录的唯一

API 状态码

Code描述
200成功
11000{字段名}入参错误
11001格式错误
11002入参解析失败

响应示例

{
    "code": 200,
    "message": "Success",
    "sequence_id": "1719475866546734I316769A79067600"
}