错误码

Atlas API 错误代码、重试指南、新鲜标识符规则以及搜索、预订、支付、退款和预订后流程的故障排除路径。

💬 需要帮助？ 如果遇到问题，请在帮助中心咨询 Eva，快速获取诊断建议。

咨询 Eva

使用此页面决定是否重试、从更早的步骤重新开始，或在另一次支付调用前停止。

当您需要以下内容时，从这里开始：

• 识别错误代码通常的含义

• 决定请求是否安全可重试

• 快速跳转到正确的故障排除页面

大多数团队应首先识别失败的步骤。

然后判断问题是由输入、标识符过期、库存变化、支付状态还是平台条件引起的。

快速解答

我应该重试这个 Atlas API 错误吗？

仅在失败明显是暂时性的时候重试。

超时、短暂的负载高峰以及某些航司侧故障通常是可重试的。

输入错误、过期标识符、过期的附加服务和重复支付风险则不可重试。

哪些错误通常需要新的标识符？

诸如 202、206、207、210、301、302、308 和 631 等代码通常意味着当前预订上下文不再有效。

从正确的更早步骤重新开始，而不是重新提交相同的标识符。

何时应避免重试 pay.do？

当订单可能已经支付、正在出票或等待航司确认时，不要重试支付。

对于 402、404、406 和 615 等情况，先检查订单状态。

getOfferPrice.do 订单有什么变化？

在履约流程中，更积极地处理支付和出票失败。

有效窗口是 5 分钟，而不是标准的 30 分钟保留模型。

仅在确认订单仍然可支付且仍在有效窗口内后重试。

快速找到正确的错误指南

使用与失败阶段匹配的页面。

请求在业务处理前失败

从常见与访问错误开始。

用于无效 JSON、缺少字段、凭证失败或访问问题。

搜索失败

从搜索错误开始。

用于超时、QPS 限制、路由限制或空结果。

验证、订单或出票失败

从验证、订单与出票错误开始。

用于过期标识符、过时定价、无效预订输入或出票阶段失败。

支付失败

从支付错误开始。

用于重复支付风险、不支持的支付方式、VCC 失败或 FR 确认缺失。

退款、查询或预订后失败

从退款、查询与预订后错误开始。

用于订单查找问题、退款时机、过期退款报价或附加服务限制。

所有错误指南

• 常见与访问错误

• 429 vs 110

• 搜索错误

• 验证、订单与出票错误

• 支付错误

• 退款、查询与预订后错误

429 请求限制处理

Atlas 可能会以 Atlas 错误代码 429 拒绝超限的预订前请求。

此策略适用于以下池：

• search.do 使用 10 QPS

• verify.do 和 getOffers.do 共享 60 QPM

• seatAvailability.do 和 getLuggage.do 共享 60 QPM

order.do 和 pay.do 不在此策略范围内。

响应字段

返回 429 时使用这些字段：

• code — 错误代码

• message — 错误摘要

• limitType — 活动的限制桶

• limit — 当前配置的限制

• retryAfter — 重试前的等待时间（秒）

响应示例

{
  "code": 429,
  "message": "Rate limit exceeded. Please retry after the current window resets",
  "limitType": "SEARCH_QPS",
  "limit": 1,
  "retryAfter": 1
}

使用API 请求限制获取完整策略、计数规则和池映射。

计入限制的内容

以下请求会计入：

• 成功的请求

• 无结果的请求

• 业务失败和航司失败

• 缓存命中响应

以下请求不计入：

• 已被请求限制治理拒绝的请求

• 身份验证失败

• 参数验证失败

• 权限或安全策略拒绝

• 幂等性阻止的从未进入业务处理的重复请求

重试策略

在每次重试前使用此规则：

• 是：立即或在短暂延迟后重试

• 部分：仅在更改条件后重试

• 否：先修复输入、流程或账户设置

典型的"部分"情况：

• 429：等待 retryAfter，然后以较低频率重试

• 110：在重试前添加回退

• 406：等待正在进行的支付完成

• 415：先完成 orderCommit.do

• 616 或 633：切换支付方式

• 108、113、324：稍后重试，不要立即重试

如果支付可能已经开始或完成，在重试前查询订单状态。

对于 getOfferPrice.do 订单，不要使用通用重试循环。

一旦履约窗口即将耗尽，停止重试。

快速决策表

当您需要快速确定下一步操作时，使用此表。

