Indonesia Income Verification

Income verification API is suitable for personal income and company information verification in Indonesia. This API is realtime and data will be return immediately based on input parameter value.

API Method

Base URL

Indonesia: https://id.apitd.net/credit/data/feature/income/v1

API

Request Methods	Content-Type	Output Format	Character Set
POST	application/json	Json	UTF-8

Authentication

Parameter	Type	Required/Optional	Notes
partner_code	String	Required	To be assigned by TD
partner_key	String	Required	To be assigned by TD

Request Parameter

Parameter	Type	Required/Optional	Notes
name	String	Required	name
phone_number	String	Required	Only 10-13 pure numbers and + signs are supported, starting with +628, 628, 08,8
id_number	String	Required	Id card number, only 16 digits of pure numeric input
id_type	String	Required	national_id
sex	String	Strongly recommended	“male” or ”female”
birthdate	String	Strongly recommended	”YYYY-MM-DD”
package	String	Strongly recommended	Type of insurance, example:“JHT,JKK,JKM”,"JHT,JKK,JKM,JPN" Definition： JKK: Work-related injury insurance JKM: Non-work-related accidental death insurance JHT: Endowment insurance JPN: Pension (JP)
email	String	Strongly recommended	email
address_employee	String	Strongly recommended	Personal address

Response Parameter

Parameter	Type	Description	Notes
code	Integer	API status code
message	String	Status information	The specific cause of the exception is displayed when the API is in an abnormal state
sequence_id	String	Response unique code	A unique identifier used to track the record of each request
result	String	Result	Enumerated values: hit no_record error
error_message	String	Error message	Message when result =error, i.e. Kuota harian Anda telah habis ：Your daily quota has been exceeded Error system: System error ......
data	JSONObject		result=no_record, do not return this field; result=hit, return this field, JSON format

Details returned by the data field:

Parameter	Type	Description	Notes
company	String	company name	correct results
address_company	String	company address	correct results
month_last_salary	String	latest salary month received	correct results
range_salary	String	salary range	correct results
sex	String	sex	MATCH/NOT MATCH
birthdate	String	birthday	MATCH/NOT MATCH
package	String	Type of insurance	MATCH/NOT MATCH
email	String	email	MATCH/NOT MATCH
address_employee	String	Personal address	MATCH/NOT MATCH

*If non-required fields are not uploaded, no comparison results are returned

Income range specification：

No.	range	Meaning(IDR)
1	0-2.5JT	(0, 2500000)
2	2.5-3.5JT	[2500000,3500000)
3	3.5-4.5JT	[3500000,4500000)
4	4.5-5.5JT	[4500000,5500000)
5	5.5-6.5JT	[5500000,6500000)
6	6.5-7.5JT	[6500000,7500000)
7	7.5-8.5JT	[7500000,8500000)
8	8.5-12.5JT	[8500000,12500000)
9	12.5-20.5JT	[12500000,20500000)
10	>20.5JT	[20500000,+)

API Status Code

code	Message	Description
200		Success
300	Service not purchased or not effective	Service not purchased or not effective
301	Service not purchased	Service not purchased
302	Service has been suspend	Service has been suspend
303	Not enough balance	Not enough balance
304	Service expired	Service expired
9500	Internal error	Internal error
9060	{parameter} empty	{parameter} empty
9061	{parameter} error	{parameter} error

Hit Request Example

{
    "code": 200,
    "data": {
        "birthday": "NOT MATCH",
        "package": "MATCH",
        "range_salary": ">20.5JT",
        "sex": "NOT MATCH",
        "address_employee": "NOT MATCH",
        "date_first_salary": "01/09/2020",
        "month_last_salary": "10/2023",
        "company": "PT MAJU MAKMUR",
        "email": "NOT MATCH",
        "address_company": "JL. SUMUR BANDUNG 23, BANDUNG, JAWA BARAT"
    },
    "result": "hit",
    "sequence_id": "1699272744735016I303341798930550"
}

Non-hit Request Example

{
"code": 200,
"result": "no_record",
"sequence_id": "75ccadf47dab4c81a06e6f0da746cd9c"
}

Error Example

{
    "code": 200,
    "result": "error",
    "error_message": "Kuota harian Anda telah habis ",
    "sequence_id": "75ccadf47dab4c81a06e6f0da123cd9c"
}

Failed Example

{
    "code": 301,
    "message": "Service not purchased"
}