Identity Verification API

The Verification API is used for real-time access to our risk verification results.

API Format#

Base URL#

• China：https://cn-efficient.apitd.net/fraud/identity/v3
• America：https://us-efficient.apitd.net/fraud/identity/v3
• Singapore：https://sg-efficient.apitd.net/fraud/identity/v3
• Germany：https://de-efficient.apitd.net/fraud/identity/v3

API#

example: https://sg-efficient.apitd.net/fraud/identity/v3?partner_code=test_code&partner_key=test_key

Authentication

Request#

The mapping relationship between the event_detail event data and the decision_event is as follows:

Our API design restricts each request to only include data related to a single business event. This means that you cannot simultaneously pass multiple requests with different types of business event data, such as register and login. Adhering to this rule will help improve system performance and reliability, ensuring that each business event is processed correctly.

Request Example#

Let's take the example of a register event.

{
    "channel": "test",
    "session_id": "abc0123456789",
    "decision_event": "register",
    "event_time": "2021-10-12T14:20:50.521+07:00",
    "account_id": "123456789",
    "terminal": {
        "black_box": "aGPH1658920283672ropYaFxT7",
        "ip": "210.20.10.33"
    },
    "ext": {
        "ext_book_id": "LFOUHOFHOHFNOUH",
        "ext_book_num"

Response Parameter#

API Status Code

Response Example#

{
    "code": 200,
    "message": "",
    "sequence_id": "1648777165770866F82AC7F326307055",
    "score": 60,
    "result": "review",
    "reasons": [
        {
            "id": "IDMQ0QB2",
            "reason": "Gang Risk"
        }
    ]
}