代码	通常含义	可重试性	下一步操作
429	超出请求限制	部分	等待 retryAfter 并降低请求频率
107	余额低于允许阈值	否	充值账户，然后重试
108	路由暂时受限或关闭	部分	稍后重试，不要立即重试
110	达到搜索 QPS 限制	部分	添加指数退避，然后重试
112	搜索超时	是	短暂等待后重试
123	搜索量对于付费订单来说过高	否	减少不必要的搜索流量
126	智能搜索 requestId 无效或过期	否	开始新的智能搜索
127	搜索超时且请求已结束	是	运行新的搜索
202	routingIdentifier 在 6 小时后过期	否	重新运行搜索并使用新的标识符
205	验证超时	是	短暂等待后重试验证
206	搜索后航班不再可用	否	从搜索重新开始
210	票价家族已售罄	否	从搜索重新开始并重新预订
222	验证期间行李查询失败	部分	重试验证，如果重复则升级
299	因暂时性平台问题导致验证失败	部分	重试验证一次，如果需要则从搜索重新开始
301	sessionId 在 2 小时后过期	否	重新运行 verify.do 并获取新的会话
302	验证和订单之间航班变更或售罄	否	从搜索重新开始并重新预订
307	预订输入无效	否	修复请求字段并重新提交
308	验证和订单之间价格变更	否	重新生成或重新启动预订流程
309	附加服务 productCode 无效或过时	否	使用当前验证响应中的 productCode
316	预订期间航司侧超时	是	短暂等待后重试预订流程
317	航司侧预订失败	部分	小心重试，如果重复则升级
324	订单期间航司系统问题	部分	稍后重试，如果重复则联系运营团队
406	支付正在进行中	部分	等待并在重试前查询订单状态
409	行李 productCode 与航段不匹配	否	重新检查附加服务映射并重新提交
410	联系电话格式无效	否	修复电话格式并重新提交
411	由于余额或账户检查导致支付失败	否	首先验证余额和支付输入
415	FR 订单未确认	部分	先调用 orderCommit.do，然后重试 pay.do
604	航司拒绝了 VCC	是	使用不同的有效卡重试
615	支付成功但航司 PNR 仍在等待中	否	不要重试支付；改为监控订单状态
616	卡需要 3DS 验证	是	使用非 3DS 卡或存款模式
617	出票时存款余额过低	否	在重试前充值余额
631	行李票价在履约期间变更	否	从验证重新开始
633	航司因风险控制拒绝支付	部分	使用存款模式或另一张有效卡重试
703	未找到订单	否	重新检查订单查找值
705	订单查询超时	是	短暂等待后重试
805	refundOfferId 过期	否	请求新的退款报价
809	在出票完成前尝试退款	否	等待出票完成
811	退款请求缺少必需的行程航段	否	提交完整行程
824	对附加服务订单请求退款	否	使用原始主订单号

在依赖完整的传统表之前，对于按流程的详细处理，请先使用上面的分类页面。

不要将每个错误都视为可重试的。

某些错误需要新的标识符。 某些错误需要新的预订流程。 某些错误绝不能触发另一次支付调用。

高风险错误

以下情况导致最多的可避免的重复失败：

110 太多并发请求

不要立即重试。

添加指数退避。 从大约 1s 开始。 上限大约 30s。

429 超出请求限制

不要立即重试。

首先等待返回的 retryAfter 值。

然后减少突发大小、重用缓存，并减慢下一波重试。

202 路由标识符过期

不要使用相同的 routingIdentifier 重试 verify.do。

routingIdentifier 在 search.do 后最长有效 6 小时。

首先重新运行搜索。

301 会话不存在或已超时

不要重用相同的 sessionId。

sessionId 在 verify.do 后最长有效 2 小时。

重新运行 verify.do 以获取新的会话。

406 支付操作正在进行中

不要在一个支付请求仍在运行时发送另一个。

等待并查询订单状态。

615 支付完成但未能获取 PNR

不要重试支付。

Atlas 将手动跟进 PNR。 使用订单查询监控状态。

415 用户未确认订单

常见于 FR 流程。

在 pay.do 之前调用 orderCommit.do。

基于模式的检查

如果错误本身不能解释失败原因，请检查集成模式：

• 在首次 TktInProcess 后停止轮询

• 重用了过期的 routingIdentifier

• 重用了过期的 sessionId

• 跨会话重用了附加服务 productCode

• 沙箱和生产凭证混合使用

• 未配置 webhook，仅使用轮询作为唯一状态来源

