订单状态（强烈建议）

订单状态 API 是 TD 系统的一个关键功能，旨在确保获取订单信息的准确性和及时性。

通过订单状态 API，我们能够准确识别更加狡猾的欺诈者，这些欺诈者巧妙地运用正常身份和行为，以规避关键业务节点的检测，从而欺骗系统。仅凭单一的业务行为判断往往难以揭示欺诈者的真实意图。

此外，订单状态 API 的应用将提高我们对正常用户偶发异常行为的准确识别能力，从而在降低误报率的同时提升订单通过率。我们在一般业务节点对用户进行无感知的数据上报，并在关键业务节点做出决策。这种设计有助于减少对用户的干扰，提升用户体验。

通过订单状态 API ，我们能够确保 TD 系统始终获取到最新的订单信息，进而提升系统的安全性和可靠性。

API 方式

Base URL

• 中国节点：https://cn-event.apitd.net/order/v3
• 美国节点：https://us-event.apitd.net/order/v3
• 新加坡节点：https://sg-event.apitd.net/order/v3
• 欧洲节点：https://de-event.apitd.net/order/v3

API

示例：https://cn-event.apitd.net/order/v3?partner_code=test_code&partner_key=test_key

认证参数

请求参数

一次完整的请求参数通常由两部分字段组成：

1. 基础字段：这些字段包含了与请求本身相关的基本信息，旨在确保请求的合法性和安全性。
2. 业务事件字段：这些字段与订单状态有关，例如订单支付、订单发货等业务事件。通过这些字段，我们能够传递与特定业务事件相关的数据，如支付信息、发货信息等。

将基础字段和业务事件字段结合起来，构成了一次完整的请求参数。这样的设计使得我们能够有效地传递和处理与订单状态相关的业务事件数据，确保订单信息的准确性和安全性。

基础字段

业务事件字段

我们的 API 设计限制了每次请求只能涉及一个业务事件的数据。这意味着您无法同时发起多个不同的业务事件数据请求，例如订单发货和订单收货。

为了确保数据的准确性和系统的可靠性，我们建议您按照业务事件的独立性，分别发送业务事件请求。通过单独处理每个业务事件，我们能够更好地管理和跟踪数据的处理过程，避免混淆和冲突。

遵守这一规则将有助于提高系统的性能和可靠性，并确保每个业务事件都能得到正确处理。如果您需要同时处理多个不同的业务事件，我们建议您分别发送独立的请求，以确保数据的完整性和一致性。

请求示例

以订单发货事件为例

{
    "channel": "test",
    "session_id": "abc0123456789",
    "account_id": "123456789",
    "event_time": "2021-10-12T14:20:50.521+07:00",
    "event_type": "order_ship",
    "terminal": {
        "black_box": "aGPH1658920283672ropYaFxT7",
        "ip": "210.20.10.33"
    },
    "ext": {
        "ext_book_id": "LFOUHOFHOHFNOUH",
        "ext_book_num": 10
    },
    "order_id": "NX348566DIHD",
    "logistics": {
        "logistics_type": "Standard Shipping",
        "cost": {
            "currency": "CNY",
            "amount_local": 68,
            "amount_usd": 10,
            "amount_cny": 68
        },
        "logistics_company": "SF"
    }
}

响应参数

API 状态码

响应示例

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