美团门票分销接口(手工上单转直连)

自我游发表于:2023年05月09日 17:34:29更新于:2025年05月23日 15:16:02

修改人:树丹

修改时间:2025-5-22

前提:

需要在美团平台开通店铺。


注意事项:

①目前只支持景区门票产品对接

②订单退款:需要客人在美团端发起退款请求,收到退款申请后必须在24小时内处理退款,如逾期未处理造成损失,自行承担。关于退改时限要求会有调整,请以各平台官方通告为准。

③过期退款:订单超过有效期后,美团会自动发起退款请求,收到退款申请后必须在24小时内处理退款,如逾期未处理造成损失,自行承担。关于退改时限要求会有调整,请以各平台官方通告为准。

④消费后退款:联系美团客服人工处理

⑤支持码类型:一单一码,一票一码⑥配置接口后,必须进行测试,完成测试后才可进行正式销售。

⑦美团退款设置:A+B=C组合打包产品不支持实名制核销以及退款,选择普通退款及核销

一、接口实现功能

下单同步
出票同步
价格及库存同步(需要在美团后台拉取自我游价格和库存,不能直接通过自我游系统推送)
订单核销同步
订单取消同步

****温馨提示**** :API接口受网络影响较大,会存在一定风险,请运营商时刻留意接口订单状态及订单收款,如有问题,请联系自我游公众号:自我游运营中心

二、美团平台提供参数

①partnterId(美团商务可能叫做供应商ID)

②美团后台配置时选择“自我游分时”-BD手工上单(新)
图片.png

三、自我游商户需提供参数

①客服电话

②营业开始时间

③营业结束时间

④分销商id【分销商需要设置授信额度,接口支付方式:授信扣除】
图片.png


四、自我游后台常规门票产品发布

4.1 发布对应类目

支持类目:门票,套餐,打包(A产品+B产品组合打包)
图片.png图片.png图片.png

4.2 常规门票产品发布注意事项

①开售时间范围设置:开售时间开始为产品推送上架当天时间,如没开售时间范围设置要求可不设置

②有效期设置
图片.png

③预订成功短信
按照实际情况设置,如需发送短信:编辑好短信模板【二维码代码:$url$,数字码代码:$password$】

图片.png
④生成通知设置选择第三项
图片.png

⑤自营产品出票设置选择为“不需要”
图片.png


⑥对接供应商接口出票设置:出票设置选择为“需要”,自我游商户发送短信,设置出票短信,短信内容$excode$(获取景区数字码),$excode2$(获取景区二维码)
图片.png


⑦应到未到:人工做退改处理(如果支持多次验证必选这项)
图片.png

⑧销售对象:同行和直客
图片.png
⑨销售范围:PC版本(b2b版本) ,H5手机版本(包含b2b和b2c两个版本)
图片.png


五、场次产品发布流程

①自我游产品场次时间设置好

image.png

image.png

②美团产品类型设置选择“演出票”

在演出设置的位置点击【拉取演出信息】可抓取自我游系统的价格及库存和场次信息,具体演出门票发布流程操作手册可联系美团商务提供

image.png



image.png


六、自我游系统产品推送授权

①产品授权

需要在美团售卖的产品都必须在此界面操作授权的操作,没操作产品授权会导致下单失败,订单同步不到自我游系统

图片.png

图片.png

随时退:需要人工审核的选项。

不可退:是不允许退款的选项。

有条件退:如果符合产品管理里面设置的退款规则,可以随时退,不符合的话会进入到退改申请里面。

②二维码入园:

产品是返回二维码凭证给美团的选择“是”,如只有数字码返回就选择“否”
图片.png

③美团退款设置:

A+B=C组合打包产品不支持实名制核销以及退款,选择普通退款及核销
image.png


七、美团后台发布产品

7.1 新建产品—》手工上单转直连

图片.png
7.2 产品基本信息
图片.png

7.3 价格/库存/有效期

①日期设置:无需用户指定使用日期对应自我游系统产品设置的是期票有效期模式

②使用日期模式,需要用户指定使用日期,自所选日期起xxx天内可使用对应自我游系统产品设置的是日历票)   

③日期价格——》拉取日历价格        
图片.png

7.4 购买使用说明

①预定限制说明:设置和自我游系统产品限购一致

② 入园方式:下单凭证选择“是“,自我游返码美团才会接收

③入园凭证:根据自我游系统返回的入园凭证类型选择
图片.png


八、查看没同步到自我游系统的订单
图片.png


九、订单退款处理

温馨提示:美团退款申请一定要在24小时内处理,24小时内没有处理退款,美团会自动退款给游客。如逾期未处理造成损失,自行承担。

9.1 自营订单退款处理

①如接口要求自营产品需要人工审核,客人在美团发起退款申请,自我游商户必须在自我游系统【退改申请处理】,点击【处理】。自我游商户请勿对订单做异常处理,此操作退款状态是无法同步到美团。
②如产品有设置退款规则:客人发起退款申请时,系统会自动抓取退款规则,符合规则就无需审核,直接退款。

9.2 对接第三方供应商系统的订单退款处理

①客人在美团发起退款申请,如该订单对接的供应商接口还没升级自动推送退款请求,运营商需在【订单管理】给订单操作“异常处理”允许取消并点击退款后,取消的申请才会下发到供应商系统。,等供应商返回退款处理结果。(退改申请处理里暂时不要进行任何操作) ,供应商同意退款,运营商再回到自我游【退改申请处理】,点击【处理】“同意取消”。若供应商拒绝退款,点击“拒绝取消”。状态会直接同步到美团。


②客人在美团发起退款申请,该订单对接的供应商接口可实现自动推送退款请求,接口自动将退款信息推送给供应商,等供应商返回退款处理结果。(退改申请处理里暂时不要进行任何操作) ,等供应商返回“同意退款”或“拒绝退款”状态给自我游,自我游再推送给美团


十、常见问题

Q:自营产品如何设置返二维码给到美团?

A:①产品绑定的供应商需勾选对应随机码验证内容

image.png

②产品游客入园设置选择【二维码凭证】

image.png

③【渠道管理】--【美团门票v2】--【退款设置】需要勾选上支持返二维码链接

image.png

④美团后入园凭证也选择商家二维码

image.png


Q:美团拉取价格日历数据失败

A:①检查产品是否有价格库存(可用对应的美团分销商进行代客录单检测)

②【渠道管理】--【美团门票v2】是否有操作授权产品

image.png

③咨询商家该美团店铺是否同时配置了多套自我游系统上

注意:一个美团店铺参数只能配置在一个自我游系统上


Q:美团后台的订单详情不展示二维码

A:①查看返回给美团的二维码链接是否符合美团的要求

注意:美团只接受长连接,二维码链接为图片格式png或者jpg,二维码上不能含有文字;pdf导入的二维码图片不支持返给到美团渠道。

产品游客入园设置选择‘二维码凭证’

image.png

③【渠道管理】--【美团门票v2】--【退款设置】需要勾选上支持返二维码链接

image.png


Q:美团下单之后 ,订单没同步自我游系统上

A:【渠道管理】--【美团门票v2】是否有操作授权产品

image.png

②【渠道管理】--【美团门票v2】--【进入日志管理】点击渠道日志进去查看对应的报错,根据提示进行检查

image.png

    您需要登录后才可以回复