当问题是由实施行为引起，而不仅仅是错误代码时，使用相关的流程页面。

推荐的故障排除顺序

1. 识别失败的流程

2. 检查问题是与输入、库存、标识符过期、支付还是平台相关

3. 判断代码是否可重试（是/部分/否）

4. 仅在失败是真正暂时性时重试

5. 如果相同错误重复出现，附上请求上下文升级

常见初步检查

• 验证凭证和账户访问

• 确认必填字段存在

• 确认标识符是新鲜的

• 在重试支付前查询订单状态

• 在重试搜索、订单或退款流程前检查余额

快速重试参考

立即或在短暂延迟后重试

示例：

• 112

• 115

• 127

• 205

• 316

• 604

• 607

• 705

仅在更改条件后重试

示例：

• 429

• 108

• 110

• 116

• 299

• 304

• 317

• 324

• 406

• 415

• 633

在输入或流程修复前不要重试

示例：

• 307

• 309

• 410

• 619

• 810

不要使用相同的标识符重试

示例：

• 202

• 206

• 207

• 210

• 302

• 308

• 611

• 631

不要重试支付

示例：

• 318

• 402

• 404

• 615

常见问题

Atlas API 错误代码通常帮助我决定什么？

它们帮助您判断失败是由请求输入、过期标识符、库存变化、支付状态还是暂时性平台条件引起的。

在仅依赖完整的传统表之前，请先使用上述流程特定的指南。

哪些 Atlas API 错误代码通常可以安全重试？

典型的可重试情况包括短暂超时或暂时性平台条件，如 112、127、205、316 和 705。

始终在需要时应用退避，并避免盲目重试循环。

429 仅在返回的 retryAfter 延迟之后且以较低的请求频率重试。

当您需要区分请求限制治理和搜索并发压力时，使用 429 vs 110。

哪些错误代码意味着我需要新的标识符或新的流程？

诸如 202、206、207、210、301、302、308 和 631 等代码通常意味着当前标识符、库存状态或预订上下文不再有效。

在这些情况下，从正确的更早步骤重新开始，而不是重新提交相同的请求。

支付错误后我应该重试 pay.do 吗？

不总是。

对于 406，等待并先查询订单。

对于 402、404 或 615，在确认实际订单状态前不要重试支付。

对于 616 或 633，先更改支付条件。

对于 getOfferPrice.do 订单，还要确认重试仍然符合履约截止时间。

完整传统代码表

当您需要原始的完整代码目录时，使用下面的完整表。

Atlas 使用以下 Enum 存储错误代码和相应的错误消息。

通用错误代码

代码	描述	说明	解决方案
-1	通用错误		Atlas 将调查并添加相关错误代码。
100	缺少必需请求数据	缺少必填参数。	检查必填参数。
900	未授权访问	凭证不正确或账户状态不正确或尝试访问其他客户的数据。	检查凭证。如果错误仍然存在，请联系您的客户经理。
901	非法请求数据	检查请求格式。	请求格式应为 JSON。
902	访问被拒绝	凭证不正确或账户状态不正确或您正在尝试访问其他客户的数据。	检查凭证。如果错误仍然存在，请联系您的客户经理。
9999	系统错误	这是意外错误。	Atlas 将调查并添加相关错误代码。

搜索错误代码

代码	描述	说明	解决方案
101	非法请求数据	检查请求格式。	格式应为 JSON。
102	非法请求参数：{0}	请检查下面的消息。
	成人数量不能少于 1	成人数量为"0"。	添加成人乘客类型。
	最多允许 9 名乘客	乘客总数超过 9 人。	将乘客总数减少到最多 9 人。
	未知城市代码	城市代码不正确。	检查并更正城市代码。
	fromCity 或 fromAirport 不能为空	需要搜索票价的出发地为空。	添加城市或机场代码。
	toCity 或 toAirport 不能为空	需要搜索票价的目地地为空。	添加城市或机场代码。
	fromDate 不能为空	旅行开始日期为空。	添加旅行开始日期。
	retDate 不应为空	行程类型为 2 时返回日期为空。	添加返回日期。
	fromDate 格式无效	日期格式不正确。	将格式改为 YYYYMMDD。
