推送履约状态
开发环境
开发环境
POST
https://open.douyin.com/api/trade_basic/v1/developer/fulfill_push_status
接口说明
请先确认当前订单商品类型对应的履约状态机，判断是否需要先完成弹窗确认流程。
如需调用此接口，请确保在支付成功后保持一定间隔(至少5秒)再调用。
请求参数
| 订单商品类型 | toStatus | 含义 | 使用场景 |
|---|---|---|---|
| 普通咨询 | fulfill_done | 履约完成 | 用于服务结束后，将履约状态由“履约中”驱动到“履约完成” |
| 号卡商品 | fulfilling | 履约中 | 用于商家制卡发货后，将履约状态驱动到“履约中” |
| fulfill_done | 履约完成 | 用于买家收货后，将履约状态由“履约中”驱动到“履约完成” | |
| 定制服务 | fulfilling | 履约中 | 用于服务定制中，将履约状态驱动到“履约中” |
| fulfill_done | 履约完成 | 用于定制交付后，将履约状态由“履约中”驱动到“履约完成” |
错误码
| 错误码 | 错误提示 | 建议解决方案 |
|---|---|---|
| 10000 | 参数错误 | 请仔细阅读接口文档，检查并更正参数后，重新发起请求 |
| 12001 | 操作过于频繁，请稍后再试 | 稍后使用相同的参数再次重试调用 |
| 13000 | 系统错误，请重试 | 接口返回系统错误情况下，当前请求的结果可能成功也可能失败 可保持相同的参数再次重试调用，若多次重试失败，请联系平台 |
| 27017 | 订单存在退款记录 | 退款中的订单或者退款成功的订单无法再履约，无需重试 |
| 27019 | 当前指定状态无效,请检查参数 | 当前订单所对应的履约状态机不包含请求指定状态，请更正to_status参数的值后，再重新发起请求 |
| 27020 | 当前不允许流转到指定状态 | 当前订单的状态无法往指定请求状态流转，请更正to_status参数的值后，再重新发起请求。状态流转请参考文档 |
| 27021 | 不允许使用该方式进行调用,请检查是否使用组件或openapi | 当前状态流转需使用履约组件，或需使用openapi，请检查后请求对应接口。使用方式请参考文档 |
| 27022 | 当前请求的订单状态不相同,请检查参数 | 每次请求指定的item单必须在同一个状态，请检查并更正参数后，重新发起请求 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open.douyin.com/api/trade_basic/v1/developer/fulfill_push_status' \
--header 'Content-Type: application/json' \
--data-raw '{
"order_id": "motb123123131",
"item_order_id_list": ["motb123123132"],
"to_status": "fulfilling"
}'响应示例响应示例
200 - 示例 1
{
"err_no": 0,
"err_msg": "string",
"log_id": "string"
}请求参数
Body 参数application/json
返回响应
修改于 2023-11-30 08:42:27