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
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:
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=1andvendorFarecontains a price.The airline does not support VCC when
supportCreditTransPayment=0orvendorFareis 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:
When the airline price increases
With a limit: Set
paymentLimitto 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. The5%allowance isUSD 2.5. The price-variation threshold isUSD 10.Case 2 — 1 passenger: The per-passenger allowance is
USD 5. The5%allowance isUSD 15. The price-variation threshold isUSD 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.
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
Option 2: ATrip
FAQ
VCC Pass-through failure support
Complete a manual test payment before requesting support.
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?