103	不支持往返搜索	只能搜索单程行程。	如果您的账户有限制，请联系您的客户经理。
104	不允许往返搜索	仅返回单程票价。客户不能在搜索中对"tripType"使用值"2"。	如果您的账户有限制，请联系您的客户经理。
105	OD 不在客户的往返白名单中	该城市对尚未被列入白名单。	如果您的账户有限制，请联系您的客户经理。
106	不允许搜索		如果您的账户有限制，请联系您的客户经理。
107	余额不足	账户余额低于约定阈值。	优先充值您的账户。
108	路由受限 / 系统限制	航司有航班和报价，但 Atlas 因某些原因关闭了销售。原因可能是 1) 手动关闭销售 2) 系统检测到售罄风险 3) 邻近航班限制。	过段时间再尝试预订。
109	搜索次数超出限制	每天的搜索次数已超出允许限制。	如果您的账户有限制，请联系您的客户经理。
110	太多并发请求	QPS（每秒查询数）高于允许限制。	如果您的业务需要更多资源，请联系您的客户经理。
111	不允许实时搜索	此功能未为您的账户激活。	如果您需要此服务，请联系您的客户经理。
112	超时	搜索请求已超时。	更多详情请参阅常见问题 --> Atlas API 通用信息。
113	航司正在维护中	航司在 Atlas 中处于"非活跃"或"维护中"状态。这不一定意味着航司网站本身有问题。	等待状态变为"活跃"。
114	无航班	可能原因：- 该航司在搜索的城市对日期没有航班。	查看航司网站，确认该日期是否有航班运营。
115	意外结果	系统错误。	重试。如果错误仍然存在，提交服务请求。
116	搜索数据未捕获	Atlas 端存储搜索数据时报告错误。	如果此错误不是持续报告，您可以重试。如果错误仍然存在，则需要联系客户经理。
123	请求太多但付费订单太少	由于搜索请求过多而付费订单太少，服务已被阻止。	仅搜索需要的城市对。
124	不支持的结算货币	结算货币与 Atlas 接受的货币不同。	将货币更改为 Atlas 接受的结算货币。
126	requestId 不存在或已结束	使用了错误的 requestId 或 requestId 不再有效。	检查 requestId 或进行新的智能搜索并使用新的 requestId。
127	搜索超时	搜索已超时。	进行新的搜索。

验证错误代码

代码	描述	说明	解决方案
200	非法路由标识符	"routingIdentifier"标签的信息与搜索响应中收到的路由标识符不匹配。	检查路由标识符，并使用正确的"routingIdentifier"重新发送验证请求。
201	无效路由	航司有航班和报价，但 Atlas 因某些原因关闭了销售。原因可能是 1) 手动关闭销售 2) 系统检测到售罄风险 3) 邻近航班限制。	过段时间再尝试预订。
202	路由标识符过期	"routingIdentifier"有效期为 6 小时。如果在此时间段后使用"routingIdentifier"，则显示此错误。	重新进行"搜索"并使用新的"routingIdentifier"。
203	航司已关闭	航司已停止运营。
205	超时	Atlas 端为验证响应设置了超时时间。验证响应耗时较长。	更多详情请参阅常见问题 --> Atlas API 通用信息。
206	无航班	航司侧无法找到所需航班，可能是由于航班已售罄。	重新进行搜索。
207	目标航班不存在	航司侧无法找到所需航班，可能是由于航班已售罄。	重新进行搜索。
208	舱等变更	预订舱等已变更。	重新进行搜索。
209	座位强验证失败	价格验证期间的座位验证已启用。	联系您的客户经理。
210	票价家族已售罄	航班或票价家族在航司侧不再可用。	重新进行搜索并重新预订。
211	未找到航班或票价家族	航班或票价家族在航司侧不再可用。	重新进行搜索并重新预订。
212	非法请求参数	某些参数缺失或多余。	检查验证请求。
299	验证失败	这是需要 Atlas 采取行动的错误。在某些不可控情况下，如网络问题、升级和重启，可能会发生 299 错误。可能是航司不可用或 Atlas 端存在问题。Atlas 需要在内部处理这些错误。	重试验证。如果遇到相同错误，则从搜索重新开始。如果错误仍然存在，升级到 Atlas。

订单错误代码

