order_site/docs/抖音-码速达

抖音码速达 - 开放平台 对接文档

本目录把 抖音码速达开放平台（https://dy-openplatform-api.wanmahui.com）联调文档页的全部数据完整落到仓库里， 便于离线查阅、评审与后续对接开发。

抓取时间：2026-10-08（Asia/Shanghai）｜ 抓取入口：https://dy-openplatform-api.wanmahui.com/?token=<访问令牌已隐去>#message.trade_TradePaid 页面数据源：页面内嵌的 #raw_data JSON（本目录已原样保存为 data/raw_data.json）。 说明：文档页访问令牌（token）属于凭据，已在本文档中隐去，如需重新访问请向平台方索取。

平台速览

项目	内容
平台名称	抖音码速达 - 开放平台
服务地址（页面 origin）	https://dy-openplatform-api.wanmahui.com
接口网关	POST https://dy-openplatform-api.wanmahui.com/api/openplatform/gateway
消息推送测试入口	https://dy-openplatform-api.wanmahui.com/api/openplatform/messagetest
请求编码	Content-Type: application/x-www-form-urlencoded
签名算法	MD5（32 位小写），见「接口调用规范与签名」
鉴权要素	用户秘钥 secret + 抖店商户号 uid（OpenUid） + 方法名 method + 时间戳 timestamp
计费	按功能分级扣金豆（见「计费规则」）
消息主题数量	14 条
接口数量	16 个（不含公共参数 uid/method/timestamp/sign）

文档目录

文档	内容
01-计费规则.md	免费/基础/高级/增值 四档功能单价与各接口分级
02-接口调用规范与签名.md	网关、公共参数、签名算法、返回结构、JAVA/.NET/PHP 请求示例
03-消息推送规范与签名.md	推送参数、data 提交方式、签名与验签、消息设置、示例代码
04-结合本项目的深度分析.md ~ 12-按SKU分类改造总设计.md	本项目接入分析、最小方案、实现说明、三层分流与按 SKU 改造；04~06 为历史分析，07/00/12 为现行实现
接口API/	16 个接口逐条文档（请求参数、返回参数与示例、签名原串示例）
消息推送/	14 条消息逐条文档（topic、data 字段、示例 JSON、签名原串示例）
data/raw_data.json	页面内嵌原始数据（api / message / fee / menu 四块，完整未删减）
data/page.html	文档页原始 HTML 快照（含页面模板与前端逻辑）
data/代码示例/	页面内置的 JAVA / .NET / PHP 示例代码原文

消息推送（14 条）

#	消息	主题 topic	分级	说明
1	买家已付款	trade_TradePaid	基础功能	在线支付订单，当买家付款成功时，会推送此消息
2	卖家备注变更	trade_TradeMemoModify	基础功能	卖家修改交易备注时，会推送此消息
3	卖家发货	trade_TradeSellerShip	基础功能	卖家对所有商品发货完成，且父订单状态为【已发货】时，会推送此消息
4	卖家部分发货	trade_TradePartlySellerShip	基础功能	卖家对部分商品（可能是部分件数）发货时，会推送此消息
5	买家发起售后	refund_RefundCreated	基础功能	买家申请整单退款时，会推送此消息
6	售后关闭	refund_RefundClosed	高级功能	当买家取消申请或系统超时机制导致退款取消时，会推送此消息
7	退款成功	refund_RefundSuccess	高级功能	当商家同意退款后，实际退款到账时，会推送此消息
8	订单完成	trade_TradeSuccess	基础功能	买家确认收货或系统自动确认收货，且父订单状态变为「已完成」时，会推送此消息
9	订单取消	trade_TradeCanceled	基础功能	触发场景：货到付款订单且订单状态为「待确认」，买家和商家可取消订单；货到付款订单且订单状态为「备货中」，买家、商家和平台客服可取消订单；货到付款订单且订单状态为「已发货」，物流状态为拒收或退回；在线支付订单且订单状态为「待付款」，买家可取消该订单；在线支付订单且订单状态为「待付款」，超时未支付，订单自动取消
10	同意退款	refund_RefundAgreed	基础功能	触发场景：买家在发货前申请整单退款，卖家同意退款或超时自动同意退款时；买家在发货后申请退款，卖家同意退款或超时自动同意退款时；买家在发货后申请申请退货，卖家确认收货或系统超时自动确认收货时；卖家收到买家换货包裹，核验后无法换货，同意换货但转直接退款时
11	拒绝退款	refund_RefundRefused	高级功能	触发场景：买家在发货前申请整单退款，卖家拒绝；买家在发货后申请退款，卖家拒绝；买家在发货后申请申请退货，买家发货后，卖家拒绝收货
12	发起仲裁	refund_ArbitrateApplied	高级功能	触发场景：商家拒绝买家请求，买家可申请平台客服介入、发起客服仲裁，此时推送此消息。具体场景如下： 订单已发货，买家申请售后退款，此时商家拒绝，买家可发起仲裁；订单已发货，买家申请售后退换货，此时商家拒绝退货请求，买家可发起仲裁；订单已发货，买家申请售后退换货，买家已填写退货物流，此时商家拒绝收货，买家可发起仲裁
13	取消仲裁	refund_ArbitrateCancelled	高级功能	买家申请客服介入、发起客服仲裁后，而后又取消客服仲裁时，推送此消息
14	订单创建	trade_TradeCreate	基础功能	当买家下单，系统生成订单时，会推送此消息

