Checking Center (Order) API is used to actively push the feedback results (decline or accept), which are made by your manual review team on the TD portal, to the API address you subscribed to, so that your business system can receive the results and carry out further operation procedures, such as canceling the orders, etc.
API Format
Base URL
Checking Center API address you configured on the TD portal.
API
URL | Request Methods | Content-Type | Output Format | Character Set |
---|---|---|---|---|
api-base-url?timestamp=xxx&partner_code=xxx&access_key=xxx&sign=xxx | POST | application/json | JSON | UTF-8 |
Authentication
Parameter | Type | Description | Required/Optional | Notes |
---|---|---|---|---|
timestamp | String | Current Timestamp | required | millisecond |
partner_code | String | Partner Code | required | assigned by TD |
access_key | String | Access Key | required | assigned by TD |
sign | String | Sign | required |
How the 'sign' is generated?
sign = HmacSHA1(partner_code+timestamp+access_key,access_secret)
In which, 'access_secret' is assigned by TD.
headers
Parameter Name | Value | Required/Optional | Notes |
---|---|---|---|
Content-Type | application/json | required | |
xxx | xxx | conditionally required | the customized field you configured on TD portal |
Push Request Parameter
Parameter | Type | Description | Required/Optional | Notes |
---|---|---|---|---|
type | String | ID Type | required | enumeration: order_id |
id | String | ID Value | required | |
result | String | Result | required | enumeration: decline accept |
operator | String | Operator | required | name of the operator, and can be replaced by the operator's account or email. |
time | Long | Time | required | millisecond |
reason | String | Reasons or Notes | optional |
Push Request Example
{
"type": "order_id",
"id": "1648777165770866F82AC7F326307055",
"result": "accept",
"operator": "Pierre-zb",
"time": "1673402388579",
"reason": "lorem tags"
}
Response Parameter
Parameters that your business system needs to respond to after receiving a push request
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 |
API Status Code
code | Description |
---|---|
200 | Success |
Response Example
{
"code": 200,
"message": ""
}