代码	描述	说明	解决方案
300	无效会话信息	"sessionID"不正确。	检查会话 ID 并输入正确的 ID。
301	会话不存在或已超时	"sessionID"有效期为 2 小时。如果在此时间段后使用"sessionID"，则显示此错误。	检查会话 ID 并输入正确的 ID。如果时间超过 2 小时，则从验证阶段重新开始（如果验证响应后不到 6 小时）。
302	目标航班不存在	"在验证和预订之间，航班已售罄。这也可能是由于预订的乘客数量导致的。预订时的乘客人数和验证时的乘客人数可能不同。创建预订时，价格基于实际预订的乘客人数进行验证。	重新进行搜索并重新预订。
303	航司已关闭	航司已停止存在或不再运营。
304	验证失败	在某些不可控情况下，如网络问题、升级和重启，可能会发生 304 错误，但数量不会很多。如果有很多 304 错误，可能是航司不可用或 Atlas 端存在技术问题。	如果此错误持续重复，请联系您的客户经理。
305	无效路由	生成订单时，系统发现航班因各种原因不再销售，例如 1) L2B 2) 系统已识别出航班可能售罄的风险 3) 航司销售已关闭。	重新进行搜索并重新预订。
306	舱等变更	预订舱等已变更。	重新进行搜索。
307	非法预订请求参数：	一个请求参数有问题。请检查消息。	检查错误消息。更正相同问题并重新提交预订。
	passengers->name	乘客姓名似乎不正确。	检查乘客姓名，更正后重新提交预订。
	passengers->passengerType	乘客类型不正确。	检查乘客类型，更正后重新提交预订。
	passengers->birthday	出生日期格式不正确或缺失。	更正格式并重新提交预订。
	passengers->gender	性别不正确或缺失。	更正或添加信息并重新提交预订。
	passengers->cardExpired	身份证到期日期格式不正确或缺失。	更正或添加信息并重新提交预订。
	额外行李超出限制。最大允许：1	附加行李数量超出允许限制。	更正行李数量并重新提交预订。
	附加服务与航段数量不匹配（入境）	航段和附加服务数量不匹配。	检查附加服务和航段，并重新提交预订。
	一个方向内相连航段的行李选择不一致	对于中转航班，同一去程或回程方向的所有航段必须选择相同的行李。API 可能按航段返回行李选项，但订单验证会检查整个方向。	在该方向的所有相连航段中使用相同的行李选择，然后重新提交预订。
	XXX 字段无效	字段输入不正确。	检查字段并重新提交请求。
308	价格变更		重新生成预订或创建全新的预订。
309	未找到附加服务	输入的附加服务产品代码不正确。	检查并输入正确的附加服务产品代码。
310	不允许婴儿乘客		创建不包含婴儿乘客类型的新预订。婴儿乘客可以通过航司网站在"线下"添加。
311	座位强验证失败	检查验证响应以获取最大允许座位数。	根据验证响应调整乘客人数并创建新预订。
312	预订座位过多	预订的乘客人数超出当前航班剩余（或允许）的座位数。	重新预订行程。
313	票价家族已售罄		创建新预订。
314	无法重新生成订单：原始订单正在出票或已出票		使用相同的乘客和航班详情检查订单。
315	座位不足	座位已售罄。	重新预订行程。
316	超时	航司端发生超时错误。有关超时的更多详情，请查看常见问题（通用信息）。	重新预订行程。
317	与航司预订不成功	航司端发生错误。	重新预订行程。
318	重复预订		检查是否存在具有相同乘客详情和航班号的预订。确认后，忽略此预订。
320	请求的座位未找到或已被占用		重新预订座位并提交新订单。
324	航司系统问题		过段时间重试。如果问题仍然存在，请联系我们的运营团队。
326	您在航司侧的账户余额不足	BYOA 客户在相关航司账户中的存款余额无效。	充值余额，然后在余额更新后重试。
327	乘客信息不符合要求	未满足所有强制要求。	从验证响应中检查预订要求，确保所有要求已满足。
410	使用正确格式"XXXX-XXXXXXXX"作为联系电话。示例：0001-87291810, 0086-13928109091	电话号码格式不正确。	检查电话号码格式并进行修正。
6051	乘客在政府信用黑名单中	乘客在政府的"禁飞"名单中。	通知乘客并取消订单。

支付错误代码

