> For the complete documentation index, see [llms.txt](https://resources.atriptech.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://resources.atriptech.com/api-wen-dang/product-guides/booking/booking-step-guides/payment-and-ticketing/vcc-passthrough-shi-yong-zhi-nan.md).

# VCC Passthrough 使用指南

使用自有 VCC 完成 Atlas 支付与出票：支持范围、接入、状态跟踪、异常恢复和资金核对。

{% hint style="info" %}
💬 **需要帮助？** 如果遇到问题，请在帮助中心咨询 Eva，快速获取诊断建议。

<a href="https://www.atriptech.com/" class="button primary" data-icon="comments">咨询 Eva</a>
{% endhint %}

{% hint style="info" %}
**最新更新 · 2026-11-12**

* 新增功能测试、模拟失败场景和上线前检查。
* 新增换卡、重试与重新生单处理说明。
* 新增常见问题，以及支持航司和卡组织清单。

完整记录见[更新日志](https://resources.atriptech.com/api-wen-dang/product-guides/booking/booking-step-guides/payment-and-ticketing/vcc-passthrough-shi-yong-zhi-nan#id-6.-geng-xin-ri-zhi)。
{% endhint %}

### 1. 功能概览

**使用自有虚拟卡向航司支付**

如果您通过 Atlas 预订机票，并希望由航司直接从自有供应商签发的虚拟卡扣款，请使用 VCC Passthrough。对于符合条件的订单，您的系统提供卡片，Atlas 将其提交给航司完成支付。

#### 适用场景

**VCC Passthrough** 是一种通过虚拟信用卡（VCC）完成资金结算的支付方式，专为代理商（如 OTA、TMC）与航空公司之间的交易场景设计。其核心逻辑为：代理商将客户的虚拟信用卡信息直接透传给航司完成扣款，无需存储或处理真实信用卡数据。

#### 支持范围与可用性

VCC Passthrough 支持 86 家航司。请查看[支持航司及卡组织清单](https://resources.atriptech.com/api-wen-dang/product-guides/booking/booking-step-guides/payment-and-ticketing/vcc-passthrough-shi-yong-zhi-nan#zhi-chi-hang-si-ji-ka-zu-zhi)。

也可在 ATRIP 的航司能力中，按支付方式筛选 VCC，查看平台整体能力。

{% hint style="warning" %}
订阅计划客户不会自动启用 VCC Passthrough。请联系 <info@atlaslovestravel.com> 申请开通。
{% endhint %}

**核心优势**

* **保留支付控制权：** 代理商继续使用既有 VCC 供应商、额度和单次卡策略。
* **便于资金与费用管理：** 可按订单设置支付上限，并通过 VCC 账单核对实际扣款。
* **支持自动化履约：** Atlas 提交卡片信息并处理出票，适合规模化订单处理。
* **保留支付回退选择：** VCC 不可用时，可在订单支持的前提下切换余额等支付方式。

这些优势不等于保证支付或出票成功。航司接受规则、发卡方限制、价格变化和 3DS 要求仍会影响结果。

{% hint style="info" %}
**适用对象：** 已接入 Atlas，且使用自有 VCC 支付航司费用的代理商。
{% endhint %}

### 2. 前置条件

| 检查项  | 要求                                                                             |
| ---- | ------------------------------------------------------------------------------ |
| 订单支持 | 最新 `supportPaymentMethods` 包含整数 `3`。搜索响应检查 `routings[]`；验价和创建订单响应检查 `routing`。 |
| 卡片条件 | 卡片有效，账单信息真实，可用额度覆盖支付上限，且无需持卡人交互式 3DS。                                          |
| 支付边界 | 本文仅适用于 `paymentMethod: 3` 的 VCC Passthrough。余额支付、BYOA 和 MoR 使用各自路径。            |
| 责任划分 | 客户负责合规 VCC、账单信息、额度和交易核对。Atlas 负责提交请求和返回状态。航司、支付渠道和发卡方决定受理、扣款及退款入账。             |

`supportPaymentMethods` 是响应字段，不放入 `pay.do` 请求。航司清单只说明平台覆盖范围；每笔订单仍以最新接口响应为准。

{% hint style="warning" %}
支付超时、返回处理中、卡片扣款或结果不明确时，不要再次支付。请先查询订单，再参阅[异常处理、换卡与重新生单](https://resources.atriptech.com/api-wen-dang/product-guides/booking/booking-step-guides/payment-and-ticketing/vcc-passthrough-shi-yong-zhi-nan#yi-chang-chu-li-huan-ka-yu-chong-xin-sheng-dan)。
{% endhint %}

#### 订单确认

**航司级支持不代表所有订单或卡片均可支付。** 接受情况还可能受航线、渠道、BIN、发卡地区、卡片限额及认证要求影响。

以下字段片段仅用于定位订单级支持信息，不代表完整响应。

{% tabs %}
{% tab title="search.do" %}
`supportPaymentMethods` 位于每个 `routings` 元素内：

```json
{
  "status": 0,
  "routings": [
    {
      "routingIdentifier": "<routing identifier>",
      "supportPaymentMethods": [1, 3]
    }
  ]
}
```

完整字段定义和响应示例请参阅 [搜索](https://resources.atriptech.com/api-wen-dang/api-reference/booking-apis/search.md)。
{% endtab %}

{% tab title="verify.do" %}
`supportPaymentMethods` 位于根级 `routing` 对象内：

```json
{
  "status": 0,
  "sessionId": "<session ID>",
  "routing": {
    "routingIdentifier": "<routing identifier>",
    "supportPaymentMethods": [1, 3]
  }
}
```

完整字段定义和响应示例请参阅 [验价](https://resources.atriptech.com/api-wen-dang/api-reference/booking-apis/verify.md)。
{% endtab %}

{% tab title="order.do" %}
`supportPaymentMethods` 位于订单创建响应的 `routing` 对象内：

```json
{
  "status": 0,
  "orderNo": "<order number>",
  "routing": {
    "routingIdentifier": "<routing identifier>",
    "supportPaymentMethods": [1, 3]
  }
}
```

创建订单后，可再次确认该订单支持的支付方式。仅当数组包含整数 `3` 时，才使用 VCC 调用 `pay.do`。

完整字段定义和响应示例请参阅 [创建订单](https://resources.atriptech.com/api-wen-dang/api-reference/booking-apis/create-order.md)。
{% endtab %}
{% endtabs %}

该字段不属于 `creditCard`，也不需要随 `pay.do` 提交。供应商价格和币种可从相关响应的 `vendorFare` 等价格字段获取，但不能单独判断 VCC 支持。

### 3. 功能接入

#### 快速开始

按以下顺序完成一次 VCC 支付。详细字段、业务规则和异常处理保留在后续章节，按需展开阅读。

1. 执行 `search.do` → `verify.do` → `order.do`，并确认最新 `supportPaymentMethods` 包含 `3`。
2. 确认订单号、支付时限、供应商币种和卡片额度。
3. 使用 `paymentMethod: 3` 调用 `pay.do`。
4. 使用 `queryOrderDetails.do` 查询最终状态。支付请求受理不代表出票成功。
5. 仅当 `orderStatus="2"` 且 `ticketStatus="1"` 时，确认出票成功。

结果未知时先查询订单。不要重复调用 `pay.do`、立即换卡或重新创建订单。

#### 价格、支付上限与用卡规则

**价格变化及差额**

VCC 透传由航司通过代理商提供的卡片扣款，Atlas 不提供价格保护。部分航司无法提前锁定价格，或会在支付阶段计算额外费用，因此报价与最终成交金额可能不同，相关价格差额由代理商承担。

按原有价格处理规则：

* 航司降价时，按较低的最终成交价出票。
* 航司涨价时，在允许的支付上限内继续处理；超过上限则出票失败。

相关盈亏可在 ATRIP 的 **数据看板 — VCC透传订单变价统计** 查看；实际资金交易仍需与 VCC 账单核对。

**支付上限**

可通过 `creditCard.paymentLimit` 设置最高可接受支付金额，币种为供应商币种。

未设置时，原有默认规则为：

```
价格变动阈值 = max（订单金额 × 5%，USD 5 × 乘客人数）
默认支付上限 = 订单金额 + 价格变动阈值
```

例如：

| 场景               | 价格变动阈值 | 默认支付上限  |
| ---------------- | ------ | ------- |
| 2 名乘客，订单 USD 50  | USD 10 | USD 60  |
| 1 名乘客，订单 USD 300 | USD 15 | USD 315 |

卡片可用额度应覆盖适用支付上限。非美元订单及包含附加服务的订单，应在接入时与 Atlas 确认金额计算口径，不要自行推定换算规则。

未设置 `paymentLimit` 且卡片额度不足时，订单会取消。支付上限不会增加卡片额度，也不保证库存、卡片接受或最终出票成功。

**费用与实际扣款**

报价、授权冻结、实际入账和 `vendorCost` 不是同一概念。`vendorCost` 与 `vendorCurrency` 用于核对航司实际扣款。

支付响应中的 `paymentOptions.deductFrom` 指示费用扣款来源：

| 值         | 含义                 |
| --------- | ------------------ |
| `CARD`    | 票价或支付费从卡片扣除。       |
| `DEPOSIT` | 服务费从 Atlas 账户余额扣除。 |

未明确的金额单位、费用渠道或换算规则，请在接入时向 Atlas 确认。

**开卡及用卡建议**

建议使用单次卡，并按预计交易及适用上限预留额度。使用多次卡时，正确填写 `reusable`，并在接入时确认系统重试策略。

优先使用已启用自动 3DS 的卡片。自动处理不代表可完成交互式验证。需要持卡人操作的 3DS 仍不适用于当前流程。

同时向发卡方检查：

* 单笔及累计消费限额；
* 有效期、激活状态及单次卡使用状态；
* 航司或商户、跨境及币种限制；
* 3DS 等认证要求。

需要交互式 3DS 的卡片可能无法通过当前流程完成支付。不要假设开启“自动验证”即可解决。

**支付成功率优化建议**

{% hint style="info" %}
以下为经验性建议，仅供参考，不构成支付成功保证。实际接受情况以航司、支付渠道、发卡方及 VCC 供应商规则为准。
{% endhint %}

| 策略   | 建议                                           |
| ---- | -------------------------------------------- |
| 卡片类型 | 优先使用目标航司常用卡组织发行的实体或合规虚拟卡。避免使用匿名卡或高风险预付卡。     |
| 交易金额 | 单笔金额较高时，建议先与发卡方确认限额。单笔超过 USD 5,000 时尤其应提前确认。 |
| 同卡频率 | 同一卡号连续支付建议间隔至少 15 分钟，避免触发发卡方或航司风控。           |
| 账单信息 | 使用真实且与 VCC 匹配的持卡人和账单信息。不要伪造地址、位置或其他交易信息。     |

#### 提交支付并确认出票

**获取并确认订单**

{% stepper %}
{% step %}
**获取并创建可支付订单**

执行 `search.do` → `verify.do` → `order.do`。提供最新行程、乘客和订单信息。

检查最新 `supportPaymentMethods`、供应商币种、价格、支付时限和订单号。仅当数组包含 `3` 时，才可继续。
{% endstep %}

{% step %}
**检查金额和支付时限**

确认卡片额度覆盖 `paymentLimit` 或默认支付上限。检查订单仍可支付。
{% endstep %}

{% step %}
**提交 VCC 支付**

调用 `pay.do`。提供 `orderNo`、`paymentMethod: 3` 和完整 `creditCard`。

检查接口结果。`status=0` 仅表示 Atlas 已受理请求。
{% endstep %}

{% step %}
**查询处理状态**

调用 `queryOrderDetails.do` 并检查 `orderStatus`、`ticketStatus`、`errorCode` 和 `paymentAttempted`。
{% endstep %}

{% step %}
**确认最终出票**

只有 `orderStatus="2"` 且 `ticketStatus="1"` 时，才视为最终出票成功。保存 PNR 与 `ticketNos`。
{% endstep %}
{% endstepper %}

**提交 VCC 支付请求**

以下为结构示例，占位内容需替换为有效信息。Sandbox 使用官方测试卡，不使用真实卡信息。

```json
{
  "orderNo": "<order number>",
  "paymentMethod": 3,
  "creditCard": {
    "cardNumber": "<card number>",
    "cardExpireMonth": "12",
    "cardExpireYear": "28",
    "cardCVV": "<CVV>",
    "cardHolderLastName": "<last name>",
    "cardHolderFirstName": "<first name>",
    "cardHolderCountry": "<country code>",
    "cardHolderProvince": "<state or province code>",
    "cardHolderCity": "<billing city>",
    "cardHolderPostCode": "<postal code>",
    "cardHolderAddress": "<billing address>",
    "reusable": false
  }
}
```

完整请求和响应字段请参阅 [支付与出票](https://resources.atriptech.com/api-wen-dang/api-reference/booking-apis/payment-and-ticketing.md)。

<details>

<summary>查看支付请求字段要求</summary>

| 字段                               | 必填 | 类型与格式                              | 说明                             |
| -------------------------------- | -- | ---------------------------------- | ------------------------------ |
| `orderNo`                        | 是  | 字符串                                | 要支付的 Atlas 订单号。                |
| `paymentMethod`                  | 是  | 整数；固定为 `3`                         | 选择 VCC Passthrough。            |
| `creditCard`                     | 是  | 对象                                 | VCC 支付信息。                      |
| `creditCard.cardNumber`          | 是  | 13–19 位数字；需通过 Luhn 校验              | VCC 卡号。                        |
| `creditCard.cardCVV`             | 是  | 3–4 位数字字符串                         | VCC 支付必须传入 CVV。需要时保留前导零。       |
| `creditCard.cardExpireMonth`     | 是  | 两位字符串，范围为 `01`–`12`                | 卡片有效期月份。2 月应传入 `02`，且不得早于当前年月。 |
| `creditCard.cardExpireYear`      | 是  | 两位年份字符串，例如 `26`                    | 卡片有效期年份。2026 年应传入 `26`。        |
| `creditCard.cardHolderFirstName` | 是  | 字符串；仅支持字母、连字符和拉丁扩展字符               | 持卡人名字。按卡片账单信息填写。               |
| `creditCard.cardHolderLastName`  | 是  | 字符串；仅支持字母、连字符和拉丁扩展字符               | 持卡人姓氏。按卡片账单信息填写。               |
| `creditCard.cardHolderCountry`   | 是  | 两位 ISO 3166-1 alpha-2 国家代码，例如 `US` | 卡片账单地址所属国家或地区。                 |
| `creditCard.cardHolderProvince`  | 是  | 两位州/省代码，例如 `CA`                    | 卡片账单地址所属州或省。不要传入完整名称。          |
| `creditCard.cardHolderCity`      | 是  | 字符串；不能为纯数字                         | 卡片账单地址所属城市。                    |
| `creditCard.cardHolderPostCode`  | 是  | 字母数字字符串，长度大于 4                     | 卡片账单地址邮编。                      |
| `creditCard.cardHolderAddress`   | 是  | 字符串，长度大于 6                         | 卡片账单地址的第一行或第二行。                |
| `creditCard.reusable`            | 否  | 布尔值，默认 `false`                     | `false` 为单次使用，`true` 为多次使用。    |
| `creditCard.paymentLimit`        | 否  | 整数，以供应商币种计价                        | 可接受的最高支付金额。                    |

</details>

`paymentLimit` 仅限制最高支付金额。它不会锁定库存或保证支付、出票成功。

本表仅说明支付请求字段。响应字段定义请参阅 API Reference。

`supportPaymentMethods` 是响应字段，不放入支付请求。请求通过 `paymentMethod` 选择本次支付方式。

若真实姓名或地址无法满足接口格式，请联系 Atlas 确认，不要编造信息。

**查询订单**

调用 `queryOrderDetails.do`：

```json
{
  "orderNo": "<order number>"
}
```

完整请求和响应字段请参阅 [查询订单](https://resources.atriptech.com/api-wen-dang/api-reference/booking-apis/query-order.md)。

先检查查询是否成功，再判断订单及出票状态。Sandbox 流程通过不能替代生产环境下的航司接受情况验证。

**确认结果**

**支付接口成功、取得 PNR、卡片出现交易和最终出票，是不同结果。**

本文区分两个阶段：`pay.do` 的 Atlas 接口处理结果，以及提交 VCC 后航司或支付渠道的扣款和出票结果。前者由 `pay.do.status` 表示；后者需通过 `queryOrderDetails.do` 的订单状态和 `errorCode` 判断。

| 字段                                     | 状态             | 应采取的操作              |
| -------------------------------------- | -------------- | ------------------- |
| `pay.do.status=0`                      | Atlas 支付接口处理成功 | 继续查询最终出票结果。         |
| `orderStatus="1"`                      | 出票中            | 等待并继续查询。            |
| `orderStatus="2"` 且 `ticketStatus="1"` | 出票成功           | 停止支付，保存出票信息。        |
| `orderStatus="-3"`                     | 已取消            | 查看失败原因，并核查原交易和资金状态。 |

`paymentAttempted=true` 只表示 Atlas 曾向航司发起扣卡。它不证明扣款或出票成功。PNR 只能证明航司预订记录已生成；最终结果仍以订单和出票状态为准。

**金额核对及防重复支付**

航司实际扣款可在 VCC 账单中核对。查询订单中的 `vendorCost` 按接口定义表示航司实际扣款金额，币种为 `vendorCurrency`；请与账单共同核对。

不要将报价、授权冻结和正式入账视为同一金额或状态。

为避免重复支付：

* 同一订单同一时间只执行一个支付任务。
* 请求超时、无响应或返回处理中时，先查询，不立即重试。
* 换卡、切换余额或重新生成订单前，核查原交易。
* 保留原订单、新订单及支付尝试之间的关联。
* 不在普通日志、邮件或工单中记录完整卡号、CVV 或接口密钥。

### 4. 功能测试与订单处理

#### 沙箱测试与上线检查

**可实际执行的沙箱测试**

仅在沙箱使用官方测试卡。不得提交真实卡信息。默认使用未来有效期、任意 CVV 与邮编，除非测试场景另有要求。

<details>

<summary>查看沙箱测试场景与通过标准</summary>

| 场景         | 准备条件                                        | 操作                                           | 预期结果与通过标准                                                 |
| ---------- | ------------------------------------------- | -------------------------------------------- | --------------------------------------------------------- |
| 正常 VCC 路径  | 支持 VCC 的沙箱订单；`supportPaymentMethods` 包含 `3` | 使用官方 Visa 或 Mastercard 测试卡调用 `pay.do`，随后查询订单 | 请求被受理；最终查询显示 `orderStatus="2"` 且 `ticketStatus="1"`。      |
| 模拟航司拒绝支付   | 支持 VCC 的沙箱订单；持卡人名字填 `Reject`                | 使用任意测试卡和姓氏调用 `pay.do`；接口已受理或结果未知时查询订单        | 后续查询返回 `errorCode=633`。确认不重试原订单，并按“换卡与重试”处理。              |
| 模拟 3DS 错误  | 支持 VCC 的沙箱订单；持卡人名字填 `Three DS`              | 使用任意测试卡和姓氏调用 `pay.do`；接口已受理或结果未知时查询订单        | 后续查询返回 `errorCode=616`。确认不重试原订单，并改用无需交互式 3DS 的 VCC 或余额支付。 |
| 处理中或超时后的查询 | 已发起支付，未取得明确终态                               | 不重复调用 `pay.do`，使用 `queryOrderDetails.do` 查询  | 能依据订单状态继续等待、停止支付或进入恢复流程。                                  |
| 上线前检查      | 已完成沙箱验证                                     | 确认目标航司、订单级支付方式、卡片额度、费用扣款来源和异常升级路径            | 每项均已确认，且不依赖未验证的 3DS、退款或航司能力假设。                            |

</details>

可使用的 Visa 测试卡包括 `4532015112830366`。可使用的 Mastercard 测试卡包括 `5555555555554444`。完整范围见[沙箱测试卡号](https://resources.atriptech.com/api-wen-dang/support-and-reference/integration-reference/sandbox-test-data/sandbox-test-cards.md)。

支付失败模拟规则见 [沙箱开发](https://resources.atriptech.com/api-wen-dang/readme-1/sandbox-development.md)。

沙箱成功不证明生产环境中的航司受理、发卡方认证或实际扣款结果。

#### 异常处理、换卡与重新生单

**常见错误码**

区分 Atlas 接口处理结果与航司 VCC 扣款／出票结果。前者查看 `pay.do.status`，后者通过 `queryOrderDetails.do` 查看订单状态和 `errorCode`。不要将 HTTP 状态、接口业务代码和出票错误混用。

完整业务错误码请参阅 [错误码](https://resources.atriptech.com/api-wen-dang/support-and-reference/troubleshooting-and-support/errors-handing.md)。

**`pay.do` 接口处理结果**

查看 `pay.do` 响应中的 `status` 字段。以下为该字段的业务码，不是 HTTP 状态码。

<details>

<summary>查看 `pay.do` 接口处理结果</summary>

| 错误码           | 常见含义                             | 下一步                                            |
| ------------- | -------------------------------- | ---------------------------------------------- |
| `400`         | 参数不合法                            | 修正字段后，重试原订单                                    |
| `401`         | 超过支付截止时间                         | 查询后重新生成或预订，并使用新订单重试                            |
| `402` / `404` | 状态不支持支付／已支付                      | 查询状态，**不重试**                                   |
| `403` / `412` | 所选方式不支持／没有可用方式                   | 检查 `supportPaymentMethods`；**不重试**，必要时联系 Atlas |
| `406`         | 支付进行中                            | 等待并查询，**不重试**                                  |
| `407`–`410`   | 乘客、出行组合、行李或联系信息问题                | 修正数据重新生单，**不重试**                               |
| `411`         | 支付网关发生错误                         | 核查输入、账户及订单状态；**不重试，**&#x5FC5;要时联系 Atlas        |
| `413` / `414` | 支付时提交的卡品牌与生单时传入的 `cardType` 不一致。 | 修正字段后，重试原订单                                    |
| `415`         | 用户确认未完成(仅FR航司适用)                 | 完成适用的用户确认后，重试原订单                               |

</details>

**支付后出票阶段**

以下代码来自支付提交后的订单处理结果。通过 `queryOrderDetails.do` 查询订单，并查看响应中的 `errorCode`。此字段与 `pay.do.status` 不同，表示订单后续处理或出票失败原因。此阶段失败时，客户不能重试原订单支付；确认原订单已取消后，才可创建新订单重试。

<details>

<summary>查看支付后出票错误码</summary>

| 错误码           | 常见含义               | 下一步                                 |
| ------------- | ------------------ | ----------------------------------- |
| `601`         | 票价变化               | 核对价格和原订单结果；确认取消后使用新订单重试             |
| `613` / `633` | 航司拒绝交易或 VCC 支付     | 核查原交易；确认取消后换卡或使用余额创建新订单重试           |
| `615`         | 已支付但未取得航司 PNR      | **不重试**；联系 Atlas 跟踪                 |
| `616`         | 需要当前流程无法完成的 3DS 验证 | 核查原交易；确认取消后换卡或使用余额创建新订单重试           |
| `617`         | Atlas 账户余额不足       | 补足账户余额及费用；确认取消后使用新订单重试              |
| `619`         | 支付信息缺失或不正确         | 核查并修正完整卡信息；确认取消后使用新订单重试             |
| `623`         | VCC 额度不足或消费受限      | 核查额度及限制；确认取消后换卡创建新订单重试              |
| `634` / `699` | 航司或系统问题            | 先查询原结果；确认取消后才可使用新订单重试，持续异常时联系 Atlas |

</details>

疑似 BIN 限制时，应核查航司、渠道及发卡方的接受规则，不能把通用拒卡直接认定为 BIN 限制。

航司超时或网络无响应不等于支付失败。不要在结果未知时立即换卡或重新预订。

**换卡与重试**

本节适用于 Atlas 已受理支付请求，但航司 VCC 扣款或后续出票失败的场景。先通过 `queryOrderDetails.do` 确认原订单已取消或不可继续支付。

若 `pay.do` 返回参数、确认或支付方式错误，且原订单仍可支付，应先修正问题后使用原订单支付。支付处理中、结果未知或已出现扣款时，先查询订单，不要立即换卡或重新生成。

航司拒付、卡片额度不足或价格超过支付上限时，订单可能取消。原订单取消后，可重新生成订单，并使用新 VCC 或账户余额继续支付。

**选择重新生单方式**

两种方式均要求原订单已取消，或确认不可继续支付。选择一种方式执行即可，不需要同时使用 API 和 ATRIP 重新生成同一订单。

{% tabs %}
{% tab title="通过 API 重新生单" %}

1. 调用 `regenerateOrder.do`：

```json
{
  "originalOrderNo": "<original order number>"
}
```

完整请求和响应字段请参阅 [重新生成订单](https://resources.atriptech.com/api-wen-dang/api-reference/post-booking-apis/regenerate-order.md)。

2. 使用新订单号调用 `pay.do`。更换 VCC 时，提交完整的新卡信息和 `paymentMethod: 3`；使用账户余额时，传入 `paymentMethod: 1`。
   {% endtab %}

{% tab title="通过 ATRIP 重新生单" %}

1. 在 ATRIP 订单列表中找到原订单，并确认订单状态。
2. 原订单已取消且支持重新生成时，使用 **Regenerate** 创建新订单。

![在 ATRIP 订单列表中选择 Regenerate](https://content.gitbook.com/content/DGvFJgcmYPDYk6hvtLpx/blobs/0koiiauOFuPiXUcAvDEO/attachments/a138dc38-e8a0-42c7-8559-c776cca13e1e.png)

![确认重新生成订单](https://content.gitbook.com/content/DGvFJgcmYPDYk6hvtLpx/blobs/VK5moHotP5Y7rr0Dv0Mt/attachments/43afa425-ea9d-4a5d-a6dc-1d2b323d7e16.png)

3. 在新订单中核对价格及可用支付方式，按页面提供的支付路径继续操作。

![在新订单中完成支付](https://content.gitbook.com/content/DGvFJgcmYPDYk6hvtLpx/blobs/xEFUzln6iDCHultseYgh/attachments/554f4cf9-173c-4d85-86e2-cba558a9aa76.png)
{% endtab %}
{% endtabs %}

新订单需要重新检查价格、可用支付方式和支付截止时间。重新生成不保证保留原价格或库存。结果不明确时先联系 Atlas，不重复支付。

#### 对账、退款与支持

**对账与资金处理**

将 VCC 账单与 `vendorCost`、`vendorCurrency`、订单金额和支付响应中的成本信息分别核对。授权冻结不等于实际入账。

`airlineBookings[].tailDigitsOfPaymentCard` 可用于核对航司实际使用卡号后四位。不要在日志、邮件或工单中提供完整卡号、CVV 或接口密钥。

**退款**

退款流程为 `refundQuotation.do` → `refund.do` → `queryRefundOrders.do`。先获取最新 `refundOfferId`，再提交退款请求并使用 `refundCode` 查询。

VCC 退款通常退回原支付卡。退款报价也可能返回 `Voucher`，部分场景可能要求客户自行退款。订单取消不代表资金已退回。

VCC 退款的完成终态为 `refundStatus=5`。`4` 表示拒绝，`6` 表示撤回。实际到账时间由航司、支付渠道和发卡方决定。

**联系 Atlas 获取支持**

若该VCC卡可以在航司官网人工测试成功，但通过Atlas支付失败，可以联系Atlas协助处理。

{% hint style="warning" %}
联系 Atlas 前，请先完成航司官网人工测试。测试前确认原 Atlas 订单已不再处理中，并避免为同一旅客和行程创建重复预订。
{% endhint %}

{% stepper %}
{% step %}
**官网人工测试**

请客户使用该 VCC（虚拟信用卡）在航司官网尝试支付。如已使用该 VCC 在航司官网完成支付测试，请确认测试结果。
{% endstep %}

{% step %}
**处理测试结果**

如果官网支付失败，通常表示该交易可能被航司风控拦截。请更换其他 VCC 后重试。

如果官网支付成功，请通过 EVA 联系 Atlas，并提供支付成功截图、VCC 供应商名称、订单号、PNR、时间范围、接口请求 ID（如有）和卡片 BIN（前 6 位）。不得提供完整卡号或 CVV。
{% endstep %}

{% step %}
**Atlas 协助处理**

Atlas 将基于订单状态和已提供的脱敏证据协助排查。
{% endstep %}
{% endstepper %}

### 5. 常见问题

<details>

<summary>可以直接透传消费者的信用卡吗？</summary>

不推荐，也不应将消费者的信用卡作为常规 VCC Passthrough 支付方式。

消费者卡通常需要持卡人完成交互式 3DS 验证。当前流程无法承接这类验证，因此即使卡片有效、额度充足，支付仍可能失败。请使用无需持卡人交互的合规 VCC，或改用适用的其他支付路径。

</details>

<details>

<summary>一般哪些情况会导致航司拒卡？</summary>

拒绝可能发生在航司风控、支付网关、收单机构或发卡方，不一定都是银行拒绝。以下为常见机制，不代表某笔 Atlas 订单已确认命中这些原因。

| 类型               | 常见情况                                                                         |
| ---------------- | ---------------------------------------------------------------------------- |
| 卡资料或账单信息不匹配      | 卡号、有效期或 CVV 错误；账单地址或邮编与发卡方记录不一致，可能触发 AVS 或其他校验。不要用乘客或联系人地址代替卡片账单地址。          |
| 单卡可用额度不足         | 实际授权金额超过单卡剩余额度、单笔限额或周期限额。应核对实际支付金额，而不只是开卡时的票价。                               |
| 整体资金或授信不足        | 单卡额度足够，但背后账户可用余额、可用授信或适用币种资金不足。具体校验方式取决于发卡产品的资金模型。                           |
| 先前授权占用资金         | 前次支付未出票，但授权仍未释放；多笔并发或重试叠加占款，导致后续可用额度不足。                                      |
| 单次卡或多次卡配置不适配     | 航司可能拆分扣款，或先小额预授权、撤销后再正式扣款。卡的次数或额度规则不支持时，交易可能被拒。须向发卡方确认撤销后的使用次数和额度释放规则。       |
| 卡的使用范围或状态受限      | 卡片不允许该商户、MCC、商户国家、币种或交易类型；卡被冻结、关闭、过期，或不在允许使用日期内。                             |
| 航司不接受该卡产品或受理成本较高 | 商业卡或虚拟卡产品可能与商户接受政策不匹配。高 rebate 可能与商户受理成本有关，但不能仅凭 rebate 高认定必然拒卡，也不存在通用的拒卡阈值。 |
| 3DS 认证未完成或失败     | 支付需要身份认证，但认证未完成、失败或结果未正确提交。当前流程无法承接需要持卡人交互的 3DS；即使资金充足，交易仍可能被拒。              |
| 风控、重复交易或频次限制     | 航司、收单机构或发卡方将交易判定为可疑；短时间重复提交可能触发重复交易或频次规则。                                    |

实际排查时，至少核对：

* **金额与资金：** 实际授权金额及币种、单卡剩余额度、账户可用余额或授信，以及未释放的授权。
* **支付次数与流程：** 第几次请求、授权还是扣款、是否拆分扣款、卡片剩余使用次数，以及撤销是否已生效。
* **资料与认证：** 发卡方登记的账单资料、AVS 和 CVV 校验结果，以及 3DS 认证结果。
* **卡产品与限制：** 单次卡或多次卡、商户及 MCC 限制、商户国家、允许币种、有效使用日期、卡产品及 interchange 档位。
* **原始拒绝证据：** 拒绝发生层级、原始拒绝码，以及授权、撤销和清算终态。

仅有 `PAYMENT_DECLINED`、`REJECT` 或“支付失败”，通常不足以确认具体原因。网络超时、页面拦截和参数校验错误应单独分析，不能直接视为拒卡。

银行授权成功、航司接受支付和最终出票是不同状态。拒绝也不能自动证明不存在未释放授权或其他扣款。比较不同卡的拒绝率时，应对比同航司、同渠道的成功与失败支付记录，不能只看取消订单。

</details>

<details>

<summary>卡已扣款，但订单失败或取消</summary>

先向发卡方确认是授权冻结还是正式入账，再联系 Atlas 核查原订单。

订单取消、授权撤销和退款完成是不同事件。不要默认系统会立即撤销或退款，也不要立即再次付款。

</details>

<details>

<summary>单次卡失败后还能再用吗？</summary>

取决于卡片和交易状态。失败不代表未产生授权或卡片未被消耗，应先向发卡方核查。

</details>

<details>

<summary>官网成功，为什么透传失败？</summary>

官网与透传可能使用不同渠道和交易上下文。高额交易、短时高频交易及其他风控条件可能影响结果，但不能只根据官网成功或失败确定原因。

</details>

### 6. 更新日志

**本页更新记录**

本节仅记录影响本页阅读或使用方式的内容变更。产品与 API 行为更新请参阅 [Atlas API 文档更新](https://resources.atriptech.com/api-wen-dang/readme.md)。

**2026-11-12**

**新增内容**

* 新增功能测试说明，包括正常支付、模拟航司拒绝、模拟 3DS 错误和上线前检查。
* 新增换卡、重试和重新生单说明，明确何时查询原订单、何时可以创建新订单。
* 新增常见问题，覆盖消费者卡、拒卡原因、扣款后取消、单次卡复用及官网成功但透传失败等场景。
* 新增支持航司及卡组织清单，明确 86 家航司的 Visa 和 Mastercard 支持范围。
* 补充订单级支付方式确认、最终出票判断、对账、退款和支持处理说明。
* 按概览、前置条件、接入、测试与订单处理等任务重组单页内容。

**接口行为未变更**

* 本次未调整接口请求、响应或支付规则。

### 7. 附件

以下按本指南采用的能力清单列示。具体订单仍需检查接口返回及适用限制，其他卡组织不在本清单确认范围内。首次接入请先阅读[第 2 节](https://resources.atriptech.com/api-wen-dang/product-guides/booking/booking-step-guides/payment-and-ticketing/vcc-passthrough-shi-yong-zhi-nan#id-2.-qian-zhi-tiao-jian)；仅在核对覆盖范围时展开本清单。

#### 相关参考

* [支付与出票](https://resources.atriptech.com/api-wen-dang/api-reference/booking-apis/payment-and-ticketing.md)
* [查询订单](https://resources.atriptech.com/api-wen-dang/api-reference/booking-apis/query-order.md)
* [退款](https://resources.atriptech.com/api-wen-dang/api-reference/post-booking-apis/refunds.md)
* [支付](https://resources.atriptech.com/api-wen-dang/support-and-reference/troubleshooting-and-support/faqs/atlas-api-payments.md)
* [沙箱测试卡号](https://resources.atriptech.com/api-wen-dang/support-and-reference/integration-reference/sandbox-test-data/sandbox-test-cards.md)
* [错误码](https://resources.atriptech.com/api-wen-dang/support-and-reference/troubleshooting-and-support/errors-handing.md)

#### 支持航司及卡组织

<details>

<summary>查看完整支持航司及卡组织清单</summary>

| 航司                       | 代码 | Visa | Mastercard |
| ------------------------ | -- | ---- | ---------- |
| Advanced Airlines        | AN | 支持   | 支持         |
| Aer Lingus               | EI | 支持   | 支持         |
| AeroItalia               | XZ | 支持   | 支持         |
| Air Arabia               | G9 | 支持   | 支持         |
| Air Arabia Abu Dhabi     | 3L | 支持   | 支持         |
| Air Arabia DMM           | 4P | 支持   | 支持         |
| Air Arabia Egypt         | E5 | 支持   | 支持         |
| Air Arabia Maroc         | 3O | 支持   | 支持         |
| Air Busan                | BX | 支持   | 支持         |
| Air Do                   | HD | 支持   | 支持         |
| Air Malta                | KM | 支持   | 支持         |
| Air North                | 4N | 支持   | 支持         |
| Air Seoul                | RS | 支持   | 不支持        |
| Air Transat              | TS | 支持   | 支持         |
| Alaska Airlines          | AS | 支持   | 支持         |
| Allegiantair             | G4 | 支持   | 支持         |
| Alliance Airlines        | QQ | 支持   | 支持         |
| Amakusa Airlines         | MZ | 支持   | 支持         |
| Amapola                  | HP | 支持   | 支持         |
| Arajet                   | DM | 支持   | 支持         |
| Aurigny                  | GR | 支持   | 支持         |
| Azul Airlines            | AD | 支持   | 支持         |
| Azul Conecta             | 2F | 支持   | 支持         |
| Calm Air                 | MO | 支持   | 支持         |
| Cebgo                    | DG | 支持   | 支持         |
| Cebu Pacific Air         | 5J | 支持   | 支持         |
| Central Mountain Air     | 9M | 支持   | 支持         |
| Chair Airlines           | CS | 支持   | 支持         |
| Condor                   | DE | 支持   | 支持         |
| Corendon Airlines        | XC | 支持   | 支持         |
| Corendon Airlines Europe | XR | 支持   | 支持         |
| Corendon Dutch Airlines  | CD | 支持   | 支持         |
| DAT                      | DX | 支持   | 支持         |
| Enter Air                | E4 | 支持   | 支持         |
| Eurowings                | EW | 支持   | 支持         |
| Eurowings Europe         | E6 | 支持   | 支持         |
| Firefly                  | FY | 支持   | 支持         |
| Fly Jinnah               | 9P | 支持   | 支持         |
| FlyOne                   | 5F | 支持   | 支持         |
| FLYONE Armenia           | 3F | 支持   | 支持         |
| Flyone Romania           | OE | 支持   | 支持         |
| FlySafair                | FA | 支持   | 支持         |
| Freebird Airlines Europe | MI | 支持   | 支持         |
| Freebirdairlines         | FH | 支持   | 支持         |
| Frontier Airlines        | F9 | 支持   | 支持         |
| Fuji Dream Airlines      | JH | 支持   | 支持         |
| Helvetic Airways         | 2L | 支持   | 支持         |
| HiSky                    | H7 | 支持   | 支持         |
| HiSky                    | H4 | 支持   | 支持         |
| Iberia Express           | I2 | 支持   | 支持         |
| Jeju Air                 | 7C | 支持   | 不支持        |
| Jet2                     | LS | 支持   | 支持         |
| Jin Air                  | LJ | 支持   | 支持         |
| Lift Airline             | GE | 支持   | 支持         |
| Marabu                   | DI | 支持   | 支持         |
| Neos Air                 | NO | 支持   | 支持         |
| Norse Atlantic Airways   | N0 | 支持   | 支持         |
| Norse Atlantic UK        | Z0 | 支持   | 支持         |
| Nouvelair                | BJ | 支持   | 支持         |
| Pacific Coastal          | 8P | 支持   | 支持         |
| PAL Airlines             | PB | 支持   | 支持         |
| Pascan                   | P6 | 支持   | 支持         |
| Peach Aviation           | MM | 支持   | 支持         |
| Perimeter                | JV | 支持   | 支持         |
| Ryanair                  | FR | 支持   | 支持         |
| Ryanair UK               | RK | 支持   | 支持         |
| Sharp Airlines           | SH | 支持   | 支持         |
| Skyexpress               | GQ | 支持   | 支持         |
| Skymark Airlines         | BC | 支持   | 支持         |
| Skytrans                 | QN | 支持   | 支持         |
| Solaseed Air             | 6J | 支持   | 支持         |
| Star Flyer               | 7G | 支持   | 支持         |
| Sun Country Airlines     | SY | 支持   | 支持         |
| Tigerair Taiwan          | IT | 支持   | 支持         |
| TOKI AIR                 | BV | 支持   | 支持         |
| Tus Airways              | U8 | 支持   | 支持         |
| Vietravel Airlines       | VU | 支持   | 支持         |
| Volaris                  | Y4 | 支持   | 支持         |
| Volaris Costa Rica       | Q6 | 支持   | 支持         |
| Volaris El Salvador      | N3 | 支持   | 支持         |
| Volotea                  | V7 | 支持   | 支持         |
| Vueling Airlines         | VY | 支持   | 支持         |
| Wizz Air                 | W6 | 支持   | 支持         |
| Wizz Air Malta           | W4 | 支持   | 支持         |
| Wizz Air UK              | W9 | 支持   | 支持         |
| ZIPAIR                   | ZG | 支持   | 支持         |

未列航司请先联系 Atlas 确认，不要推定支持。

</details>
