For the complete documentation index, see llms.txt. This page is also available as Markdown.

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=1vendorFare 对象存在价格,则表示支持 VCC 支付。

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

价格变动处理策略

由于 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。

解决方案

1

重新生成订单

调用 regenerateOrder.do 接口:

2

选择新的支付方式

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

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个字符

Last updated

Was this helpful?