代码	描述	说明	解决方案
400	非法请求参数	某些请求参数非法。具体原因请查看 API 返回的"msg"字段。	根据错误消息调整参数并重新调用 API。
401	支付超时	预订的支付启动时间晚于支付截止时间。默认支付截止时间是订单创建后 30 分钟。	重新生成现有订单或创建新预订。
402	订单状态不支持支付	订单状态可能为"正在出票"或"已出票"，说明已支付。	检查订单是否已支付。如果"是"，不要发送支付请求。
403	不支持的支付方式	此航司不支持该支付方式。	更换为其他支付方式。
404	订单已支付	订单已支付。	检查订单是否已支付。如果"是"，不要发送支付请求。
406	支付操作正在进行中	上一个支付请求仍在处理中。	等待在 PNR 详情响应中收到航司 PNR。
407	指示乘客信息不正确的错误消息	某些乘客的必填元素未提交。	检查信息并更正后重新提交。
408	乘客不能独自登机	此订单中仅预订了儿童乘客。	创建新订单并添加成人乘客与儿童乘客同行。
409	额外行李与航班航段不匹配	额外行李的"productCode"不匹配此航班可用的产品代码。	检查"productCode"并使用正确的代码更新。
410	使用正确格式"XXXX-XXXXXXXX"作为联系电话	联系信息格式不正确。	检查联系信息并确认其符合要求的格式。
411	通用支付错误	检查您的账户时发生错误。例如，"余额不足"。	检查余额或根据错误消息中的指示操作。
413	不支持的卡	使用 MoR 支付时，传入的卡类型不在 Atlas 支持范围内。	更换卡片。
414	卡不匹配	卡类型与生成订单时传入的（cardType）不一致。	更换卡片以使其与创建订单时传入的卡类型一致。
415	用户未确认订单	与 FR 集成时，需要在创建订单（order.do）之后、支付（pay.do）之前调用 orderCommit.do API。

座位可用性代码

代码	描述	说明	解决方案
214	会话 ID 无效或过期	会话 ID 无效或过期。	发送新的座位可用性请求
216	座位选择失败	获取座位可用性信息失败。	过段时间重试。如果问题仍然存在，请提交服务请求。
217	未知错误	未知错误
218	航司目前不支持座位选择	目前此航司不可用座位选择。	联系您的客户经理，了解此航司何时将支持座位可用性

出票错误代码

代码	描述	说明	解决方案
601	票价变更
602	未找到航班	航班在航司平台上不再可用。	创建新预订。
603	航班已售罄	航班已售罄，没有可用座位。这发生在支付完成后但出票前。	创建新预订。
604	直通卡支付失败	航司不接受 VCC。	尝试使用不同的卡支付。
605	乘客信息不正确	"passengers"数组中的信息不正确。	检查乘客详细信息并在更正后重新提交。
606	航班信息已更新	在搜索和预订之间，航司对相同航班号进行了时刻变更。	从搜索重新开始。
607	座位已售罄		从搜索重新开始。
608	重复预订		检查是否存在具有相同乘客详情和航班号的预订。确认后，忽略此预订。
609	航司阻止了联系邮箱	航司根据其政策阻止了您的邮箱地址。	使用不同的邮箱地址创建新预订，或授权 Atlas 使用 Atlas 的邮箱地址。更多详情请参阅"Atlas API 订单"常见问题。
611	PNR 已取消或过期	PNR 已被航司取消或支付超过时间限制。	从搜索重新开始。
613	被航司风险控制拒绝	航司根据其业务规则阻止了订单。	尝试使用不同的 VCC 支付。如果问题仍然存在，使用"存款"方式支付。
614	年龄错误	儿童乘客的年龄不正确。	检查年龄并重新提交预订。
615	支付完成但未能从航司获取 PNR 号码	有时对于 VCC 支付，航司未能响应，因此未收到 PNR。在这种情况下，Atlas 将手动与航司处理并获取 PNR 添加到预订中。
616	3DS 验证	使用的卡需要 3DS 验证。Atlas 目前不支持此功能。	使用不需要 3DS 验证的不同卡，或通过存款模式支付。
617	余额不足	存款余额低于最低阈值。	检查您的余额并优先充值。
618	行李重量与航司不匹配	行李重量不包含航司提供的选项之一。	联系 Atlas 运营团队
619	缺少支付信息	pay.do 请求中的某些信息缺失/不正确。	检查 pay.do 请求并重新提交。
620	异常返回票价类型	航司的往返票价限制为基础票价，不能与其他票价类型组合。	仅预订单程行程或按方向各创建一个预订。
621	不支持婴儿乘客	Atlas 不支持此航司的"婴儿"乘客类型。	创建不包含婴儿乘客的新预订。
623	卡余额不足/卡消费限制	提供的 VCC 余额不足/达到卡消费限制。	使用具有足够卡余额的不同 VCC 支付。
624	暂时不支持往返	目前不支持此航司的往返功能	预订 2 个单程作为独立订单。
625	ffp 手动出票	目前不支持常旅客计划，只能手动处理。
626	当前订单中有未支付的服务	航司发现此 PNR 下有未支付的交易，导致后续业务操作失败。	为任何未支付的订单进行支付。
627	当前订单不支持出票后附加服务购买	此订单不允许出票后附加服务。	移除附加服务并创建新订单。
628	出票后附加服务购买订单的航班信息与原始航班不匹配	航班详情不正确。	检查航班详情并创建新订单。
631	行李票价变更	履约时行李价格已变更。	从验证重新开始流程。
632	行李票价变更	由于航司风险控制导致出票失败。	从验证重新开始流程。如果问题仍然存在，请联系我们的运营团队。
633	航司拒绝支付	由于航司风险控制导致支付被拒绝。	使用"存款"作为支付方式并重试。
634	航司系统问题		创建新订单。如果问题仍然存在，请联系我们的运营团队。
699	系统问题		过段时间重试。如果问题仍然存在，请联系支持。

