API Reference
English

核查中心(订单)订阅

核查中心(订单)订阅 API 是用于您在 TD 平台进行订单核查操作后,将核查结果(拒绝、通过)主动推送到您订阅的 API 地址,以便于您的业务系统接收到结果后进行进一步的操作流程,如取消订单等。

API 方式

Base URL

您在 TD 客户平台订阅中心配置的核查中心(订单)订阅 API 地址

API

URL请求方式Content-Type输出格式字符集
api-base-url?timestamp=xxx&partner_code=xxx&access_key=xxx&sign=xxxPOSTapplication/jsonJSONUTF-8
认证参数
字段类型含义建议备注
timestampString当前时间戳必须毫秒级
partner_codeString合作方标识必须由 TD 分配
access_keyStringaccess key必须由 TD 分配,可通过 TD 客户平台订阅中心查看
signString签名必须
sign 生成方式

sign = HmacSHA1(partner_code+timestamp+access_key,access_secret)

其中 access_secret 由 TD 分配,可通过 TD 客户平台订阅中心查看

headers
参数名参数值建议备注
Content-Typeapplication/json必须
xxxxxx条件必须您在TD 客户平台订阅中心配置的自定义参数

推送请求参数

字段类型含义建议备注
typeString推送的 ID 类型必须枚举值:order_id
idString推送的 ID 内容必须
resultString反馈结果必须枚举值:
decline
accept
operatorString操作人必须操作人员的名字,如果名字不存在则用操作人员的账号(邮箱等)
timeLong操作时间必须毫秒级时间戳
reasonString原因或备注建议

推送请求示例

{
  "type": "order_id",
  "id": "1648777165770866F82AC7F326307055",
  "result": "accept",
  "operator": "Pierre-zb",
  "time": "1673402388579",
  "reason": "lorem tags"
}

响应参数

您的业务系统在收到推送请求后需要响应的参数

字段类型含义建议备注
codeIntegerAPI 状态码必须
messageString状态信息必须在 API 异常状态下会输出具体的异常原因

API 状态码

code含义
200成功

响应示例

{
  "code": 200,
  "message": ""
}