• 【虚拟】第三方卡券接入说明
  • 一、店铺入驻​
  • 二、抖店开放平台开放者注册入驻​
  • 三、商品创建​
  • 四、开放平台订单正逆向全流程接口调用时序图​
  • 五、订单履约​
  • 5.1 订单履约流程概述​
  • 5.2 订单信息获取​
  • 5.2.1 订单接口轮询方案​
  • 5.2.2 订阅订单消息方案​
  • 5.3 商家同步卡券信息至抖店系统(发货)​
  • 5.3.1 同步卡券信息(用于订单发货)​
  • 5.3.2 查询订单卡券信息(用于商家核对订单和卡券状态等)​
  • 5.4 卡券核销​
  • 5.4.1 卡券核销​
  • 5.4.2 核销取消(用于已核销的卡券取消核销状态)​
  • 六、逆向​
  • 6.1 逆向退款流程简述​
  • 6.2 获取退款信息​
  • 6.2.1 接口轮询方案​
  • 6.2.2 退款消息订阅方案​
  • 6.3 退款​
  • 七、结算​

【虚拟】第三方卡券接入说明

2025-06-23 03:15:22电商运营团队
该业务模式适合有卡券体系能力的商家入驻,如XX会员卡、XX服务套餐等商品类型的商家。支持用户在字节系APP下单后,商家系统生成对应的核销码(支持单次和多次卡券码)并同步至抖音平台,用户凭核销码到商家处核销并享受服务。
一、店铺入驻
image.png
店铺入驻流程见入驻流程
如有疑问请联系商家客服:在线商客服沟通咨询;或者热线:950518(8:00-23:00)
二、抖店开放平台开放者注册入驻
image.png
认证入驻流程见认证
三、商品创建
image.png
抖店商品创建可以通过抖店后台创建或通过抖店对外开放的商品创建接口创建。
  1. 抖店后台创建
商品创建教程:商品创建操作指南
  1. 开放平台发布
接口文档:发布商品接口
  1. 注意事项:
  1. 商品编辑后需要提交审核通过后方能上线,请遵循平台规则合理发布。
  1. 提取方式选择使用电子交易凭证-券码生成方式:第三方平台生成
  • default.png
  1. 三方卡券逆向规则:默认为随时退、过期自动退;部分类目可以选择完全不支持退订。【注:不支持退规则需联系行业小二,内部评估通过后对此类目开设白名单,方可以使用】
  • 抖店后台:服务与履约-提取方式-售后退改规则
  • image.png
  • 开放平台:/product/addV2文档中poi_resource 下 coupon_return_methods
  • image.png
四、开放平台订单正逆向全流程接口调用时序图
image.png
  1. 下图所涉接口名及文档信息,请参考接口文档
  1. 接口更新等信息,请参考开放平台公告(开放平台公告)或开发者信息通知
image.png
五、订单履约
image.png
5.1 订单履约流程概述
image.png
建议按照同步核销流程对接,如果按照异步核销流程对接,需要自行评估同步核销信息不及时可能产生的影响。
image.png
5.2 订单信息获取
image.png
订单信息获取方式可以通过订单接口轮询或订阅订单消息接口的方式实现。
5.2.1 订单接口轮询方案
image.png
  • 调用/order/searchList,按订单更新时间查询指定时间内更新的订单列表
  • 调用/order/orderDetail获取详细的订单信息
  • 初始化历史订单数据:调用/order/searchList,按订单创建时间查询指定时间内创建的订单列表,三方券码类的订单order_type=5进行判断,通过该接口获取到的父订单,平台会在order_id后面会加上字母A做标识(这里和从店铺后台导出的订单有区别,从店铺后台导出的订单末尾没有字母A,但其实际和通过openapi获取的父订单是同一个)
5.2.2 订阅订单消息方案
image.png
  • 获取doudian_trade_TradeCreate订单创建消息后,根据消息体返回的订单号查询订单详情
  • 获取doudian_trade_TradePaid订单支付成功消息后,根据消息体返回的订单号拉最新的订单详情
注意事项:
  • 使用时间窗口移动的方式拉单,并做兜底处理。比如,在6:00去拉5:30-5:40的数据(20分钟后拉),6:05去拉5:35-5:45的数据,第二天的6:00时再拉取一次5:30-5:40的数据(兜底补拉)
  • 增量订单同步时,如果使用更新时间查询,建议从后往前翻页,减少拉单过程中发生订单更新后丢单
