更新日志

跟踪文档新增和重要更新。

遇到 API 接入问题时，可登录 Eva 寻求帮助。

用这页跟踪最近的文档新增和重要更新。

June 10, 2026

新增废票 webhook 与废票 API 文档

新增 废票通知，并更新 废票 API 参考 与相关入口页。

包括这些内容：

• 明确独立事件类型为 order.void

• 补充触发时机、payload、字段说明和 voidStatus 枚举

• 明确沿用现有 updateWebhookURL.do 注册地址即可接收

• 在 废票概览、废票 API 参考、Webhook 概览、Webhook 注册与事件、预订后 API 和 预订后概览 中补充入口链接

• 在 废票 API 参考 中增加 void.do 提交后的状态跟踪规则，以及 order.void 与 queryVoidOrders.do 的配合方式

• 在 错误码 中增加废票 webhook 排查要点

June 9, 2026

更新 seatAvailability.do 调用规则

在 预订中座位与行李、座位、验价、获取 Offer 和 验价、下单与出票错误 中统一了选座调用规则。

包括这些内容：

• 明确 Independent Mode 已下线

• 明确 seatAvailability.do 必须基于有效交易上下文调用

• 明确调用时使用 verify.do 返回的 sessionId，或 getOffers.do 返回的 offerId

• 明确仅凭航班信息不能直接调用选座接口

• 补充上游只传航班信息时的 sessionId 缓存建议

• 补充 214 的常见触发原因和处理建议

May 25, 2026

明确联程行李的下单校验规则

在 预订中座位与行李、验价、下单与出票错误 和 错误码 中补充了联程行李规则。

包括这些内容：

• 明确 getLuggage.do 按航段返回，不代表可按航段独立购买

• 明确同一方向的联程航班必须选择一致的托运行李方案

• 补充 307 的一个常见触发场景：同方向联程行李选择不一致

May 20, 2026

补充 sandbox 基础地址

在 沙箱访问、沙箱环境验证 和 沙箱开发 中补充了 sandbox 基础地址。

包括这些内容：

• 明确沙箱基础地址是 https://sandbox.atriptech.com/

• 说明调用时需在后面拼接具体接口名

• 给出 search.do 的完整示例地址

April 15, 2026

补充首次 sandbox 搜索的币种说明

在 搜索、沙箱环境验证 和 搜索与预订 中补充了首次 sandbox 联调的币种要求。

包括这些内容：

• 首次对接时，Atlas 侧可能尚未配置结算币种

• 测试 search.do 时，需要手工传 currency: "USD"

• 如测试用例要求其他币种，再切换为对应值

April 9, 2026

新增沙箱环境验证

新增 沙箱环境验证，用于开发前的无代码 happy path 检查。

包括这些内容：

• 用 Newman 运行 Search、Verify、Order 和 Pay 四步验证

• 明确 final retrieve 轮询超时属于预期行为

• 补充凭证、网络、IP allowlist 和 reporter 缺失等高频失败原因

• 在 快速开始、沙箱访问 和 沙箱开发 中补了入口链接

April 8, 2026

更新错误码首页

基于最新的 Atlas API diagnostics map，重构了 错误码 首页。

包括这些内容：

• 增加按是否可重试的首轮判断

• 增加按流程阶段的错误定位入口

• 增加 routingIdentifier、sessionId 和出票轮询规则

• 增加无错误码集成模式的排查项

• 明确 615、110、415 等高风险处理方式

April 6, 2026

新增混合支付指南

新增 混合支付指南，说明 VCC passthrough 失败后的处理方式。

包括这些内容：

• 什么算混合支付

• 何时切换到 Deposit 或换卡重试

• pay.do 失败与航司拒付的区别

• 通过 ATRIP 和 API 的处理流程

• 重建订单、支付重试和 webhook 跟进建议