接口编码：2480

接口实现功能

支持订单同步

支持退款同步

支持核销同步

温馨提示：API接口受网络影响较大，会存在一定风险，商家需每日查看接口订单状态、订单退改、订单核销和退款是否同步（ 渠道方收到退款申请，要到供应端查看订单状态），及时处理。如有问题无法处理，请联系自我游公众号【自我游运营中心】寻求帮助。如商户做促销推广，直播等，应视情况先暂停产品销售，并联系自我游寻求帮助。

对接前提

1.已注册快手本地生活商家账号并通过资质审核（https://lbs.kuaishou.com/league/login）

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

对接注意事项：

1、10分钟不出票快手就自动退款给客人

2、只支持自我游门票、套餐产品对接

3、无发码限制，支持一人一码、一单一码或无码（无码必须下单填写身份证，身份证核销）

4、订单退款：需要客人在快手端发起退款请求，收到退款申请后必须在 72小时内处理退款，如无按时处理订单审核，快手会自动强制退款给客人。（快手会监控退款时长超过3小时的订单，因为会对用户体验有影响，快手后期会对退款时效慢的商家做处罚）

5、过期退款：订单超过有效期后，快手会自动发起退款请求，收到退款申请后必须在 72小时内处理退款，如无按时处理订单审核，快手会自动强制退款给客人。

6、撤回核销：验证后一个小时内支持在自我游后台操作撤销核销，过期不可撤销核销，撤销后自我游后台订单状态不变。

7、目前只支持整单或者验证后剩余全部退。（如果需要部分退款，快手后台发起退款不能选择张数。需要自我游或景区先验证不可退数量后，再让客人在快手发起申请退款剩余数量，不能进行二次退款）

8、产品延期：需要在自我游系统和快手后台同时操作延期。

9、快手本地生活商家必须要在快手后台先认领门票POI，POI关联后添加适用人群的设置才能推送产品同步。

10、如需发布快手期票产品，请参考《快手本地生活(原生自建团购)》

11、如接口已配置，后期要增加对接场次产品，必须在自我游重新配置新接口后再到快手后台确认应用授权。

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

1、自我游系统网址：

2、渠道接口备注名称：

3、快手账号ID：

4、商家ID：

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

5、客服电话：

6、绑定接口的分销商id：

【分销商需要设置授信额度，接口支付方式：授信扣除】

二、授权自我游

自我游配置完接口后，商家自行到快手店铺后台去确认应用授权

应用名称：自我游门票酒旅

三、产品POI关联

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

自我游后台【渠道门票对接管理】--【进入管理】，点击【POI关联】 --手工绑定快手门店

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

设置适用人群

适用人群中特殊说明必须要填写完善，否则保存会失败

设置后点击poi产品推送

四、自我游后台发布产品

1、选择对应类目发布产品（目前支持类目：门票，套餐）

2、发布产品注意事项

3、短信【预订成功短信&出票短信二选一】

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

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

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

② ：产品对接了第三方供应系统/自我游码库发码，可以用出票短信：

编辑好短信模板【二维码代码：$excode2$，数字码代码：$excode$】

4、订单自动完成：必须人工验证订单才能完成状态

5、门票类目应到未到处理：人工做退改处理（如果支持多次验证必选这项）

6、设置一人一码

001679311c90e2d2f8e8a3da6ad8a1a

注意：如果是一单一码，产品必须设置限购一张

7、购买须知设置

快手产品点开购买须知中的其他规则，在产品设置内设置费用包含及费用不含

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

是否可以验证：建议选择支持供应商验证（订单多次，不支持增值项目多次）

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

支持验证内容：勾选实际支持进行核销验证方式

五、推送产品（产品授权--推送产品给快手）

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

2、选择需要上架的产品--【授权】

3、授权后点击【信息设置】，完善信息后保存设置，点击同步产品。

注意：目前自我游是直接推送产品同步给快手

商品类目：按照实际选择

入园开始/结束时间：按实际情况填写时间，其中:需要切换英文小写

商品详情内容/商品详情图：填写/上传后，会展示在产品点开的图文详情（无场次产品点开才会有图文详情）

001677bbd5f9af1ee832afac3c5b65a

设置完毕保存后同步产品

4、同步产品，审核通过后上架.

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

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

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

②取消环节测试

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

注意：目前只支持整单或者验证后剩余全部退（如果需要部分退款，快手后台发起退款不能选择张数。需要自我游或景区先验证不可退数量后，再让客人在快手发起申请退款剩余数量，不能进行二次退款。）

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

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

③核销环节测试

整单核销，分次进行核销

七、常见问题

Q 1 ：同步产品报错：同步失败:商品创建失败, 图片头图不可为空

A1：【产品描述】没有上传图片或者上传的图片尺寸过小，需要删除后重新上传图片

Q 2 ：快手日历票同步产品的时候提示报错：同步失败:模板不存在三级类目id:70100004,商品类型:日历票

A2：日历票是有指定类目的，目前支持日历票的类目如下图，其他类目同步就会报错

Q3：同步产品提示：同步失败：可用时间格式不正确

A3：注意【信息设置】里面的时间格式：

Q4：同步产品报错：同步失败:创建/编辑商品失败，图文描述不支持富文本格式内容

00165bcb11a4071553a2accb91400ff

A4：要检查推送的快手【信息设置】内，产品详情内容是不是出现<>等特殊符号

00165bcb16622e8c60c9e347bd9eaa5

00165bcb16c126b2fc1b744f007f61a

Q5：信息设置--商品类目没法选择

A5：检查快手后台是否正常授权

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

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

Q7：已对接快手日历票接口的运营商，如需要日历票支持场次选择

A7：联系自我游运营中心重新配置一个新应用的快手日历票接口。然后运营商再到快手店铺后台去确认应用授权。

编辑人：邓媚娜

编辑时间：2025-07-17