接口 API（16 个）

#	接口	方法名	分级	说明
1	订单详情	order.orderDetail	高级功能	查询订单的详细信息，仅显示关键字段
2	充值结果提交	topup.result	基础功能	商家处理完充值请求后，异步回调告知平台充值结果
3	卡券同步	coupons.syncV2	基础功能	卖家在平台卖出券后同步卡券信息
4	卡券核销V3	coupons.verifyV3	高级功能	卖家向平台提交卡券核销状态
5	券码查询	coupons.list	基础功能	查询券码在平台侧的状态详情
6	卡券取消核销	coupons.cancelVerify	基础功能	当卡券核销错误之后，取消核销时候使用
7	卖家备注	order.addOrderRemark	基础功能	卖家提交订单备注
8	售后审核	afterSale.operate	高级功能	售后统一操作接口
9	查询商家拒绝原因列表	afterSale.rejectReasonCodeList	免费功能	查询抖店支持的全量拒绝原因列表，或指定售后单可选的拒绝原因列表（仅支持已发货的售后查询，备货中未发货订单返回为空）
10	订单列表查询	order.searchList	未标注	根据条件检索满足要求的订单列表，支持下单时间和更新时间排序；最大支持查询近90天的数据；注：本接口仅用作批量获取订单基础信息及核查订单状态，如需获取订单充值信息，构建充值流程，请对接【买家已付款】消息+【订单详情】API
11	商家主动取消订单	coupons.CertSyncFailedCancelOrder	高级功能	仅适用于三方卡券订单，其他类型的订单都不支持；订单状态等于2，处于待发码状态，商家才可主动取消订单
12	消息设置	message.config	免费功能	用户自行设置消息接收地址，推送状态及订阅内容
13	商品详情	product.detail	基础功能	根据商品ID获取商品详情，输出仅限码速达系统已采集的字段
14	商品列表	product.list	高级功能	分页查询店铺商品列表，输出仅限码速达系统已采集的字段
15	商品sku列表	sku.list	高级功能	根据商品id获取商品的sku列表
16	订单消息测试	order.message	高级功能	测试接口，仅支持特定商户

对接要点（快速上手）

1. 拿凭据：向平台方索取「用户秘钥 secret」与「抖店商户号 uid」。
2. 调接口：POST {网关}，application/x-www-form-urlencoded，带公共参数 uid、method、timestamp（10 分钟内有效）、sign + 业务参数。
3. 算签名：除 sign 外所有参数按参数名字典序拼接 参数名+参数值，首尾各加一次 secret，取 MD5 小写。
4. 看返回：{"code":"10000","message":"成功","data":{...}}；code != 10000 即失败，message 为错误原因。
5. 收消息推送：在「消息设置」接口配置 message_url 与订阅的 topics；平台以 GET topic+pub_time+sign、data 走 POST body 推送到该地址，验签同样用 MD5 原串。
6. 自测：消息可用 messagetest 入口按 topic 触发；接口联调前先确认账户金豆余额与功能分级。