景区从分销渠道接单，核销完要把结果回传过去，否则对方结不了账。听着只是一个接口，实际要提前约定五件事：传哪些字段、什么频次、失败怎么重试、重复怎么去重、两边不一致时以哪边为准。

一、字段。够用的组合是外部订单号、票号、核销时间、通道或闸机编号、核销次数序号、核验结果、数量。证件号与手机号不回传，渠道要的是这张票用掉了，不是这个人是谁。票务系统的接口日志里出现完整证件号，验收时要专门查这一项。跨零点入园的场子，还要写明用的是本地时间还是带时区，这个字段上吃过亏的景区不少。

二、实时还是批量。两个都要。实时链路负责当日体验：闸机本地队列出队，正常情况下三到五秒内到渠道，网络断了先落本地，恢复后补发。批量兜底负责完整：每十分钟跑一轮差异比对，把本地有而渠道没有的记录补齐。日终再一次全量核对，当天二十三点以后启动，把核销明细钉死。只做实时，一次网络抖动就漏一片；只做批量，渠道侧报表永远滞后十几分钟，客服会被反复打断。

三、失败重试几次。三次是常见值，间隔一档一分钟、二档五分钟、三档十五分钟，都失败就进死信表转人工，不要无限重试。重试必须带同一个幂等键，用票号加核销次数序号最稳，通道编号做辅助。不要拿时间戳当键：同一次核销重发时时间戳是新的，渠道就会记成两次。

四、重复回传怎么去重。渠道侧按票号唯一，同票号同结果丢弃，同票号不同结果只报警不覆盖。票务系统这边要防的是重复出队：通道断网重连时本地队列可能整批重发，几百条一起过去。做法是回传记录带上本地流水序号，序号连续、缺口可查，渠道方收到不连续的序号就主动来拉一次，这比两边各自猜省事。

五、不一致时以哪边为准。入园事实以本地检票记录为准，那是闸机产生的，游客确实进来了。结算以双方对账一致的部分为准，差额单独挂账，等下一轮核实，不做单边覆盖。最坏的处理方式是渠道说没核销就改本地，一夜之间核销明细被回退几百条，当天的客流曲线直接变形。

六、验收要真跑的三个场景。第一个是断网：把通道外网拔掉半小时再恢复，看积压的核销记录能不能全数补发，本地队列容量要按高峰期半小时的量留，补发时长控制在两分钟以内。第二个是重发：通道重连时人为让它把同一批再推一遍，看渠道侧收到几条，正确结果是一条都不多。第三个是跨零点：夜场票在二十三点五十九分刷、零点上进入，核销时间落在哪一天，第二天报表按哪天算，这三条都跑通再谈上线。只在正常流程上点一次就验收的，第一次真掉数据时没人知道该查哪一段。