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

VCC Pass-through Guide

Use virtual credit cards for airline payments, manage price changes, and recover from payment failures.

VCC Pass-through Guide

What is VCC payment

VCC Pass-through lets agents, including OTAs and TMCs, settle airline payments with virtual credit cards (VCCs). You send the customer's VCC details directly to the airline. You do not need to store or process the card data.

Key benefits

  • Security: Avoid storing card data and reduce data-exposure risk.

  • Simpler compliance: Airlines or payment providers handle sensitive payment data.

  • Flexible settlement: Set VCC limits or use single-use cards for refunds and cost control.

  • Automation: Support high-volume payments and reduce reconciliation effort.

VCC payment flow

1

Get the price

Retrieve the VCC payment price from VendorFare in the Search, Verify, or Order response.

2

Pay

Call pay.do with these required parameters:

{
    "orderNo": "order number",
    "supportCreditTransPayment": "1",
    "creditCard": {
        "cardNumber": "card number",
        "cardExpireMonth": "expiry month (MM)",
        "cardExpireYear": "expiry year (YYYY)",
        "cardCVV": "***",
        "cardHolderLastName": "cardholder last name",
        "cardHolderFirstName": "cardholder first name",
        "cardHolderCountry": "cardholder country",
        "cardHolderCity": "cardholder city",
        "cardHolderPostCode": "postal code",
        "cardHolderAddress": "billing address"
    },
    "paymentMethod": "3"  // Use 3 for VCC payment
}

Key fields:

Field
Requirement
Description

paymentMethod

Required

Send 3 for VCC payment.

creditCard

Required

Send complete virtual-card details.

paymentLimit

Optional

Set the highest acceptable fare. See price change handling below.

Requirements and considerations

Eligible orders

  • VCC is supported when Search returns supportCreditTransPayment=1 and vendorFare contains a price.

  • The airline does not support VCC when supportCreditTransPayment=0 or vendorFare is empty.

Price change handling

VCC Pass-through sends the customer's card directly to the airline. Atlas cannot protect the fare. Airlines that cannot hold seats or add payment fees may change the final price. The customer bears any difference. Atlas applies these safeguards:

1

When the airline price decreases

The system issues the ticket at the lower price. The VCC statement shows the final charged amount.

2

When the airline price increases

  • With a limit: Set paymentLimit to the highest acceptable amount. Payment proceeds when the final amount is within the limit. Otherwise, ticketing fails.

  • Without a limit: The default limit is the order amount plus max(5% of order amount, USD 5 per passenger). The price-variation threshold is the higher of these two calculated amounts:

    • Case 1 — 2 passengers: The per-passenger allowance is USD 5 × 2 = USD 10. The 5% allowance is USD 2.5. The price-variation threshold is USD 10.

    • Case 2 — 1 passenger: The per-passenger allowance is USD 5. The 5% allowance is USD 15. The price-variation threshold is USD 15.

    Ensure the VCC has enough balance for the order amount and the applicable threshold. Otherwise, the order is cancelled.

VCC recommendations

  • Use single-use cards. Do not retry multi-use cards after a failure. This avoids duplicate charges.

  • Add a buffer to the VCC amount for airline price changes.

Improve payment success rates

Price changes

  • Set an acceptable payment limit.

  • Add a buffer to the VCC amount.

Basic setup

  • Enable automatic 3DS approval: Ask your VCC provider to enable automatic 3DS authentication for all transactions.

Card strategy

Category

Recommendation

Card type

✅ Prefer locally issued mainstream cards that match the airline's region, such as Visa or Mastercard for European and North American airlines. ⚠️ Avoid prepaid cards, anonymous virtual-bank cards, and cards issued in high-risk regions.

Transaction limit

Keep each transaction at or below USD 5,000. Confirm higher limits with the issuer in advance.

Transaction interval

Wait at least 15 minutes between payments with the same card number.

Environment consistency

Match the payment IP address and device fingerprint to the card region. Use a local VPN only when necessary.

Cardholder information

  • Match the cardholder name exactly to the booking information.

  • Use a realistic billing address. Prefer the cardholder's location.

Disclaimer: These recommendations reflect general industry experience. Airline risk controls and issuer policies may affect results.

Payment failure recovery

What happens

The order changes to Cancel when payment fails due to airline risk controls, insufficient funds, or a price above the limit.

Option 1: API

1

Regenerate the order

Call regenerateOrder.do:

2

Choose a new payment method

Call pay.do. You can use another card or your account balance:

Option 2: ATrip

1

Sign in to ATrip

Open My Bookings, find the affected order, then select Regenerate to get a new order number.

2

Pay by balance

Open the new order and select Pay. The system charges your account balance automatically.

FAQ

Can the quoted price differ from the final ticketing price?

Yes. The agent bears any difference. Check profit and loss data in Dashboard → Price Change.

Which airlines support VCC payment?

In Airline List, filter airlines where Payment Method is VCC.

Where can I see the amount charged by the airline?

Check the VCC statement. After ticketing succeeds, the Order Details response also returns the actual amount.

What is Atlas's role in VCC payment?

Atlas provides automated ticketing as a technical service provider. The agent is the actual ticket issuer.

Why can a VCC work on an airline website but fail through Atlas?

Airline risk controls can block the charge. High-value or high-frequency transactions may trigger those controls.

VCC Pass-through failure support

1

Test the payment manually

Ask the customer to try payment with the VCC on the airline website.

2

Confirm the result

Payment fails: The airline likely blocked the payment under its risk controls. Use a different VCC.

Payment succeeds: Submit a ticket to Atlas with:

  • A screenshot of the successful payment.

  • The VCC provider name.

  • The VCC BIN, which is the first six card digits.

3

Atlas investigation

Atlas investigates the issue and supports the payment flow.

These steps help Atlas investigate VCC Pass-through transaction failures.

Appendix: VCC payment validation

Field

Validation

cardNo

The card number must contain 13–19 digits. The number must pass Luhn validation. The system blocks a card after more than five failed attempts within 30 minutes. That card remains unavailable for 24 hours.

cardExpire

cardExpireMonth must be a number from 1 to 12. cardExpireYear must contain two or four digits. The expiry date must be the current month or later.

cardCVV

cardCVV must contain three or four digits.

cardHoldName

cardHolderLastName and cardHolderFirstName may contain only A–Z, a–z, -, À–Ö, Ø–ö, and ø–ÿ.

All card address fields are required.

Field

Validation

cardHolderCountry

Must contain two letters and meet ISO 3166.

cardHolderProvince

The state/province of the billing address associated with the card. Only use tow-letter code, for example, use "CA" and not "California".

cardHolderCity

Cannot contain only digits.

cardHolderPostCode

May contain only letters and digits. Length must exceed four characters.

cardHolderAddress

Must contain more than six characters.

Last updated

Was this helpful?