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_typeString上报数据类别必须枚举值
1、postloandata
blacklistArray扩展信息条件必须一次最多传50条数据

postloandata数据对象

字段类型含义建议备注
approval_resultString审批结果建议枚举值:
approval_rejection:审批拒绝
approval_pass:审批通过
others:其他
typeString拒绝原因建议枚举值:
white_list:正常还款
actual_overdue:事实逾期
black_list:内部/外部黑名单
fraud_risk 欺诈风险
related_risk:关联风险
credit_report_issues:征信问题
insufficient_credit_limit:额度不足
others:其他
installment_period_unitString期数单位建议枚举值:
weeks:周
months:月
installmentint产品期数建议
begin_overdue_installmentint第几期开始逾期建议
overdue_statueString当前是否逾期建议枚举值:
Y:是
N:否
current_installmentint截至当前期数建议从授信距今月份数
max_overdue_dayint历史最大逾期天数建议从授信距今最大逾期的天数
overdue_start_timeString逾期开始日期建议建议格式 YYYY-MM-DD
apply_timeString申请日期建议建议格式 YYYY-MM-DDTHH:mm:ss.sssZ ,例如 2021-10-12T14:20:50.521+07:00
customer_typeString客户类型建议枚举:
new: 新客
existing: 老客
nameString姓名建议
phonephone手机/电话建议
idid证件信息建议
sequence_idStringAFD接口响应参数建议同盾AFD接口响应参数,之前调用的seqid(建议提供AFD 授信/用信事件的sequence_id)
gaidString谷歌广告id建议
device_idStringTD设备指纹返回的设备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"
}