The Account Status API is a key functionality of the TD system aimed at ensuring the accuracy and timeliness of retrieving user identity information.

Through the Account Status API, we are able to accurately identify more cunning fraudsters who cleverly use normal identities and behaviors to evade detection at critical business checkpoints, thereby deceiving the system. Relying solely on individual business behaviors often proves difficult in revealing the true intentions of fraudsters.

Additionally, the application of the Account Status API enhances our ability to accurately identify occasional abnormal behaviors of legitimate users, thus reducing false positive rates and improving user conversion rates. We perform seamless data reporting on users at regular business checkpoints and make decisions at critical business checkpoints. This design helps minimize user interference and enhances user experience.

Through the Account Status API, we ensure that the TD system consistently receives the latest user identity information, thereby enhancing system security and reliability.

API Format

Base URL

China: https://cn-event.apitd.net/account/v3
America: https://us-event.apitd.net/account/v3
Singapore: https://sg-event.apitd.net/account/v3
Germany: https://de-event.apitd.net/account/v3

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

example: https://sg-event.apitd.net/account/v3?partner_code=test_code&partner_key=test_key

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

A complete request parameter typically consists of two parts:

Basic Parameter: These fields contain fundamental information related to the request itself, aiming to ensure the validity and security of the request.
Event Parameter: These fields are related to the account status, such as register, login, and other events. Through these fields, we can pass data related to specific events, such as account phone information, account email, personal profile, and so on.

By combining the basic fields and event fields, a complete set of request parameters is formed. This design allows us to effectively transmit and process event data related to the account status, ensuring the accuracy and security of account information.

Basic Parameter

Parameter	Type	Description	Required/Optional	Notes
channel	String	Channel Identifier	required	assigned by TD
session_id	String	Session ID	required	The session ID is a unique identifier assigned by the website server to a specific user during the visit, which is usually stored in the form of a cookie, form parameter, or URL
account_id	String	Account ID	conditionally required: required when account registration/creation is finished	not required when the account doesn't exist
event_time	String	The Actual Time of the Event	required	ISO 8601, format YYYY-MM-DDTHH:mm:ss.sssZ, example: 2021-10-12T14:20:50.521+07:00
event_type	String	Event Type	required	enumeration: register, login, modify
terminal	Terminal	Device Information	Conditionally Required	Required when it exists
ext	Ext	Extended Field	optional	extended field registered in the TD system

Event Parameter

Our API design restricts each request to only involve data related to a single event. This means that you cannot simultaneously initiate multiple different event data requests, such as register and login.

To ensure data accuracy and system reliability, we recommend that you send separate requests for each event, considering the independence of each event. By handling each event separately, we can better manage and track the data processing process, avoiding confusion and conflicts.

Adhering to this rule will help improve system performance and reliability, ensuring that each event is correctly processed. If you need to handle multiple different events simultaneously, we suggest sending separate requests for each event to ensure data integrity and consistency.

Event	Event Type	Required/Optional
Register	register	optional (strongly recommended)
Login	login	optional (strongly recommended)
Modify	modify	optional (strongly recommended)

Request Example

Let's take the example of a register event.

{
    "channel": "test",
    "session_id": "abc0123456789",
    "account_id": "123456789",
    "event_time": "2021-10-12T14:20:50.521+07:00",
    "event_type": "register",
    "terminal": {
        "black_box": "aGPH1658920283672ropYaFxT7",
        "ip": "210.20.10.33"
    },
    "ext": {
        "ext_book_id": "LFOUHOFHOHFNOUH",
        "ext_book_num": 10
    },
    "account": {
        "account_id": "123456789",
        "register_time": "2021-10-12T14:20:50.521+07:00",
        "login_time": "2021-10-12T14:25:50.521+07:00",
        "phone": {
            "country_code": 1,
            "phone_number": "6165793816"
        },
        "email": "hello@gmail.com"
    },
    "profile": {
        "person": {
            "name": {
                "first_name": "Pierre",
                "middle_name": "",
                "last_name": "Laurent",
                "nickname": "Snochy"
            },
            "sex": "male",
            "birthdate": "1998-01-01"
        },
        "address": {
            "country": "FR",
            "region": "Grand Est",
            "city": "Strasbourg City",
            "district": "Ketali Lorem",
            "detail": "3213 Building，lorem Street",
            "zip_code": "310000"
        },
        "education": "master",
        "profession": "XXX",
        "annual_income": {
            "currency": "USD",
            "amount_local": 100000,
            "amount_usd": 100000,
            "amount_cny": 680000
        }
    },
    "invite": {
        "inviter_id": "567890",
        "inviter_phone": {
            "country_code": 1,
            "phone_number": "18700001112"
        },
        "invite_code": "NOHHD",
        "invite_medium": "WeChat"
    }
}

Response Parameter

Parameter	Type	Description	Required/Optional	Notes
code	Integer	API Status Code	required
message	String	Status Message	required	specific abnormal reasons will be provided when the API is abnormal
sequence_id	String	Unique ID of Response	required	A unique ID used to track each request

API Status Code

code	Description
200	Success
9001	`{Parameter}` empty
9002	`{Parameter}` check error
9003	`{Parameter}` length or size exceeds 1024
9004	Either black_box or ip exists
9200	System error
9201	Unknown error
9202	Illegal Content-Type
9204	Image not supported
9205	Get method not supported
9206	System environment error

Response Example

{
    "code": 200,
    "message": "",
    "sequence_id": "1648777165770866F82AC7F326307055"
}