抖音开放平台Logo
开发者文档
控制台

综合到店提货券对接解决方案

收藏
我的收藏

提货券说明​

提货券能力介绍:提货券是针对到综实物商品的解决方案,核心通过多SKU支持购前选SKU和门店、购后线下提货,增强SKU履约确定性,目标是解决当前团购券易发到店无货问题,提振商家商品供给,带来行业GMV增量​
    Before
    After

能力开通​

联系对接产运&BD提报开通​

接入前期准备​

商家入驻抖音来客【技术服务商可跳过】​
首先确保商家已经入驻抖音来客,完成POI的认领:https://life.douyin.com/

开平接入流程​

    开发测试期间,使用抖音提供的沙箱账号进行测试,测试完成后,再使用商家正式账号​
    沙箱账号联系抖音侧建群对接提供,绑定商家手机号,即可用商家手机号以沙箱账号身份登录来客​
可按照商家所在地与产运对接人​
    沙箱账号已绑定自研商家,可登录抖音来客,自带clientKey应用,secret,固定token,接口调用权限,无需再走入驻开平和申请授权流程​

技术服务商入驻开平​

KA自研入驻开平:https://developer.open-douyin.com/

技术服务商创建应用(已有可忽略)​

如复用已有应用,请注意【发放凭证】SPI是复用接口,与预售券、三方码团购一样​
创建第三方生活服务商家应用:​
填写相关信息,创建应用。​
应用创建成功后,可进入应用详情页查看ClientKey&ClientSecret​
等待应用审核完成。审核时效 3 个工作日。​

商家授权技术服务商 or 绑定自研服务商​

若是技术服务商,需商家在抖音来客授权给技术服务商:​
若是自研服务商,在商家自研服务里绑定开发者:​

开通应用的解决方案【for 技术服务商】​

在应用详情中,点击解决方案,选择对应的解决方案申请开通。审核时效 3 个工作日。​
综合到店提货解决方案​

生成 access-token​

通过请求参数ClientKey&ClientSecret调用/oauth/client_token/生成的token,此token不需要用户授权。示例: clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ​
注意:需每2小时更新(开发阶段给到的测试账号不同,按对应文档说明使用,参考步骤2)​

商家回调地址配置​

系统已支持线上配置SPI,技术服务商可线上配置:​
使用SPI接口涉及:创建订单、通知支付结果、申请退款、三方码发放凭证、申请退货、超时退货通知​
目前已支持线上配置webhook,在开发设置中配置:​

接口对接场景​

整体流程图​

抖音码场景​

时序图​

接口清单​

业务场景/能力​
是否必接​
接口​
说明​
商品管理​
来客端创品可以不接商品接口
必接​
    查询提货券门店库存​
必接​
创建/查询抖音团购商品​
必接​
可选​
必接​
提货券抖音码交易​
是​
查券、验券、撤销核销​
是​
可选​
必接​

三方码场景​

业务场景/能力​
是否必接​
接口​
说明​
商品管理​
来客端创品可以不接商品接口
非来客创品,必接​
查询提货券门店库存​
非来客创品,必接​
创建/查询抖音团购商品​
可选​
非来客创品,必接​
提货券三方码交易能力​
必接​
通知外部商家创单​
必接​
通知外部商家支付成功​
必接​
通知外部商家取消订单​
必接​
发券接口​
必接​
发券回调接口​
必接​
验券接口​
必接​
撤销核销接口​
可选​
券状态批量查询​
必接​
商家退款申请​
必接​
退款审核回调接口​
必接​
退款通知接口​