VCC Passthrough

VCC Passthrough 使用说明

一、什么是 VCC 支付

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

核心优势

• 安全性：避免存储真实信用卡信息，降低数据泄露风险。

• 简化合规：由航司或支付服务商直接处理敏感信息，减少合规负担。

• 灵活结算：可设置 VCC 限额或单次使用，便于退款或费用控制（如服务费分离）。

• 自动化：适合高频交易，减少人工对账成本。

二、VCC 支付流程

1

价格获取

通过 Search/Verify/Order 接口中的 VendorFare 对象获取 VCC 支付价格。

2

支付

通过 pay.do 接口发起支付请求，需传入以下关键参数：

{
    "orderNo": "订单号",
    "supportCreditTransPayment": "1",
    "creditCard": {
        "cardNumber": "卡号",
        "cardExpireMonth": "到期月份（MM）",
        "cardExpireYear": "到期年份（YYYY）",
        "cardCVV": "***",
        "cardHolderLastName": "持卡人姓氏",
        "cardHolderFirstName": "持卡人名",
        "cardHolderCountry": "持卡人国家",
        "cardHolderCity": "持卡人城市",
        "cardHolderPostCode": "邮编",
        "cardHolderAddress": "账单地址"
    },
    "paymentMethod": "3"  // 固定传值3表示VCC支付
}

关键字段说明：

字段	类型	说明及传值
paymentMethod	必填	使用的支付方式，如需使用 vcc 支付，这里需要传 3
creditCard	必填	需完整传递虚拟信用卡信息
paymentLimit	可选	设置最高可接受票价（详见下方「价格变动处理」）

三、使用规范与注意事项

适用订单范围

• 判断方式：调用 search 接口时，若返回的 supportCreditTransPayment=1 且 vendorFare 对象存在价格，则表示支持 VCC 支付。

• 不适用场景：若 supportCreditTransPayment=0 或 vendorFare 为空，则航司不支持该方式。

价格变动处理策略

由于 VCC 支付方式是将客户的虚拟信用卡信息直接传递给航空公司完成支付，故通过这种支付方式 Atlas 无法进行任何的价格保护。针对部分无法占座、支付时需要增加额外手续费的航司，在实际出票过程中票价会有涨跌变化，这部分的金额变动需要由客户自己承担。Atlas 会在中间进行一些保护策略：

1

航司降价时

系统自动按低价出票，实际扣款金额为最终成交价（可在 VCC 账单中确认实际扣款金额）。

2

航司涨价时

• 用户设置上限：通过 paymentLimit 指定最高可接受金额。若涨价后金额 ≤ 上限则正常扣款（可在 VCC 账单中确认实际扣款金额）；若超限则出票失败。

• 未设置上限：

  • 价格变动阈值：max(订单金额 × 5%, USD 5 × 乘客人数)

  • 默认支付上限：订单金额 + 价格变动阈值

  • 余额要求：VCC 余额必须覆盖默认支付上限，否则订单将取消。

  计算示例

  场景	按人计算	按订单金额的 5% 计算	价格变动阈值
  2 名乘客，订单金额 USD 50	USD 5 × 2 = USD 10	USD 50 × 5% = USD 2.5	USD 10
  1 名乘客，订单金额 USD 300	USD 5 × 1 = USD 5	USD 300 × 5% = USD 15	USD 15

VCC 卡使用建议

• 建议使用单次卡（如使用多次卡，请明确告知不可重试，避免重复多次扣款带来损失）。

• 预留部分 VCC 开卡金额（避免航司变价）。

支付成功率优化指南

变价处理

• 设置可接受金额上限。

• 预留部分 VCC 开卡金额。

基础配置

• 开通 3DS 自动通过：要求 VCC 供应商启用所有交易的 3DS 自动验证功能（核心前置条件）。

用卡策略

策略类别	推荐操作
卡类型	✅ 优先选择与航司属地一致的本地主流卡（如欧美航司用 VISA/Mastercard） ⚠️ 避免预付卡、虚拟银行匿名卡及高风险地区发卡
交易限额	单笔≤$5,000（大额支付需提前与发卡行确认限额）
交易间隔	同一卡号支付间隔≥15分钟，避免触发风控
环境一致性	支付 IP/设备指纹需与卡归属地匹配，必要时使用 VPN 模拟本地环境