查询订单错误代码

代码	描述	说明	解决方案
701	识别到多个订单，请添加额外参数重新请求	已识别出多个具有相同记录编号的订单。	添加额外参数并重试。
702	airlinePNR 和 carrier 是订单检索的必填项	记录编号和航司代码在请求中是必填的。	添加提到的参数并重试。
703	未找到订单，请检查参数	订单号似乎不正确。	检查订单号并重试。
704	参数不匹配，请检查并重试	输入的参数不正确。	检查参数，更正后重试。
705	超时	响应已超时。	过段时间重试。如果问题仍然存在，请联系支持。
800	订单不存在	相关订单不存在。	请重新检查订单号并重试。

退款报价错误代码

代码	描述	说明	解决方案
801	订单不存在	输入的订单号不正确。	检查订单号并输入正确的订单号。
802	儿童不能单独旅行	不能仅退还 ADT 乘客。CHD 乘客也应一起退款。	请求包含儿童乘客的整单退款。
803	乘客已为某乘客和/或航段提交退款	输入的订单号不正确。	检查订单号并输入正确的订单号。
807	乘客不存在	输入的乘客姓名不正确。	检查乘客姓名并在需要时更正。
809	订单未出票	此订单的出票正在处理中或支付尚未完成。	等待订单出票或为此订单进行支付。
810	非法请求参数：xxx	其中一个请求参数不正确。	检查请求并更正所需参数。
811	未输入完整行程。请输入完整行程并重试。	可能由多种原因导致。	检查以下场景是否适用并采取相关措施。
		对于往返行程，需要退全票。	如果机票完全未使用，请输入整个行程的详细信息并重试。
		对于中转航班，两个航段需要一起退款。	检查请求中是否包含两个航段并重试。
		行程中有一个航段已乘坐。	联系航司。Atlas 不支持"部分"乘坐行程的退款。
812	无法将乘客 xxx 与订单匹配	乘客姓名与订单不匹配。	检查乘客姓名并重新提交请求。
815	未找到票		检查票号并重试。
824	附加服务订单不支持退款。请提供原始订单号。	仅允许主订单退款。	检查并确认订单号是否为原始订单的订单号。
902	访问被拒绝
8041	航段不存在	请求中的某个航段不存在。	检查航段，仅提供该退款请求的航段。

退款提交错误代码

代码	描述	说明	解决方案
801	订单不存在	输入的订单号不正确。	检查订单号并输入正确的订单号。
802	儿童不能单独旅行	不能仅退还 ADT 乘客。CHD 乘客也应一起退款。	请求包含儿童乘客的整单退款。
803	乘客已为某乘客和/或航段提交退款	输入的订单号不正确。	检查订单号并输入正确的订单号。
805	RefundOfferId 已过期	"refundOfferId"已过期。	发送新的退款请求以获取最新的"refundOfferId"。
807	乘客不存在	输入的乘客姓名不正确。	检查乘客姓名并在需要时更正。
809	订单未出票	此订单的出票正在处理中或支付尚未完成。	等待订单出票或为此订单进行支付。
810	非法请求参数：xxx	其中一个请求参数不正确。	检查请求并更正所需参数。
811	未输入完整行程。请输入完整行程并重试。	可能由多种原因导致。	检查以下场景是否适用并采取相关措施。
		对于往返行程，需要退全票。	如果机票完全未使用，请输入整个行程的详细信息并重试。
		对于中转航班，两个航段需要一起退款。	检查请求中是否包含两个航段并重试。
		行程中有一个航段已乘坐。	联系航司。Atlas 不支持"部分"乘坐行程的退款。
