Verification API (Required)

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

In order to effectively prevent fraud and avoid potential financial losses in your promotional campaigns, it is recommended that you send risk verification requests before granting promotional discounts or immediately after granting them but before the discounts are redeemed. This can help protect the security of your campaign funds and ensure that only legitimate users can avail the discounts.

API Format

Base URL

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

API

example: https://sg.apitd.net/fraud/promo/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 marketing and withdraw. 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 marketing event.

{
    "channel": "test",
    "session_id": "abc0123456789",
    "decision_event": "marketing",
    "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": 10
    },
    "event_detail": {
        "marketing": {
            "marketing_id": "X08938",
            "open_id": "o6_bmjrPTlm6_2sgVt7hMZOPfL2M",
            "open_id_type": "wechat",
            "begin_time": 1596358039000,
            "expire_time": 1616358039000
        }
    }
}

Response Parameter

API Status Code

Response Example

{
    "code": 200,
    "message": "",
    "sequence_id": "1648777165770866F82AC7F326307055",
    "score": 90,
    "result": "decline",
    "reasons": [
        {
            "id": "IDRBVBBY",
            "reason": "Suspicious behavioral patterns / frequency"
        }
    ]
}