大数跨境

快手本地生活(原生自建团购)对接

快手本地生活(原生自建团购)对接 自我游运营中心
2026-07-03
1
导读:【主题】自我游营销系统——优惠券使用手册【时间】2026年7月7日(周二)14:30--15:00【方式】请关注微信公众号“自我游运营中心”,进入直播间听取相关内容分享。为保证分享质量,请在开始前3~
对接前提

1.已注册快手本地生活商家账号并通过资质审核:

http://lbs.kuaishou.com/league/login

2.已有自我游SaaS系统运营商账户。


对接注意事项:


1、 下单后20分钟不出票,快手会自动退款给客人。*快手会把退款状态传给自我游但是有缓存时间,查询准确订单状态建议商家到快手后台核实 。

2、 如需发布日历产品,请参考《快手本地生活-日历票对接帮助手册》

3、仅支持自我游门票、套餐、抢购类目产品对接,使用其他产品对接造成损失商家自行承担后果。

4、 无发码限制,支持一人一码、一单一码或无码(无码必须下单填写身份证,身份证核销)

5、订单退款: 暂时不支持设置退款扣手续费,支持一单多套部分套数发起退款。 客人在快手端发起退款请求,收到退款申请后 必须在72小时内处理退款 ,如无按时处理订单审核, 快手会自动强制退款给客人。(快手会监控退款时长超过3小时的订单,因为会对用户体验有影响,快手后期会对退款时效慢的商家做处罚)

6、过期退款: 下单成功的订单无法调整有效期,当 订单超过有效期后,快手会自动发起退款请求,收到退款申请后 必须在72小时内处理退款 ,如无按时处理订单审核, 快手会自动强制退款给客人。

7、撤回核销: 验证后一个小时内 ,支持在自我游后台"渠道门票对接管理"页面找到对应订单撤回核销操作 ,商家撤回核销后可再处理退款。

8、产品延期:需要在自我游系统和快手后台 都共同延期。如使用自我游产品同步到快手,在自我游后台修改产品后,操作同步产品到快手审核成功则双方系统产品延期成功。

9、快手本地生活商家必须要在快手后台先认领门票POI,POI关联后才能推送产品同步。

10、请在有效期内及时核销订单,订单有效期过期无法同步核销。如:有效期至6月16日,过期后6月17日核销则无法同步。


对接详细流程说明

一.提供以下参数给自我游配置快手本地生活接口

自我游系统网址:

渠道接口备注名称:

快手账号ID:

商家ID:

备注:本地生活商家账号登录后台,点击右上角商家名称就可以看到快手账号id和商家id。

客服电话:

客服服务开始时间:

客服服务结束时间:

绑定接口的分销商id:【分销商需要设置授信额度,接口支付方式:授信扣除】


二、授权自我游


接口配置后,会收到短信提醒授权自我游。 店铺主账号在PC端商家中心-店铺管理-应用授权下操作“去授权”,或在APP内我的店铺-生活服务-商家应用-应用授权下操作“去授权”,将跳转到授权页面。 店铺主账号确认应用、权限组等信息,点击“授权并登陆”。


三 、产品POI关联

注意: 快手本地生活 商家必须要在快手后台先认领门票POI,POI关联后才能推送产品同步。

自我游 后台 【渠道门票对接管理】--【进入管理】,点击【POI关联】

搜索产品对应的自我游景点ID(POI管理只会显示产品管理中已有绑定的景点) 点击手工绑定门店,填写快手POIID(注意:快手poiid为纯数字)

已在快手绑定门店,自我游点击快手POI管理,可直接复制POIID填写

设置适用人群


四、 自我游后台发布产品

1、 选择对应类目发布产品 ( 目前支持类目:门票,套餐 )

2、 发布产品注意事项

①产品限购设置

限制数量0为不限制,限制请填写>0的数字。 如设置身份证或手机号限购,上方最大预定数不可设置0

②设置产品有效期

③身份证设置

如产品无码或使用身份证验证,必须要勾选填写身份证 如实名制票种情况,客人资料要求:勾选要求输入每个客人资料

④发码及短信设置:【预订成功短信&出票短信二选一】

按照实际情况设置,如果需要自我游发送短信的话:

第一种:产品没有对接第三方供应系统/自我游码库发码,可以用预订成功短信:

编辑好短信模板【二维码代码:$url$,数字码代码:$password$】

第二种:产品对接了第三方供应系统/自我游码库发码,可以用出票短信:

*门票类目:通知单选择在预订(支付)成功后自动锁定订单,无需生成通知单

*出票:需要

*出票短信:编辑好短信模板【二维码代码:$excode2$,数字码代码:$excode$】

*对应接口:选择对应接口

供应商产品编码:绑定供应商系统产品编码(按实际情况设置)/码库编码

⑤ 订单自动完成:必须人工验证订单才能完成状态

⑥ 门票类目应到未到处理:人工做退改处理(如果支持多次验证必选这项)

⑦设置一人一码,发码数量选择包含人数发码

⑧设置图片头图:图片格式需大于360*360,并点击标志图

3、供应商账号设置核销配置

是否可以验证:建议选择支持供应商验证(订单多次,不支持增值项目多次)

二维码内容:验证码转成二维码

支持验证内容:勾选实际支持进行核销验证方式。如无码或者使用身份证核销,必须要勾选身份证


