ID Verification Detailed Version -Indonesia

ID verification is used to verify the ID information in Indonesia.

API Method

Base URL

Indonesia：https://id.apitd.net/verification/kyc/idverifydetail/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: KTP
phone_number	String	Phone number	optional	Beginning with 08, 10 to 13, example: 081234567890
name	String	Name	Required
country	String	Country	Required	2-letter country code according to ISO 3166 Support: ID(Indonesia)

Request Example

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

Response Parameter

Parameter	Type	Description	Required/Optional	Notes
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. success 2. fail 3. no record
further_info	String	more infomation about user	Conditionally Required, when result=pass	see table "further_info parameter" below

Further_info Parameter

Parameter	Type	Description	Example
id_number	String	ID number	1101010107730074
name	String	name	ASNAWI ADEN
birth_place	String	place of birth	BAKONGAN
birth_date	String	date of birth	1973-07-01 00:00:00
religion	String	religion	ISLAM
gender	String	gender	Male
province	String	province of household registration	ACEH
city	String	city of household registration	KAB. ACEH SELATAN
district	String	district of household registration	Bakongan
village	String	village of household registration	Padang Beurahan
office_type	String	code of workplace	0105

API Status Code

Code	Message	Description	Charged
200	success	Success	YES
301	Service not purchased	Service not purchased	NO
302	Traffic blocked	Traffic blocked	NO
303	Traffic insufficient	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

Response Example

Success

{   
 "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"
  }
}

Failure

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