泰国票务一体化平台
泰国景区运营公司

景区管理

当前景区 景区展示

今日库存提醒

快捷入口

初始化租户

当前租户还没有创建景区。请先完成基础配置,再开始维护门票、库存和订单。

创建第一个景区景区由租户管理员在自己的后台创建,不在平台新增租户时预设。
设置平台名称和 Logo平台展示设置
创建门票产品门票管理
配置销售渠道渠道分销
景区名称 景区ID / attractionId 下单方式 库存设置 TTC API Key 状态 操作

景区时段设置

- · 先在景区管理维护可售时段,产品库存只选择这些时段填写库存。
时段名称 开始时间 结束时间 操作
门票名称 资源ID 上线时间 / 下线时间 售价 结算价 今日库存 状态 操作
日期范围-
已售数量(总)0
可售余量(总)0
不可售库存0
渠道名称 渠道类型 对接端 佣金 结算周期 接口密钥 状态
售票窗口

窗口组合售票

按份数购票

选择商品和规格后直接输入数量,可添加多个不同商品。

序号商品规格数量单价小计操作

使用证件购票

需要证件信息的门票在此录入;一行对应一位购票人,按份数购票时有效行数即购票份数。

序号姓名证件类型证件号商品游客备注规格金额操作
备注 证件完成后填写备注,备注栏按 Enter 新增下一位Enter 下一项Delete 删除当前游客
已选择位置请选择空闲位置

批量粘贴购票人

每行一位购票人,可用 Tab 或逗号分隔姓名和证件号。

位置管理

订单管理

未使用票可正常退票;已使用票需通过特殊退票处理,并支持按票部分退款。

订单列表

勾选订单后可批量处理全部符合条件的票。

0
订单号产品游客姓名游玩日期金额票状态操作

订单核销

待核销订单

订单查询结果

订单号 产品名称 游客姓名 证件号 游客手机 位置 销售渠道 游玩日期/时间 金额 已核销 操作

录入黑名单

黑名单管理

游客姓名 证件号 游客手机 原因备注 已购订单 待核销票数 录入时间 操作
多字段组合查询

销售趋势

销售额与退款额按收款日期展示

渠道汇总

渠道名称订单数金额佣金净收款

票种汇总

门票名称数量金额

每日流水

游玩日期订单数金额佣金净收款客单价
多字段组合查询

订单来源汇总

订单来源来源类型订单数销售数量销售额客单价已核销核销率

产品销售汇总

产品名称门票类型销售渠道订单数销售数量销售额销售均价销售占比已核销

规格销售汇总

产品名称门票规格订单数销售数量销售额销售均价销售占比已核销

每日销售

游玩日期订单数销售数量销售额客单价已核销核销率

订单明细

第 0-0 条,共 0 条
游玩日期使用时段下单时间订单号订单状态外部编码订单来源下单人产品名称销售数量销售额已核销

Visitor Detail

Visit DateTime SlotOrder TimeOrder No.External CodeOrder SourceBuyerProductVisitor NameID No.PhoneVisitor NoteStatusTicket CodeCheck-in Time

支付方式汇总

支付方式订单数售出票数销售金额退款金额实收金额

销售明细

第 0-0 条,共 0 条
销售时间游玩日期订单号票号产品单价退款金额状态渠道收款方式分销商售票员
多字段组合查询

核销趋势

核销金额按订单商品原始金额分摊

票种汇总

产品核销数量订单数核销金额

核销员汇总

核销员核销数量订单数核销金额

入口/设备汇总

入口设备核销数量订单数核销金额

核销明细

第 0-0 条,共 0 条
核销时间出票时间产品渠道订单号票号核销金额收款方式售票员分销商核销员入口设备
多字段组合查询

订单来源汇总

订单来源来源类型订单数销售数量销售额游客人数待使用已使用已取消使用率

产品销售汇总

产品名称门票类型销售渠道订单数销售数量销售额游客人数待使用已使用已取消

每日销售

游玩日期订单数销售数量销售额游客人数待使用已使用已取消使用率

游客明细

第 0-0 条,共 0 条
游玩日期使用时段下单时间订单号外部编码订单来源下单人产品名称游客姓名证件号游客手机游客备注个人状态票码核销时间

员工账号管理

维护员工移动端登录账号、景区范围与启停状态
账号 姓名 景区名称 角色 状态 创建时间 操作

接口对接

游客端应用可使用独立客户端密钥对接;本系统仅保留窗口购票出票。
应用名称类型客户端密钥状态说明
系统设置 泰国时间 - 中文 / 英文

默认地区为泰国,币种为泰铢,后台首版中文展示,接口保留英文名称字段。

