ID Verification -Thailand

ID verification is used to verify the authenticity of user ID information.

API Method

Base URL

Singapore：https://sg.apitd.net/verification/kyc/idverify/v1
Thailand：https://th.apitd.net/verification/kyc/idverify/v1

API

URL	Request Methods	Content-Type	Output Format	Character Set
api-base-url?partner_code=xxx&partner_key=xxx	POST	application/json	JSON	UTF-8

Authentication

Parameter	Type	Description	Required/Optional	Notes
partner_code	String	Partner Code	Required	Assigned by TD
partner_key	String	Partner Key	Required	Assigned by TD

Request

Parameter	Type	Description	Required/Optional	Notes
id_number	String	ID type	Required	ID number
id_type	String	ID number	Required	Enumeration: national_id
country	String	Country	Required	2-letter country code according to ISO 3166 Support: TH(Thailand)
phone_number	String	Phone number	Required	Thailand phone number，for example：0812345678
first_name	String	First name	Required	For example：กรทพิ ย
last_name	String	Last name	Required	For example：หน่อสวุ รรณ
birth_date	String	Birth date	Required	YYYY-MM-DD ，For example：1993-01-08
laser_id	String	The laser number on the back of the Thai National ID Card	Required	For example：ME182xxxx

Request example

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

Response Parameter

Parameter	Type	Description	Required/Optional	Description
code	Integer	API status code	Required
message	String	Status Information	Required	Apecific abnormal reasons will be provided when the API is abnormal
sequence_id	String	Unique response code	Required	A unique ID used to track each request
result	String	Result	Required	Enumeration: 1. pass 2. fail
reason	String	Reasons for failed verification	Conditionally required	When result=fail

Possible values for error messages

Message	Description
สถานะไม่ปกติ => ข้อมูลไม่ตรง	Wrong First name / Last name / DOB
สถานะไม่ปกติ => ข้อมูลที่ใช้ในการตรวจสอบไม่ถูกต้อง	Wrong ID Number
สถานะไม่ปกติ =>ไม่พบเลขรหัสกำกับบัตร จากเลขประจำตัวประชาชนนี้"	Wrong Laser ID
บัตรสิ้นสภาพการใช้งาน	Expired ID card

Response example - Success

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

Response example - Failed

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

API Status Code

Code	Message	Description	Charged
200	success	Success	YES
301	Service not purchased	Service not purchased	NO
302	Service has been suspend	Traffic blocked	NO
303	Not enough balance	Traffic insufficient	NO
304	Service expired	Service expired	NO
305	Daily maximum volume reached	Daily maximum volume reached	NO
600	Service Temporarily Unavailable	Service reached limit	NO
11350	Internal error	Internal error	NO
11301	{parameter} empty	{parameter} empty	NO
11304	The country partner located is not open	The country partner located is not open	NO
11340	{parameter} error	{parameter} error	NO