API Reference
中文

ID Verification -Thailand

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

API Method

Base URL

API

URLRequest MethodsContent-TypeOutput FormatCharacter Set
api-base-url?partner_code=xxx&partner_key=xxxPOSTapplication/jsonJSONUTF-8
Authentication
ParameterTypeDescriptionRequired/OptionalNotes
partner_codeStringPartner CodeRequiredAssigned by TD
partner_keyStringPartner KeyRequiredAssigned by TD

Request

ParameterTypeDescriptionRequired/OptionalNotes
id_numberStringID typeRequiredID number
id_typeStringID numberRequiredEnumeration: national_id
countryStringCountryRequired2-letter country code according to ISO 3166
Support: TH(Thailand)
phone_numberStringPhone numberStrongly recommendedThailand phone number,for example:0812345678
first_nameStringFirst nameRequiredFor example:กรทพิ ย
last_nameStringLast nameRequiredFor example:หน่อสวุ รรณ
birth_dateStringBirth dateRequiredYYYY-MM-DD ,For example:1993-01-08
laser_idStringThe laser number on the back of the Thai National ID CardRequiredFor 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

ParameterTypeDescriptionRequired/OptionalDescription
codeIntegerAPI status codeRequired
messageStringStatus InformationRequiredApecific abnormal reasons will be provided when the API is abnormal
sequence_idStringUnique response codeRequiredA unique ID used to track each request
resultStringResultRequiredEnumeration:
1. pass
2. fail
reasonStringReasons for failed verificationConditionally requiredWhen result=fail

Possible values for error messages

MessageDescription
สถานะไม่ปกติ => ข้อมูลไม่ตรง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 MessageDescriptionCharged
200successSuccessYES
301Service not purchasedService not purchasedNO
302Service has been suspendTraffic blockedNO
303Not enough balanceTraffic insufficientNO
304Service expiredService expiredNO
305Daily maximum volume reachedDaily maximum volume reachedNO
600Service Temporarily UnavailableService reached limitNO
11350Internal errorInternal errorNO
11301{parameter} empty{parameter} emptyNO
11304The country partner located is not openThe country partner located is not openNO
11340{parameter} error{parameter} errorNO