Download the PHP package santosdave/verteil-wrapper without Composer

Verteil NDC API Laravel Wrapper

A Laravel package for easy integration with the Verteil NDC API for airline bookings, searches, and management. This package provides a robust interface for interacting with Verteil's NDC API, including comprehensive error handling, rate limiting, caching, and monitoring capabilities.

Features

• Easy-to-use interfaces for all major Verteil API operations
• Type-safe request building with helper classes
• Built-in validation and error handling
• Automatic token management and refresh
• Request rate limiting
• Response caching
• Comprehensive logging
• Retry handling for failed requests
• Health monitoring and metrics collection
• Security features including input sanitization and secure token storage
• Supports all Verteil NDC API endpoints:
  • Air Shopping
  • Flight Price
  • Order Creation
  • Order Retrieval
  • Order Cancellation
  • Seat Availability
  • Service List
  • Order Change
  • Order Reshop
  • Itinerary Reshop
  • Order Change Notifications

Installation

Install the package via Composer:

Laravel Configuration

1. Publish the configuration file:

2. Add your Verteil credentials to your .env file:

Basic Usage

Initialization

Authentication

The package handles authentication automatically, but you can manually authenticate if needed:

Air Shopping Example

The response will contain available flights sorted by:

1. Price (lowest first)
2. Number of stops (direct flights first)
3. Departure time (earlier flights first)

Available cabin codes:

• Y: Economy
• W: Premium Economy
• C: Business Class
• F: First Class

Shop Result Preferences:

• OPTIMIZED: Same fare brands for every flight combination
• FULL: All available offers
• BEST: One best offer per flight combination

Flight Price Example

Order Creation Example

`php $orderCreateParams = [ 'query' => [ // ... order details ... ], 'metadata' => [ 'other' => [ [ // Price metadata with augmentation points 'price' => [ [ 'key' => 'VDC-AIRLINE-SRID', 'augmentationPoints' => [ [ 'javaType' => 'java.util.HashMap', 'value' => [ 'metavalue1' => 'value1', 'metavalue2' => 'value2' ], 'key' => 'someKey' ] ], 'offerItemRefs' => ['OI1', 'OI2'], 'description' => 'Price metadata description' ] ], // Payment form metadata 'paymentForm' => [ [ 'key' => 'PAYMENT_FORM1', 'text' => 'Credit Card Payment', 'description' => 'Payment form for credit card transactions', 'warningText' => 'Please ensure card details are correct', 'restrictionText' => 'Minimum amount: 10 INR' ] ], // Currency metadata with extended attributes 'currency' => [ [ 'key' => 'INR', 'decimals' => 2, 'roundingPrecision' => 0.01, 'exchangeRate' => [ 'rate' => 1.0, 'baseCurrency' => 'INR', 'targetCurrency' => 'EUR' ], 'displayFormat' => '#,##0.00', 'allowedPaymentCurrencies' => ['INR', 'EUR', 'GBP'] ] ] ] ] ], 'payments' => [ [ 'amount' => 580.00, 'currency' => 'INR', 'card' => [ 'number' => '4111111111111111', 'expiryDate' => '1225', 'cvv' => '123', 'brand' => 'VI', 'holderName' => 'John Doe', // SecurePaymentVersion is automatically added 'billingAddress' => [ 'street' => '123 Main St', 'postalCode' => '12345', 'city' => 'London', 'countryCode' => 'GB' ] ] ] ] ];

try { $response = $verteilService->createOrder($orderCreateParams);

if ($response) {
    echo "Order created successfully!\n";
    echo "Order ID: " . $response->getOrderId() . "\n";
}

} catch (\Santosdave\VerteilWrapper\Exceptions\VerteilApiException $e) { echo "Error creating order: " . $e->getMessage() . "\n"; } bash php artisan verteil:health bash php artisan verteil:health php artisan verteil:cache:flush php artisan verteil:cache:flush airShopping bash composer test

### Advanced Configuration

The package provides extensive configuration options:

## Contributing

Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.

## Security

If you discover any security-related issues, please email [email protected] instead of using the issue tracker.

## Credits

santosdave

## License

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.