身份验真详情版-印尼

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

API 方式

Base URL

API

URL请求方式Content-Type输出格式字符集
api-base-url?partner_code=xxx&partner_key=xxxPOSTapplication/jsonJSONUTF-8

认证参数

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

请求参数

字段类型含义建议备注
id_numberString身份证件 ID 号码必须ID number
id_typeString身份证件 ID 类型必须印尼-枚举值: KTP
phone_numberString手机号 / 电话号码选填08开头10到13位,样例:081234567890
nameString姓名必须
countryString国家必须国家,必填. 两位国家码,符合 ISO 3166 标准。目前支持:印尼(ID)

请求示例

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

响应参数

字段含义类型建议备注
codeAPI 状态码Integer必须
message状态信息String必须在 API 异常状态下会输出具体的异常原因
sequence_id响应唯一码String必须用于跟踪每次请求记录的唯一标识
result核验结果String必须枚举值:
通过:pass(姓名和身份证对应上)
不通过:fail
无纪录:no record
further_info补充信息Json条件必须,当result=pass的时候包含以字段见下表
further_info包含字段
字段含义类型示例
id_number身份证号String1101010107730074
name姓名StringASNAWI ADEN
birth_place出生地区StringBAKONGAN
birth_date出生日期String1973-07-01 00:00:00
religion宗教StringISLAM
gender性别StringMale
province户口所在省StringACEH
city户口所在城市StringKAB. ACEH SELATAN
district户口所在县StringBakongan
village户口所在村StringPadang Beurahan
office_type工作地区所在编码String0105

API状态码

codeMessage含义是否收费
200success成功
301Service not purchased服务未购买
302Service has been suspend服务已被禁⽤
303Not enough balance流量不足
304Service expired服务已过期
305Daily maximum volume reached日流量已封顶
600Service Temporarily Unavailable服务超过限制
11350Internal error系统错误
11301{parameter} empty{参数}为空
11304The 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"
}