大麦渠道接口对接操作指南

自我游发表于:2025年06月24日 17:18:25更新于:2025年07月11日 15:42:36

对接前提:

运营商需在大麦店铺并且跟大麦达成签署合作协议,推送的景点必须要经大麦商务报备

 

接口功能说明

1、支持对接自我游产品类目:门票、抢购,支持对接日历票及期票产品

2、大麦渠道出票是需要套数对应游客信息数量及码数量,比如:下两套就只能填写两个游客信息出票两个码,下三套填写一个游客信息三个码或者下一套三个游客信息一个码都会出现错误
(当双人票只需要填写一个信息,发一个码双人同时入园是可以对接成功的)

3、大麦产品上架后更改无法二次同步退款规则(产品同步上线后,修改退改规则,只能重新发布产品)如需修改产品详情介绍或名称等信息,也要大麦商务后台修改,无法同步推送。

4、支持部分核销,但订单无法部分退款及扣手续费退,只能整单并且全额退款。

5、大麦目前无法在前端限购客人下单最大预定数量,如避免客人下一单多套部分使用后不可部分退,建议在详情页写明:不支持部分退,建议一次只能下一套,多套请分开下单。

6、客人在大麦下单默认不需要填写联系人信息,系统会默认传其中一个游玩人信息作为联系人。

7、日历票每次只能推送展示100天内的库存,自我游每天会推送一次库存给大麦更新。

 

发布操作步骤如下:

一、提供以下参数给自我游配置接口并开通大麦门票管理功能

key账户:

secret秘钥:

url请求地址:

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

001685a6c3168be13cad30d4e6a118c

001685a6c35673e95cbb39f60413073

 

自我游配置完毕,提供回调地址给大麦配置

锁定订单: https://task-api.zowoyoo.com/api/damai/ticket/travel/lockOrder

创建订单: https://task-api.zowoyoo.com/api/damai/ticket/travel/createOrder

获取电子票凭证:

https://task-api.zowoyoo.com/api/damai/ticket/travel/getEticketUrl

取消订单: https://task-api.zowoyoo.com/api/damai/ticket/travel/cancelOrder

可退检查: https://task-api.zowoyoo.com/api/damai/ticket/travel/refundVerify

退款申请: https://task-api.zowoyoo.com/api/damai/ticket/travel/refundOrder

查询订单信息:https://task-api.zowoyoo.com/api/damai/ticket/travel/orderQuery

 

二、大麦新增景区的信息

提供景区名称、地址、自我游景点ID信息,通知大麦商务创建大麦场馆,并和提供的景区做映射,映射完成后才能推送对应景区的产品。

 

三、自我游后台发布产品

3.1 选择对应类目发布产品

目前支持类目:门票,抢购

0016870bf2f841bfc470d54dd71f5ac 

3.2设置景点和包含人数

景点id必须跟大麦商务报备处理过,否则推送后产品不会显示在大麦

包含人数:1成人(不管双人票还是多人票都选1成人) 0016870bcadc203be1655b9d713ac3f

3.3订单确认方式:自动确认

0016870bcb4114a2183669072e1cc35

3.4有效期设置

日历票选择:游客选定的游玩日期当天有效

期票在游客预订日期截止到指定日期xx有效 或 指定日期xx到xx内有效二选一设置

其他选择均无效

001685a6c72cec40da995f2d46eefad 

3.5订单退款设置:

根据产品实际情况设置退款规则,

001685a6c8b224762479676b85e685c 

3.6客人资料要求:

根据产品实际情况选择填写每人资料,以及是否需要有效证件信息

(为对应大麦一套一人一码的要求,都是选择每个游客填写。)

001685a6c96c1a087d0376f94df770e

3.7发码数量

设置一人一码,按预定套数发码。

 001685a6c9f6cd2294496541aa3b989

3.8通知单&出票设置

通知单生成设置:在预订时(支付)成功后自动锁定订单,无需生成通知单

出票环节:如果产品有对接第三方景区系统,则选择:出票

出票短信:根据产品实际情况设置是否需要发送出票短信

001685a6ca8998164e3e47b76ebb59f 

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

001685a6cb9830e463551e3cbf473c9 

3.10接口信息:如果产品有对接第三方景区系统,需要选择对应接口并填写对方系统产品编码

001685a6cc16b0c04721fc3025467c5 

3.11产品描述:
先点击【上传】上传图片后,点击【标志图】按钮(上传后会展示在抖音app产品详情页banner图位置)

对应填写产品介绍(产品介绍暂不支持推送图片)

001685a6cc961f0f7b1eb15cf8c93d9 

产品费用包含、费用不含、退款说明、使用说明填写后都会同步给大麦,展示在产品内。

001685a6cd27936b7077a0a73791094 

3.12设置产品价格库存

001685a6cd9d164106b220c96ee741a 

期票产品:设置的价格库存时间需要涵盖下单时间及有效期(如售卖时间为2月1日开始,产品有效期是3月1日至12月31日,价格库存需要设置2月1日至12月31日)

日历票产品:设置可售卖的价格库存时间

001685a6ce0dee3f2092b3a38611118 

四、推送产品同步到大麦

【大麦门票管理】功能点击产品管理

001685a6cf061b3837dbe6dd63ffb8a 

对需要推送的产品点击授权,(注意产品要设置好标志图否则推送失败)授权后要联系大麦商务,审核通过才可以上架

001685a6ced95bc4d74d944415bf886

产品更新:

更新期票有效期及销售时间、费用包含等信息点击[更新产品内容]。*更新产品内容不包含更新产品标题及产品详情文字描述)

日历票更新价格库存点击[同步价格]

0016870bd43aea787ae61ba71357788

注意:

大麦产品上架后更改无法二次同步退款规则(产品同步上线后,修改退改规则,只能重新发布产品再推送)如需修改产品内容或名称等信息,也要大麦商务后台修改,无法同步推送。

产品下架:提供产品名称联系大麦商务处理下架


五、常见问题汇总


Q1:大麦同步产品报错:推送失败:接口调用异常

A2:出现此报错再点击一下旁边的更新产品内容,推送给大麦

0016870bdfe979021b7c5a0ab42dc36

Q2:客人在大麦下单支付失败,自我游订单管理没有订单,查看具体报错

A2:在大麦门票管理中,点击进入日志管理,搜索大麦单号或者筛选对接失败,查看日记可以看到具体报错原因

001685a6d12460bc4d4d43526863fe8001685a6d1238e0b700bbca35a22293001685a6d11e950ed2b9dcb8a538074

 

常见报错:
锁单失败:单价不匹配
检查产品零售价是否跟大麦销售价一致,或分销价是否等于零售价


    您需要登录后才可以回复