身份验真详情版-印尼

本产品主要用于用户的二要素核验，并补充部分用户信息。

API 方式

Base URL

印尼节点：https://id.apitd.net/verification/kyc/idverifydetail/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	API 状态码	Integer	必须
message	状态信息	String	必须	在 API 异常状态下会输出具体的异常原因
sequence_id	响应唯一码	String	必须	用于跟踪每次请求记录的唯一标识
result	核验结果	String	必须	枚举值：通过：pass（姓名和身份证对应上）不通过：fail 无纪录：no record
further_info	补充信息	Json	条件必须，当result=pass的时候	包含以字段见下表

further_info包含字段

字段	含义	类型	示例
id_number	身份证号	String	1101010107730074
name	姓名	String	ASNAWI ADEN
birth_place	出生地区	String	BAKONGAN
birth_date	出生日期	String	1973-07-01 00:00:00
religion	宗教	String	ISLAM
gender	性别	String	Male
province	户口所在省	String	ACEH
city	户口所在城市	String	KAB. ACEH SELATAN
district	户口所在县	String	Bakongan
village	户口所在村	String	Padang Beurahan
office_type	工作地区所在编码	String	0105

API状态码

code	Message	含义	是否收费
200	success	成功	是
301	Service not purchased	服务未购买	否
302	Service has been suspend	服务已被禁⽤	否
303	Not enough balance	流量不足	否
304	Service expired	服务已过期	否
305	Daily maximum volume reached	日流量已封顶	否
600	Service Temporarily Unavailable	服务超过限制	否
11350	Internal error	系统错误	否
11301	{parameter} empty	{参数}为空	否
11304	The country partner located is not open	国家不支持	否
11340	{parameter} error	{参数}错误	否

响应示例

业务成功示例

{   
 "code": 200,
 "message": "success",
 "sequence_id": "1648777165770866F82AC7F326307055",
 "result": "pass", 
 "further_info":
  {
    "id_number":"1101010107730074",
    "name":"ASNAWI ADEN",
    "birth_place":"BAKONGAN",
    "birth_date":"1973-07-01 00:00:00",
    "religion":"ISLAM",
    "gender":"Male",
    "province":"ACEH",
    "city":"KAB. ACEH SELATAN",
    "district":"Bakongan",
    "village":"Padang Beurahan",
    "office_type":"0105"
  }
}

业务失败示例

{
    "code":11340,
    "sequence_id":"170427842997****I3167369D6187177",
    "message":"phone_number error"
}