Vughy
Vughy for Airlines

Offer visa services at booking

A B2B airline portal that lets carriers register, fund a prepaid vault, submit passenger visa applications from their own systems, and track every application through a multi-role workflow — powered by Vughy's live visa routing and fee APIs.

JWT + API key authLive Vughy visa pricingPrepaid vault billing
What it is

Visa services built for airlines, not travel agents.

Vughy for Airlines is a full-stack B2B platform that connects airline reservation and check-in systems to Vughy's global visa infrastructure. Airlines register, fund a prepaid account, integrate via API, and let Vughy's operations team process every passenger visa application — while airline teams get full visibility through dedicated dashboards.

Airline self-registration

Airlines sign up with IATA number, country, and auto-selected currency. Email verification ensures only legitimate carriers get access.

Prepaid vault & billing

Balance-based accounts with Stripe card top-ups, transaction passbook, low-balance email alerts, and per-country minimum thresholds.

API-driven visa intake

Submit passenger visa applications from reservation, DCS, or check-in systems using a single API key — no airline_id in the payload.

Live Vughy visa pricing

Route and visa type resolved against Vughy's live APIs. Service fees are calculated and deducted from the vault before each submission.

Operations workflow

Applications move through new → processing → error | finalize pools. Full status history audit trail on every application.

Analytics & reports

Status breakdowns, monthly trends, and route/visa-type charts so airline and ops teams always know what's happening.

How it works

From registration to processed visa — end to end.

Six steps from airline signup to passenger visa completion.

01

Register your airline

Sign up with IATA number, country, and contact details. Currency is auto-selected from your country. Verify your email to activate the account.

02

Fund your vault

Top up your prepaid balance via Stripe in your registered currency. Super Admins can also grant promotional credits. Low-balance alerts keep you funded.

03

Generate an API key

Create a vfa_-prefixed API key from the API Integration panel. Regenerate or revoke keys anytime. Your airline is identified automatically from the key.

04

Submit visa applications

POST passenger visa data from your booking or check-in system. Vughy resolves the route, calculates live fees, and deducts from your vault.

05

Vughy processes applications

Operations managers claim applications from the pool, move them to processing, and resolve to error or finalize with required descriptions.

06

Track in your dashboard

Airline Admins see every application with matched manager names. Airline Managers see route-filtered views. Full status history on every record.

Application status lifecycle

New

Submitted via API. Waiting for a Vughy manager to claim.

Processing

Assigned to a Vughy manager and actively being worked.

Error

Issue flagged with a required description. Visible in the Error Pool.

Finalize

Completed successfully with a required description. Visible in the Finalize Pool.

Integration

One API key. Zero config. Your airline identified automatically.

Generate a vfa_-prefixed key from the dashboard, then POST visa applications from your booking engine, DCS, or check-in system.

Request body

POST /api/visa-applications
{
  "passenger_id": "PNR-ABC123-001",
  "from_country_id": "101",
  "to_country_id": "205",
  "visa_type": "Tourist Visa",
  "customer_visa_application_data": {
    "first_name": "Jane",
    "last_name": "Doe",
    "passport_number": "AB1234567",
    "nationality": "IN",
    "date_of_birth": "1990-05-15"
  }
}

Success response

201 Created
{
  "message": "Visa application created",
  "application": {
    "id": 42,
    "passenger_id": "PNR-ABC123-001",
    "from_country": "India",
    "to_country": "United Arab Emirates",
    "visa_type": "Tourist Visa",
    "application_status": "new"
  },
  "charge": {
    "visa_service_fee": 45.00,
    "currency": "USD"
  },
  "vault_balance": 955.00
}

cURL example

cURL
"text-violet-300 font-semibold">curl "text-sky-300">-X "text-violet-300 font-semibold">POST https://your-airlines-api.example.com/api/visa-applications \
  "text-sky-300">-H "Content-Type: application/json" \
  "text-sky-300">-H "X-API-Key: vfa_your_api_key_here" \
  "text-sky-300">-d '{
    "passenger_id": "PNR-ABC123-001",
    "from_country_id": "101",
    "to_country_id": "205",
    "visa_type": "Tourist Visa",
    "customer_visa_application_data": {
      "first_name": "Jane",
      "last_name": "Doe",
      "passport_number": "AB1234567"
    }
  }'

Required fields

FieldTypeDescription
passenger_idstringYour passenger or PNR reference
from_country_idstringOrigin country ID (Vughy visa API)
to_country_idstringDestination country ID
visa_typestringVisa type name or numeric ID
customer_visa_application_dataJSONPassport, name, and application fields
Authentication: Send your API key in the X-API-Key header. Returns 402 if vault balance is insufficient. Fees are resolved live from the Vughy Visa API before deduction.
FAQ

Common questions

How is my airline identified in API calls?+

Your API key (prefixed vfa_) is tied to your Airlines Admin account. Send it in the X-API-Key header — no airline_id needed in the request body.

What happens if my vault balance is too low?+

The API returns HTTP 402 with an insufficient balance error. You'll also receive a one-time low-balance email alert when your balance drops below the configured threshold for your country.

How are visa fees calculated?+

Fees are fetched live from the Vughy Visa API based on the from/to country route and visa type. The exact fee is deducted from your vault before the application is created.

Can airline managers change application status?+

No. Airlines Managers have read-only access filtered by their assigned routes. Only Vughy internal Managers can claim and update application status.

What systems can integrate with the API?+

Any system that can make HTTPS POST requests — PSS, DCS, check-in kiosks, booking engines, or middleware. Typical integration points are at booking confirmation or check-in.

How do I get started?+

Register your airline, verify your email, fund your vault, and generate an API key from the dashboard. Contact Vughy if you need a dedicated deployment or custom integration support.

Ready to offer visa services at booking?

Register your airline, fund your vault, and integrate with a single API key. Vughy's operations team handles every application.

  • Self-serve airline registration
  • Live visa pricing per route
  • Full status visibility