身份验真-泰国

本产品用于验证用户身份证信息相关的真实性。

API 方式

Base URL

泰国节点：https://th.apitd.net/verification/kyc/idverify/v1
新加坡节点：https://sg.apitd.net/verification/kyc/idverify/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，例如：35704000xxxxx。
id_type	String	身份证件 ID 类型	必须	泰国-枚举值：national_id
phone_number	String	手机号 / 电话号码	强烈建议	泰国手机号，例如：0812345678
first_name	String	名	必须	例如：กรทพิ ย
last_name	String	姓	必须	例如：หน่อสวุ รรณ
country	String	国家	必须	国家，必填. 两位国家码，符合 ISO 3166 标准。仅支持泰国(TH)
birth_date	String	出生日期	必须	YYYY-MM-DD ，例如1993-01-08
laser_id	String	泰国国民卡背面的laser号码	必须	ME182xxxxx

请求示例

{
          "country":  "TH",
          "phone_number":  "0812345678",
          "id_type":  "national_id",
          "id_number":  "35704000xxxxx",
          "first_name":  "กรทพิ ย",
          "last_name":  "หน่อสวุ รรณ ",
          "birth_date":  "1993-01-08",
          "laser_id ":  "ME182xxxxx"
}

响应参数

字段	类型	含义	建议	备注
code	Integer	API 状态码	必须
message	String	状态信息	必须	在 API 异常状态下会输出具体的异常原因
sequence_id	String	响应唯一码	必须	用于跟踪每次请求记录的唯一标识
result	String	核验结果	必须	枚举值： pass通过；fail不通过
reason	String	核验原因	条件必须	当result=fail

错误码可能值

Message	Description
สถานะไม่ปกติ => ข้อมูลไม่ตรง	错误的姓/ 名/出生日期
สถานะไม่ปกติ => ข้อมูลที่ใช้ในการตรวจสอบไม่ถูกต้อง	错误的身份证ID号码
สถานะไม่ปกติ =>ไม่พบเลขรหัสกำกับบัตร จากเลขประจำตัวประชาชนนี้"	错误的 Laser号码
บัตรสิ้นสภาพการใช้งาน	身份证过期

响应示例-核验成功

{
    "code": 200,
    "message": "success",
    "sequence_id": "1648777165770866F82AC7F326307055",
    "result": "pass"
}

响应示例-核验失败

{
    "result": "fail",
    "reason": "ข้อมูลที่ใช้ในการตรวจสอบไม่ถูกต้อง",
    "code": 200,
    "sequence_id": "1710400050550633G10EC1EB78129896",
    "message": "success"
}

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	{参数}错误	否