综合到店提货券对接解决方案
收藏提货券说明
提货券能力介绍：提货券是针对到综实物商品的解决方案，核心通过多SKU支持购前选SKU和门店、购后线下提货，增强SKU履约确定性，目标是解决当前团购券易发到店无货问题，提振商家商品供给，带来行业GMV增量
- •Before
- •After
能力开通
联系对接产运&BD提报开通
接入前期准备
商家入驻抖音来客【技术服务商可跳过】
首先确保商家已经入驻抖音来客，完成POI的认领：https://life.douyin.com/
开平接入流程
- •开发测试期间，使用抖音提供的沙箱账号进行测试，测试完成后，再使用商家正式账号
- •沙箱账号联系抖音侧建群对接提供，绑定商家手机号，即可用商家手机号以沙箱账号身份登录来客
可按照商家所在地与产运对接人
- •沙箱账号已绑定自研商家，可登录抖音来客，自带clientKey应用，secret，固定token，接口调用权限，无需再走入驻开平和申请授权流程
技术服务商入驻开平
参考技术服务商接入指南：https://partner.open-douyin.com/docs/resource/zh-CN/dop/ability/life-service-ability/life.capacity/guide/
KA自研入驻开平：https://developer.open-douyin.com/
技术服务商创建应用（已有可忽略）
如复用已有应用，请注意【发放凭证】SPI是复用接口，与预售券 、三方码团购一样
创建第三方生活服务商家应用：
填写相关信息，创建应用。
应用创建成功后，可进入应用详情页查看ClientKey&ClientSecret
等待应用审核完成。审核时效 3 个工作日。
商家授权技术服务商 or 绑定自研服务商
若是技术服务商，需商家在抖音来客授权给技术服务商：
若是自研服务商，在商家自研服务里绑定开发者：
开通应用的解决方案【for 技术服务商】
在应用详情中，点击解决方案，选择对应的解决方案申请开通。审核时效 3 个工作日。
综合到店提货解决方案
生成 access-token
通过请求参数ClientKey&ClientSecret调用/oauth/client_token/生成的token，此token不需要用户授权。示例: clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
参考 client_token 接口：https://developer.open-douyin.com/docs/resource/zh-CN/local-life/develop/OpenAPI/preparation/client_token，body 返回 access-token
注意：需每2小时更新（开发阶段给到的测试账号不同，按对应文档说明使用，参考步骤2）
商家回调地址配置
系统已支持线上配置SPI，技术服务商可线上配置：
使用SPI接口涉及：创建订单、通知支付结果、申请退款、三方码发放凭证、申请退货、超时退货通知
目前已支持线上配置webhook，在开发设置中配置：
接口对接场景
整体流程图
抖音码场景
时序图
接口清单
三方码场景
业务场景/能力 | 是否必接 | 接口 | 说明 |
商品管理 来客端创品可以不接商品接口 | 非来客创品，必接 | 查询提货券门店库存 | |
非来客创品，必接 | 创建/查询抖音团购商品 | ||
可选 | | ||
非来客创品，必接 | | ||
提货券三方码交易能力 | 必接 | 通知外部商家创单 | |
必接 | 通知外部商家支付成功 | ||
必接 | 通知外部商家取消订单 | ||
必接 | 发券接口 | ||
| 必接 | 发券回调接口 | |
| 必接 | 验券接口 | |
| 必接 | 撤销核销接口 | |
| 可选 | 券状态批量查询 | |
| 必接 | 商家退款申请 | |
| 必接 | 退款审核回调接口 | |
| 必接 | 退款通知接口 |
