会员通-抖音商家接入方案2.0

一、简介

本文档对象为商家IT团队，旨在帮助商家快速接入会员通服务，接入前请务必先阅读 会员通接入须知，准备好相关物料。目前会员通服务提供三大能力，包含会员绑定解绑、会员订单同步、会员数据回传更新，商家需完整接入后，才能开启完整的会员通服务。

二、接入流程

如图所示，会员通服务的接入流程主要分为以上七部分。下面介绍每一部分的详细接入流程。

2.1 创建自研应用

接入会员通服务前，商家需先入驻开放平台并完成认证，创建自用型应用，最后完成店铺授权。具体创建流程见：抖店开放平台

如已有自用型应用，可直接进入下一步。

注：开发者手机号与店铺管理人手机号要一致。点击并登陆抖店，左侧「店铺」模块点击「店铺设置」，在「基本信息」栏可以看到管理人及其手机号。

2.2 SPI会员接口实现

商家需实现 SPI-会员场景接口（包含绑定和解绑接口），保证用户在抖音APP上使用会员通服务时，会员通Server端可以将用户的绑定和解绑请求正确发送给商家Server。具体可进入开放平台控制台，查看会员通接入的相关接口，具体接入可参考对应文档。如果在开放平台后台看不到SPI菜单，请给会员通业务同学发下「开放平台注册手机号」和「appkey」进行授权。

可单击上图中“查看场景接口”，进入接口列表页面。

这里可以点击“查看文档”来查看相关文档进行接口的开发，开放平台控制台提供了相应的接口测试工具，来支持商家进行接口测试。接口验签部分可参照文档：抖店开放平台SPI网关接入文档

相关接口开发完后，可以立即进行发布，发布成功的话，可以进入会员数据更新的开发。

注：商家需尽量确保相应接口的耗时尽量在500MS 以内，耗时过长会影响用户体验

2.3 会员订单识别处理

商家需接入开放平台新的订单接口 “/order/searchList” 和 “/order/orderDetail”，新的订单接口会返回“doudian_open_id”字段，可以用来和SPI会员绑定接口中的OpenID 进行比对，来识别是否是会员用户的订单。具体请参考：订单API接口文档

商家识别出会员用户的订单后，可根据商家自己的会员规则，对用户的积分和等级进行累计更新等。会员用户的积分或等级数据有变更后，商家需调用接口，同步最新的会员数据给抖店会员服务。从而支持用户在抖音APP内，能看到自己在商家侧最新的会员等级和积分等数据。

2.4 会员数据更新

抖店会员通服务提供了独立的会员数据更新接口，商家可调用此接口来更新抖店侧会员用户的数据。具体接口定义如下（调用传参等与调用开放平台公开的API接口一致，参照：开放平台API调用指南）：

业务参数：

2.5 会员体系开通

在抖店后台完成会员体系开通，并配置会员等级名称、开卡礼等：https://fxg.jinritemai.com/ffa/mvip/level/manage

若无权限，请找会员通同学开通。

2.6 线上灰度验证

商家应完成所有的开发工作后，此时可联系抖音会员侧运营同学，获取商家的会员灰度验证链接，使用抖音APP扫码后，即可进入会员页面，这里商家可以自行体验会员服务的全流程，以验证自己相关服务的正确性。

2.7 抖音会员入口放开

商家进行会员服务的灰度验证后，如服务一切正常，可联系会员通业务同学，授权并开通品牌号后台的会员通入口。至此，普通用户可在商家抖音账号的商家菜单下，体验商家的会员服务。

配置详情见：“会员通”商家端会员配置sop

三、常见问题

SPI接口实现时，如何进行接口鉴权，校验请求的合法性？

商家实现SPI接口时，必须校验请求的合法性。具体校验方式见抖店开放平台SPI网关接入文档（For 软件服务商 or 自研商家）

为何开放平台控制台看不到SPI菜单？

目前只有授权的商家可以看到相应的菜单，添加授权可联系会员通业务同学，只需要提供自用型应用的APPKEY即可。

会员数据更新接口没有权限？

联系会员通业务同学即可，业务同学会协助添加权限。

我们的服务有IP限制，哪里有开放平台的出口IP地址？

授权可以接入会员通的商家，可以联系会员通业务同学来获取对应IP列表。

多个店铺是否支持会员数据打通？

目前不支持。当前的openId 数据是用户在某一个店铺的唯一对外标识，同一用户在不同店铺下的openId 数据不同。

订单上的 doudian_open_id 和 会员SPI 相关接口中的 open_id 是否可以直接对比来识别会员用户？

可以直接来对比，两者均不需要做任何的加解密操作。

订单数据是从消息渠道获取，没有OpenId怎么办？

建议从消息拿到订单数据后，使用订单ID去调用新的订单详情接口 /order/orderDetail，此接口的返回里会有doudian_open_id 字段。