PS:抖店后台订单查询路径:抖店后台-订单-订单管理
5.3 商家同步卡券信息至抖店系统(发货)
image.png
5.3.1 同步卡券信息(用于订单发货)
image.png
接口名称
接口描述
/coupons/syncV2
三方券码订单发货接口
全屏展示
退出
根据下拉的订单详情数据,筛选出状态为order_type=5的待发货(待发码)订单,调用时序图中同步三方卡券的接口进行发货,具体入参和出参可参考开放平台接口文档。
5.3.2 查询订单卡券信息(用于商家核对订单和卡券状态等)
image.png
接口名称
接口描述
/coupons/list
三方码券订单发货码信息
全屏展示
退出
商家可以通过卡券查询接口查询订单与卡券的明细和状态进行比对、记账等业务动作。
5.4 卡券核销
image.png
5.4.1 卡券核销
image.png
接口名称
接口描述
/coupons/verifyV2
三方券码订单确认收货(核销)
全屏展示
退出
消费者线下消费,调用卡券核销接口进行券码核销,订单变为已完成。
  • 注意:为支持取消核销场景,普通商家默认核销完成后,t+2天后,再推进订单完成,2天缓冲允许取消卡券核销。如果对时间配置有疑问或店铺的卡券场景特殊需要调整,可联系行业小二评估。
5.4.2 核销取消(用于已核销的卡券取消核销状态)
image.png
接口名称
接口描述
/coupons/cancelVerify
卡券取消核销接口
全屏展示
退出
如出现核销错误等异常场景需要取消卡券的核销状态,可以通过卡券取消核销接口实现。
、逆向
image.png
6.1 逆向退款流程简述
image.png
  1. 主要流程见下图,其中蓝色部分是用户主动发起售后退款的核心流程;
  1. 注意事项:
  1. 商家校验不符合退款条件的情况如果是该订单有卡券在平台侧未使用但在商家侧已核销,需要商家重新同步该卡券的核销信息给平台
  1. 平台侧未使用的卡券过期会自动发起过期自动退并自动通过
  1. 用户申请售后退款后如果商家超时未处理会按平台规范自动同意用户退款申请(目前是48小时,如有更新以平台售后规范为准)
image.png
6.2 获取退款信息
image.png
退款信息获取可以通过退款接口轮询和退款消息订阅两种方案获取。
三方卡券默认逆向规则为过期退&未使用支持退款。如有特殊需求请咨询行业小二。
6.2.1 接口轮询方案
image.png
接口名称
接口描述
/afterSale/List
售后列表接口
全屏展示
退出
退款单查询接口支持根据退款单维度+时间范围查询该时间段内的最新的退款信息(含退款申请撤销),卡券类交易未发码前消费者不能发起售后,即已支付待发码状态的订单不会产生售后单。
6.2.2 退款消息订阅方案
image.png
接口名称
接口描述
doudian_refund_RefundCreated
买家申请退款消息
doudian_refund_RefundClosed
买家撤销退款申请消息
doudian_refund_RefundModified
买家修改退款申请消息
doudian_refund_RefundSuccess
售后成功消息
doudian_refund_RefundClosed
售后失败消息
全屏展示
退出
可通过订阅退款消息,监控最新的消费者退款申请,并处理售后。
针对已支持的几种业务情况,建议均调用卡券查询接口对比卡券信息:
  • 正常退订:指消费者主动发的售后申请 【注意,三方卡券正常退订流程仅支持走接口】
  • 超期退订:指券码超过使用有效期,抖音电商系统自动为消费者发起的售后申请
  • 超级退订:指券码核销使用后,不符合上述两种售后时(比如线下服务不满意等),消费者与商家协商一致,重新为客人打开售后申请入口(操作路径:抖店后台-订单管理-订单列表)。
券类型
单笔订单券数量
售后场景
支持与否
卡券信息比对
单次券
单张
未使用,正常退订
调用接口比对
未使用,超期退订
调用接口比对
已使用,正常退订
已使用,超级退订
接口不处理,转抖店后台
多张
未使用,正常退订
调用接口比对
未使用,超期退订
调用接口比对
部分使用,普通退订(剩余全部一起提交)
调用接口比对
部分使用,超级退订
(剩余全部一起提交)
接口不处理,转抖店后台
全部已使用,正常退订
全部已使用,超级退订
接口不处理,转商家后台
多次券
单张
未使用,正常退订
调用接口比对
未使用,超期退订
调用接口比对
部分使用,正常退订
调用接口比对
部分使用,超期退订
调用接口比对
全部已使用,正常退订
全部已使用,超级退订
接口不处理,转抖店后台
多张(不支持)
全屏展示
退出
6.3 退款
image.png
订单状态
逆向操作
未支付
支持用户可以发起订单取消,且超30分钟未支付订单自动取消
已支付未发码
24小时内未发码,平台自动关闭订单并退款
已发货
1.支持用户发起售后仅退款
2.支持客服发起售后仅退款
3.支持系统自动发起卡券过期自动发起退款
已完成(已核销)
除到店自提订单外,不支持用户发起售后
全屏展示
退出
卡券废弃后通过以下接口进行退款操作,目前抖店平台不支持抖店后台手工操作三方卡券订单退款,仅支持接口处理。
接口名称
接口描述
/afterSale/Operate
退款处理接口
全屏展示
退出
七、结算
image.png
  1. 抖店订单结算模式为T+n的结算周期进行结算,具体规则见:账户中心介绍《商家货款结算日期》执行细则
  1. 结算明细查询:
  1. 抖店后台,路径:抖店后台-资金-账单管理
  • image.png
  1. 抖店对外开放接口开放平台对外接口
rangeDom