时区泰国时间
币种-
语言中文 / 英文
景区币种设置 -
价格、订单和报表将使用所选币种;现有订单仍保留创建时的币种。
旅行社系统对接 一个景区账号共用凭证,景点通过 attractionId 区分

旅行社只配置一次接口地址和 API Key;大七孔、卧龙潭、天钟洞等景点分别使用自己的 attractionId,订单、核销和结算互不混淆。

旅行社接入凭证API Key 与接口状态由账号内所有景区共用。
平台展示设置 -
平台 Logo

支持 PNG、JPG、WebP 或 SVG,最大 2MB;选择后立即保存并应用。

新增景区

下单方式 同一商城内的所有商品共用这里启用的下单方式;至少选择一种。

景区库存设置

-
只允许在该天数范围内售卖和维护价格库存,按今天起算。
打开后,系统会按前一天的价格和库存自动生成库存天数内缺失的日期。

票务系统与旅行社系统对接

启用对接景区账号级配置
一套接入凭证,对接账号下全部景点

旅行社保存票务系统返回的景点、商品和规格 ID,下单时直接回传;景点无需分别开设旅行社账号。

0可对接景点 X-API-Key认证方式 AGENCY销售渠道
1
提供给旅行社的接入参数接口地址和 API Key 在同一个景区账号下共用。
平台密钥(API Key)
平台密钥仅用于旅行社调用票务系统接口;修改后必须同步更新旅行社系统。
回调验签密钥
票务系统使用此 Secret 签署核销等回调;旅行社系统必须使用同一 Secret 验证请求签名。它与平台密钥相互独立。
2
景点 ID 与业务隔离同一账号不重复开密钥;旅行社通过 attractionId 区分商品、订单、核销和结算。
联调与公网部署检查展开检查项
  1. 填写完整 HTTPS 地址,例如 https://agency.example.com/api/checkin/notice,不能只填写域名。
  2. 旅行社接口接收 POST JSON,并在处理成功后返回 HTTP 200–299。
  3. 旅行社使用独立的回调验签密钥校验 X-TTC-Signature(HMAC-SHA256),并按 X-TTC-Delivery 做幂等去重。
  4. 正式使用前确认域名证书有效,并允许票务服务器访问该地址。
  5. 只有通过旅行社 API 渠道创建的订单,在成功核销后才会发送通知;窗口订单不会通知旅行社。
服务器部署后必须检查
  1. 在票务服务器或容器内确认能解析回调域名,不能填写 localhost、127.0.0.1 或仅内网可访问的地址。
  2. 防火墙、安全组和云平台策略需要允许票务服务器出站访问回调域名的 TCP 443 端口。
  3. 服务器必须通过代理访问外网时,在部署环境配置 HTTPS_PROXY,并按需配置 NO_PROXY,随后重启服务。
  4. 回调服务必须提供受信任且完整的 HTTPS 证书链;自签名证书默认会被拒绝。
  5. 接收方应在上方超时时间内返回 2xx;3xx、4xx、5xx、超时或连接失败都按失败处理。
  6. 失败时查看票务服务日志中的 check-in notice failed/rejected,并结合 delivery_id 定位 DNS、连接、证书或响应错误。

旅行社状态回调配置

分别配置核销、退款和订单状态地址,并将发送策略应用到所选景区。

1
选择景区-
配置应用范围 -
2
设置三类状态回调核销、退款、订单状态可分别启停和配置地址,共用下方发送策略。
核销结果地址核销成功后调用旅行社提供的 /verification 地址。
旅行社核销回调地址
填写接收 POST 通知的完整 HTTP(S) 地址;可配置多个地址。
退款结果地址票务系统退款成功后调用旅行社提供的 /refund 地址。
旅行社退款回调地址
订单状态地址核销或退款改变订单状态后调用旅行社提供的 /order-status 地址。
旅行社订单状态回调地址
发送策略启用通知后,按以下规则发送和重试。

新增门票

基础信息

设置门票名称和类型。

产品备注从常用备注快速填充后仍可继续编辑,也可以直接填写。
适合床位、座位、包厢等需要逐个位置售卖或占用的门票。

管理常用备注

门票规格

规格限制 限制仅作为前端文案提醒,不影响下单;填写自定义规则后仅展示自定义文案。
Buyer identity restrictions
Enable restrictions When enabled, buyer ID verification is required before ticket creation.

请先为所属门票开启“实名制购票”,再启用身份证限制条件。

门票规格

门票规格 保存产品后可继续维护规格价格和限制条件。

产品附加项

已配置附加项附加项只参与订单计价,不占门票库存,也不生成门票。

位置管理

位置编号 容纳人数

新增渠道

新增租户

新增员工

景区名称
权限分配

修改员工密码

修改密码

操作确认

退票确认

订单管理

订单详情

订单管理

订单日志

按时间展示下单、出票、核销、改期与退款记录。

提示