信息填写规范

• 持卡人姓名需与订票信息完全一致。

• 账单地址建议模拟真实地址，优先匹配持卡人所在地。

免责声明：以上建议基于行业通用经验，实际结果可能受航司风控策略、发卡行政策等因素影响。

支付失败处理

场景说明

因航司风控、余额不足或价格超限导致支付失败时，订单状态将变更为 Cancel。

解决方案

API

1

重新生成订单

调用 regenerateOrder.do 接口：

{
  "originalOrderNo": "{original order no}"
}

2

选择新的支付方式

调用 pay.do 接口，可更换成新卡或使用账户余额支付：

{
  "orderNo": "{new order no}",
  "supportCreditTransPayment": null, // no need
  "creditCard": null
}

ATrip

1

登录 ATrip 系统

进入「My Bookings」找到需处理的订单，点击「Regenerate」获取新订单号。

2

余额支付

在新订单详情页点击「Pay」按钮，系统将自动使用账户余额完成扣款。

四、FAQ

vcc 支付时，报价与实际出票价格是否会存在差异，差异需要如何处理？

会存在差异。这部分金额全部由代理人自行承担，自负盈亏。具体的盈亏数据可在 dashboard-price change 查看。

vcc 支付支持哪些航司？

可在 Airline List 中筛选 Payment Method 为 VCC 的航司。

支付给航司的实际金额可以在哪里看到？

可以在 2 个地方看到：

1. 可在 VCC 的账单中查看。

2. 出票成功后，在 order detail 接口也将返回实际金额。

vcc 支付场景下 Atlas 是什么角色？

Atlas 作为技术服务商提供自动出票服务，实际出票人是代理人自己。

为什么有些 VCC 卡在官网可以支付成功，通过 Atlas 透传却支付失败了？

这里涉及到航司的风控策略，单笔高额交易、短时高频交易以及其他场景都可能会触发风控警报。

五、Atlas 处理 VCC 透传交易失败指南

请确保您已经走过人工测试支付的流程！

1

人工测试支付

请客户使用该 VCC（虚拟信用卡）在航司官网尝试支付。

2

确认支付结果

支付失败：如果支付失败，很大概率是航司基于其风控规则拦截了订单，请您更换其他的 VCC 进行支付。

支付成功：如果支付成功，可以提交工单给 Atlas，内容包括：

• 保存且附上支付成功的截图。

• 提供 VCC 供应商的名称。

• 提供 VCC 的 BIN 号（前 6 位卡号）。

3

Atlas 协助处理

Atlas 将协助进一步处理，确保支付流程顺畅。

通过以上步骤，Atlas 将协助您处理 VCC 透传交易失败的情况，确保支付流程顺利进行。

附录：VCC 支付相关校验

字段	校验
cardNo	卡号必须为13-19位数字 输入的卡号不符合信用卡号校验逻辑（不符合 Luhn 算法） 卡号被风控拒绝（相同的卡号在30分钟内失败5次以上，会触发该报错，该卡在24小时内不再可以使用）
cardExpire	cardExpireMonth 必须传入1-12的数字 cardExpireYear 必须传入2位或4位数字 cardExpire 必须大于等于当前年月
cardCVV	cardCVV 必须为3-4位数字
cardHoldName	cardHolderLastName 只能使用以下字符：A-Z、a-z、-、À-Ö、Ø-ö、ø-ÿ cardHolderFirstName 只能使用以下字符：A-Z、a-z、-、À-Ö、Ø-ö、ø-ÿ

卡相关地址信息要求必填。

字段	校验
cardHolderCountry	cardHolderCountry 必须是2位字母，且需要符合 ISO3166 标准
cardHolderProvince	与该卡关联的账单地址所在的州/省。请仅使用两位字母代码，例如使用“CA”，而非“California”。
cardHolderCity	cardHolderCity 不能为纯数字
cardHolderPostCode	cardHolderPostCode 只能为数字或英文字母，长度大于4
cardHolderAddress	cardHolderAddress 必须大于6个字符