五、推送产品(产品授权--推送产品给快手)

产品授权有两种方式,二选一操作:

①无需在快手后台手动创建产品,自我游产品直接推送产品同步到快手后台; ②快手后台已创建产品,在快手后台绑定自我游产品编码

第一种:自我游产品同步到快手

1、【渠道门票对接管理】--【产品授权】

对应接口点击产品授权

选择对应产品点击授权

授权后点击信息设置,完善信息后保存设置,点击同步产品。

注意: ① 快手产品编码为空不填,同步成功后自动会绑定快手编码。 ② 快手 商品类目 按照实际快手POI类型选择。③目前只支持一级类目游玩、住宿、度假旅游服务下的所有三级类目

快手POI类目查看方式:快手搜索POI名称,选择地点。名称左下角的是POI类目

同步产品后审核状态显示【待审核】。

当审核通过,手工点击上架同步,显示审核通过,快手后台产品即可下单。



第二种: 快手后台已创建产品,在快手后台绑定自我游产品编码

快手后台发布产品,填写自我游编码。

格式按照:自我游产品id_分销商id(注意:分销商编号为步骤一中配置快手接口的分销商编号)

选择服务商名称:自我游门票酒旅

商家系统sku编码格式:产品id_分销商id_产品id_分销商id

自我游选择对应产品点击授权

授权后点击信息设置,必须填写快手产品编码,完善信息后保存设置

点击【同步产品】,直接点击【上架同步】,后续产品上下架会同步状态。


验证后一个小时内撤回核销操作

点击"渠道门票对接管理”,进入日志管理,显示所有快手订单,关键字搜索自我游或快手单号。

点击"券码详情”跳转到券码状态及"撤销核销"。

注意:所有已核销订单都会显示"撤销核销"的操作按钮,但是只有验证后一个小时内的订单点击才会撤销成功。撤销成功后自我游订单状态还是已完成不变,只有快手核销状态会撤销。


六、下单测试【对接完成后必须按照以下情况分别下单进行测试】

①发码环节测试(测试发码数量是否与预定数量一致)

一次下单张数量,一次下多张数量

②取消环节测试

整单取消,未核销情况下申请部分数量取消,部分数量核销后取消,另外未核销数量申请取消,

取消申请审核中,对订单申请取消数量进行核销,

取消申请审核中,对订单未申请取消数量进行核销

③核销环节测试

整单核销,分次进行核销 注意:请在有效期内及时核销订单,订单有效期过期无法同步核销。如:有效期至6月16日,过期后6月17日核销则无法同步。

快手对接常见问题

Q 1 : 同步产品报错  同步失败:1

A1:检查产品是否有产品库存,并点击“信息设置”,检查快手商品类目是否对应POI类目选择

Q 2 :客人成功下单后 自我游订单管理没有生成订单,快手 10分钟后自动退款

A2:点击渠道门票对接管理,进入日志管理。点击对应快手订单号,可查看报错原因

Q3:同步失败:团购价应小于9999999.99元!

A3:检查以下项目

①检查自我游后台,产品销售时间是否开售。

② 检查自我游后台,最大可预订天数,建议设置0。

③检查自我游后台,价格库存:是否有设置开始销售日期--游玩结束日期的价格库存。

(ex:产品开售时间23/1/10-23/1/15,可游玩日期:23/1/10-23/3/31,那需设置23/1/10-23/3/31的价格库存)

Q4:快手是否支持授权多个服务商

A4:快手支持一个账号授权多个服务商,但是一个产品只能选择一个服务商发码,产品选择了某个服务商的应用后,该产品就无法修改选择其他服务商。


Q5:快手后台产品绑定过别的服务商,要更换成自我游服务商发码,已授权自我游,但是产品无法选择自我游服务商

A5: 产品一旦绑定了某个服务商的应用是不支持修改的, 只能重新发布产品才能选择自我游

    

Q6:同步失败:商品创建失败,图片头图不可为空

A6:产品详情上传的图片标志图格式需大于360*360像素


Q7:快手产品同步失败:该商户商品列表中有不唯一的商品

A7:因为快手不能重复创建相同产品编码,如果快手后台出现了2个产品信息,要删掉其中一个。


Q8:快手团购产品是从自我游推送过去的,但是产生订单没有到自我游系统并且不是自我游发码,变成了快手发码。

A8:1、修改产品如果保存操作太快右侧的诊断还没完成,保存的时候会有几率保存信息不成功

2、建议每次在快手后台修改完产品,点进去查看  【选择接入系统】这个位置有没有绑定成功自我游


Q9:快手下单日志报错  “请求参数不合法”

A9:联系自我游运营中心检查接口参数是否配置错误,修改之后在快手解除授权再重新授权自我游应用。


Q10:同步产品报错:同步失败:出票方式不支持更新

A10:原因:快手目前只支持一级类目游玩、住宿、度假旅游服务下的所有三级类目,及一级类目休闲娱乐下 洗浴按摩-洗浴中心下的所有三级类目产品推送。

如选择的一级类目是演出赛事,即非以上一级类目,同步产品就会出现以上报错。








【声明】内容源于网络
0
0
自我游运营中心
为公司客户提供咨询,运营培训,客服服务等
内容 148
粉丝 0
自我游运营中心 为公司客户提供咨询,运营培训,客服服务等
总阅读293
粉丝0
内容148