812	无法将乘客 xxx 与订单匹配	乘客姓名与订单不匹配。	检查乘客姓名并重新提交请求。
814	退款提交正在进行中。请稍候。	退款流程正在进行中。请稍候。	过段时间重试。如果问题持续重复，请联系您的客户经理。
815	未找到票		检查票号并重试。
816	退款请求已提交	退款请求已提交。	无需操作。您可以使用 queryRefundOrders.do API 请求检查退款状态。
817	Atlas 退款已应用	退款请求已提交。	无需操作。您可以使用 queryRefundOrders.do API 请求检查退款状态。
818	退款索赔已应用	退款索赔已提交。	无需操作。您可以使用 queryRefundOrders.do API 请求检查退款状态。
820	票状态为已使用	该航段已乘坐。	检查该航段是否已乘坐。如果该航段未乘坐，请联系我们的运营团队。
821	超出机票退款截止时间	退款提交已在退款截止时间之后进行。	如果您有任何疑问，请联系我们的运营团队。
822	超出机票作废截止时间	作废提交已在截止时间之后进行。	如果您有任何疑问，请联系我们的运营团队。
823	未作废所有乘客
824	附加服务订单不支持退款。请提供原始订单号。	仅允许主订单退款。	检查并确认订单号是否为原始订单的订单号。
902	访问被拒绝
905	提交过于频繁，请稍后再试
8041	航段不存在	请求中的某个航段不存在。	检查航段，仅提供该退款请求的航段。

退款查询错误代码

代码	描述	说明	解决方案
801	订单不存在	输入的订单号不正确。	检查订单号并输入正确的订单号。
810	非法请求参数：xxx	其中一个请求参数不正确。	检查请求并更正所需参数。
902	访问被拒绝

预订后附加服务搜索错误代码

代码	描述	说明	解决方案
117	此订单不允许行李，因为尚未出票	票仍未出票。	等待状态更改为"已出票"，然后搜索附加服务。
118	Atlas 目前不支持此航司的座位或行李		联系航司购买附加行李，或向 Atlas 提交服务请求。
119	带有婴儿的订单不支持行李或座位选择	预订中有婴儿乘客。	直接向航司预订附加行李，或向 Atlas 提交服务请求。
120	该航班的行李或座位选择已关闭	航司不再接受该航班附加服务的添加。	联系航司或向 Atlas 提交服务请求。

预订后附加服务订单错误代码

代码	描述	说明	解决方案
501	不允许附加购买	此订单不允许添加附加服务。	联系航司或向 Atlas 提交服务请求。
502	价格已上涨，订单创建失败。请进行新搜索。	从附加服务搜索进行时价格已变更。	重新搜索附加服务订单。
503	行李选择不正确	请检查下面的消息。
	重复添加相同类型的行李。	每位乘客每个航段只能选择一个行李。	移除重复的相同类型行李。
	行程不同航段的行李不一致。	对于某些航司，每个行程中各航段的行李必须相同。	使此行程中各航段的行李一致。
	产品代码与航段搜索结果不匹配。	产品代码必须与航段搜索结果匹配。	使用搜索结果中的正确产品代码。
504	不允许附加行李。附加行李已存在于原始订单中	Atlas 只允许附加行李添加一次	直接向航司预订附加行李，或向 Atlas 提交服务请求。
505	不允许附加行李。行李已作为出票后附加服务预订	Atlas 只允许附加行李添加一次	直接向航司预订附加行李，或向 Atlas 提交服务请求。
506	带有婴儿的订单不支持座位选择	预订中有婴儿乘客。	直接向航司预订附加行李或座位，或向 Atlas 提交服务请求。

错误示例

214：会话 ID 无效或过期

请求：

{
    "sessionId": "49871954-6aaa-44fa-b768-1a590d21be08"
}

响应：

{
    "cabins": null,
    "status": 214,
    "msg": "Session ID invalid or expired"
}

216：座位选择失败

请求：

{
    "mockError": "mockSeatError", 
    "sessionId": "31f1c47c-1fbb-4cfd-8620-49e73ab26f60"
}

响应：

{
    "cabins": null,
    "status": 216,
    "msg": "Seat selection failed"
}

217：未知错误

系统回退异常，通常不会触发。

响应：

{
    "cabins": null,
    "status": 217,
    "msg": "Unknown error"
}