印尼家庭信息核验

本产品适用于印尼家庭信息的核验。

API 方式

Base URL

印尼节点：https://id-credit.apitd.net/verification/kyc/familyinsights/v1

API

URL	请求方式	Content-Type	输出格式	字符集
api-base-url?partner_code=xxx&partner_key=xxx	POST	application/json	JSON	UTF-8

认证参数

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

请求参数

字段	类型	含义	建议	备注
id_number	String	身份证件 ID 号码	必须	ID number
id_type	String	身份证件 ID 类型	必须	印尼-枚举值： KTP
phone_number	String	手机号 / 电话号码	必须	08开头10到13位，样例：081234567890
name	String	姓名	必须
country	String	国家	必须	国家，必填. 两位国家码，符合 ISO 3166 标准。目前支持：印尼(ID)

请求示例

{
    "country":"ID",
    "phone_number":"081234567890",
    "id_type":"KTP",
    "id_number":"3310225629467",
    "name":"Joe"
}

响应参数

字段	类型	含义	建议	备注
code	Integer	API	必须	在 API 异常状态下会输出具体的异常原因
message	String	状态信息	必须	在 API 异常状态下会输出具体的异常原因
sequence_id	String	响应唯一码	必须	用于跟踪每次请求记录的唯一标识
result	Object	核验结果	必须
personal_info	Object	个人情况	必须
family_type	String	家庭关系	必须	KEPALA KELUARGA
id_number	String	身份证号	必须	3526074107710317
kk	String	kk号	必须
birth_place	String	出生地区	必须	JAKARTA
name	String	姓名	必须	NEMMOH
birth_date	String	出生日期	必须	1973-07-01 00:00:00
religion	String	宗教	必须	ISLAM
gender	String	性别	必须	枚举值： Male Female
person_device_count_12months	Int	近12个月个人设备总数(去重)	必须	特殊值： -999: 库无记录 -888: 内部错误，请联系运营
family_basic_info	Object	家庭基本情况	必须
family_member_count	Int	家庭成员个数	必须
family_child_count	Int	未成年(18以下)子女个数	必须
family_elder_count	Int	60岁以上老人个数	必须
family_gaji_count	int	有工资收入的人数	必须
family_permi_count	int	有保费缴纳的人数	必须
family_device_count_12months	Int	近12个月家庭设备总数(去重)	必须	特殊值： -999: 库无记录 -888: 内部错误，请联系运营
total_income_12months	String	家庭年总收入	必须	见家庭年总收入金额等级表
avg_income_12months	String	家庭年平均收入	必须	见家庭年平均收入金额等级表
query_info	Object	查询信息	必须
family_query_times_1/2/3/6/12months	Int	所有家庭人员近[1/2/3/6/12]个月在我司被查询的总次数	必须	特殊值： -999: 库无记录 -888: 内部错误，请联系运营
customer_query_times_1/2/3/6/12months	Int	所有家庭人员近[1/2/3/6/12]个月在我司查询的客户数（去重）	必须	特殊值： -999: 库无记录 -888: 内部错误，请联系运营
family_query_count_1/2/3/6/12months	Int	所有家庭人员近[1/2/3/6/12]个月我司被查询的人数	必须	特殊值： -999: 库无记录 -888: 内部错误，请联系运营

家庭年总收入 total_revenue_12months 金额等级表

收入区间	收入等级
0	L0
(0, 1000000]	L1
(1000000, 2000000]	L2
(2000000,4000000]	L3
(4000000,6000000]	L4
(6000000,8000000]	L5
(8000000,10000000]	L6
(10000000,20000000]	L7
(20000000,50000000]	L8
(50000000, +)	L9

家庭年平均收入 avg_revenue_12months 金额等级表

平均收入区间	收入等级
0	L0
(0, 500000]	L1
(500000, 1000000]	L2
(1000000, 2000000]	L3
(2000000,3000000]	L4
(3000000,4000000]	L5
(4000000,5000000]	L6
(5000000,7000000]	L7
(7000000,9000000]	L8
(9000000, +)	L9

响应示例

{
    "result": {
        "query_info": {
            "family_query_count_12months": 2,
            "family_query_times_3months": 18,
            "family_query_count_1months": 2,
            "family_query_times_12months": 28,
            "family_query_count_6months": 2,
            "customer_query_times_12months": 2,
            "family_query_count_3months": 2,
            "family_query_times_6months": 26,
            "customer_query_times_1months": 1,
            "family_query_times_1months": 6,
            "customer_query_times_6months": 1,
            "customer_query_times_3months": 1
        },
        "personal_info": {
            "kk": "3203123412341234",
            "id_number": "3203123412341234",
            "gender": "Male",
            "birth_date": "1966-07-20 00:00:00",
            "name": "UJANG ABCDEFG",
            "birth_place": "CIANJUR",
            "family_type": "ANAK",
            "person_device_count_12months": 1,
            "religion": "ISLAM"
        },
        "family_basic_info": {
            "total_revenue_12months": "L0",
            "avg_revenue_12months": "L0",
            "family_gaji_count": 0,
            "family_permi_count": 3,
            "family_member_count": 6,
            "family_elder_count": 1,
            "family_child_count": 0,
            "family_device_count_12months": 2
        }
    },
    "code": 200,
    "sequence_id": "1717123412341234X3831234F1031234",
    "message": "Success"
}

API状态码

code	Message	含义	是否收费
200	Success	成功	是
300	Service not purchased or not effective	服务不可⽤	否
301	Service not purchased	服务未购买	否
302	Service has been suspend	服务已被禁⽤	否
303	Not enough balance	流量不足	否
304	Service expired	服务已过期	否
11350	Internal error	系统错误	否
11301	{parameter} empty	{参数}为空	否
11304	The country partner located is not open	国家不支持	否
11340	{parameter} error	{参数}错误	否
12701	No record	库无记录	否