PHPackages                             santosdave/verteil-wrapper - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. santosdave/verteil-wrapper

ActiveLibrary[API Development](/categories/api)

santosdave/verteil-wrapper
==========================

Laravel package for Verteil NDC API integration

v3.0.1(1y ago)0241MITPHPPHP ^8.1

Since Dec 3Pushed 1y ago1 watchersCompare

[ Source](https://github.com/santosdave/verteil-wrapper)[ Packagist](https://packagist.org/packages/santosdave/verteil-wrapper)[ RSS](/packages/santosdave-verteil-wrapper/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (5)Versions (24)Used By (0)

Verteil NDC API Laravel Wrapper
===============================

[](#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
--------

[](#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
------------

[](#installation)

Install the package via Composer:

```
composer require santosdave/verteil-wrapper
```

### Laravel Configuration

[](#laravel-configuration)

1. Publish the configuration file:

```
php artisan vendor:publish --provider="Santosdave\VerteilWrapper\VerteilServiceProvider"
```

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

```
VERTEIL_USERNAME=your_username
VERTEIL_PASSWORD=your_password
VERTEIL_BASE_URL=https://api.stage.verteil.com
VERTEIL_TIMEOUT=30
VERTEIL_VERIFY_SSL=true
VERTEIL_THIRD_PARTY_ID=your_third_party_id
VERTEIL_OFFICE_ID=your_office_id
```

Basic Usage
-----------

[](#basic-usage)

### Initialization

[](#initialization)

```
use Santosdave\VerteilWrapper\Facades\Verteil;
// or
use Santosdave\VerteilWrapper\Services\VerteilService;
```

### Authentication

[](#authentication)

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

```
$verteil = Verteil::authenticate();
```

### Air Shopping Example

[](#air-shopping-example)

```
use Santosdave\VerteilWrapper\DataTypes\AirShopping;

$request = AirShopping::create([
    'coreQuery' => [
        'originDestinations' => [
            [
                'departureAirport' => 'LHR',
                'arrivalAirport' => 'JFK',
                'departureDate' => '2024-12-03',
                'key' => 'OD1'
            ]
        ]
    ],
    'travelers' => [
        [
            'passengerType' => 'ADT',
            'objectKey' => 'T1',
            'name' => [
                'given' => ['John'],
                'surname' => 'Doe',
                'title' => 'Mr'
            ]
        ]
    ],
    'preference' => [
        'cabin' => 'Y',
        'fareTypes' => ['PUBL']
    ],
    'responseParameters' => [
        'ResultsLimit' => [
            'value' => 50
        ],
        'SortOrder' => [
            [
                'Order' => 'ASCENDING',
                'Parameter' => 'PRICE'
            ],
            [
                'Order' => 'ASCENDING',
                'Parameter' => 'STOP'
            ],
            [
                'Order' => 'ASCENDING',
                'Parameter' => 'DEPARTURE_TIME'
            ]
        ],
        'ShopResultPreference' => 'OPTIMIZED'
    ],
    'enableGDS' => true
]);

$response = Verteil::airShopping($request);
```

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

[](#flight-price-example)

```
use Santosdave\VerteilWrapper\DataTypes\FlightPrice;
use Santosdave\VerteilWrapper\DataTypes\VerteilRequestBuilder as Builder;

// Create flight details using named parameters

$request = FlightPrice::create([
    'third_party_id' => 'EK',
            'dataLists' => [
                'fares' => [
                    [
                        'listKey' => 'someOtherValue',
                        'code' => 'someOtherValue',  // Economy fare basis code
                        'fareCode' => '70J',
                        'refs' => ['someOtherValue']
                    ],
                ],
                'anonymousTravelers' => [
                    [
                        'objectKey' => 'EK-T1',
                        'passengerType' => 'ADT'
                    ],
                    [
                        'objectKey' => 'EK-T2',
                        'passengerType' => 'ADT'
                    ],
                    [
                        'objectKey' => 'EK-T3',
                        'passengerType' => 'CHD',
                        'age' => [
                            'value' => 8,
                            'birthDate' => '2016-06-15'
                        ]
                    ]
                ]
            ],
            'query' => [
                'originDestinations' => [
                    [
                        'flights' => [
                            [
                                'segmentKey' => 'someOtherValue',
                                'departure' => [
                                    'airportCode' => 'NBO',
                                    'date' => '2024-12-27',
                                    'time' => '22:45',
                                    'terminal' => '1B'
                                ],
                                'arrival' => [
                                    'airportCode' => 'DXB',
                                    'date' => '2024-12-28',
                                    'time' => '04:45',
                                    'terminal' => '3'
                                ],
                                'airlineCode' => 'EK',
                                'flightNumber' => '722',
                                'classOfService' => 'Q',
                                'classOfServiceRefs' => ['someOtherValue']
                            ],
                        ]
                    ]
                ],
                'offers' => [
                    [
                        'owner' => 'EK',
                        'offerId' => 'someOtherValue',
                        'offerItems' => [
                            [
                                'id' => 'someOtherValue',
                                'quantity' => '2',
                                'refs' => ['EK-T1', 'EK-T2'],  // Reference to first adult
                            ],
                            [
                                'id' => 'someOtherValue',
                                'quantity' => '1',
                                'refs' => ['EK-T3'],  // Reference to child
                            ]
                        ],
                        'refs' => [
                            'VDC-AIRLINE-SRID',
                            'someOtherValue'
                        ]
                    ]
                ]
            ],
            'travelers' => [
                [
                    'passengerType' => 'ADT',
                    'objectKey' => 'EK-T1'
                ],
                [
                    'passengerType' => 'ADT',
                    'objectKey' => 'EK-T2'
                ],
                [
                    'passengerType' => 'CHD',
                    'objectKey' => 'EK-T3'
                ]
            ],
            'shoppingResponseId' => [
                'owner' => 'EK',
                'responseId' => 'someOtherValue'  // Response ID from AirShopping response
            ],
            'metadata' => [
                [
                    'priceMetadata' => [
                        [
                            'key' => 'someOtherValue',
                            'type' => 'com.verteil.pricemanager.data.PriceRuleAugPoint',
                            'value' => 'someOtherValue'
                        ],
                        [
                            'key' => 'someOtherValue',
                            'value' => 'someOtherValue'
                        ],
                        [
                            'key' => 'VDC-AIRLINE-SRID',
                            'javaType' => 'java.util.HashMap',
                            'value' => 'someOtherValue'
                        ]
                    ]
                ]
            ]
]);

$response = Verteil::flightPrice($request);
```

### Order Creation Example

[](#order-creation-example)

```
use Santosdave\VerteilWrapper\DataTypes\OrderCreate;
use Santosdave\VerteilWrapper\DataTypes\VerteilRequestBuilder as Builder;

// Create passenger details using named parameters
$name = Builder::createNameType([
    'given' => 'John',
    'surname' => 'Doe',
    'title' => 'Mr'
]);

$contacts = Builder::createContactType([
    'phoneNumber' => '1234567890',
    'phoneCountryCode' => '44',
    'email' => 'john.doe@example.com',
    'street' => '123 Main St',
    'city' => 'London',
    'postalCode' => '12345',
    'countryCode' => 'GB'
]);

$document = Builder::createPassengerDocumentType([
    'documentNumber' => 'AB123456',
    'issuingCountry' => 'GB',
    'type' => 'PT',
    'expiryDate' => '2030-01-01'
]);

$payment = Builder::createPaymentCardType([
    'cardNumber' => '4111111111111111',
    'cvv' => '123',
    'expiryDate' => '1225',
    'holderName' => 'John Doe',
    'brand' => 'VI'
]);

$request = OrderCreate::create([
    'query' => [
        'owner' => 'BA',
        'responseId' => 'SHOP123',
        'passengers' => [
            [
                'objectKey' => 'T1',
                'gender' => 'Male',
                'passengerType' => 'ADT',
                'name' => $name,
                'contacts' => $contacts,
                'document' => $document
            ]
        ]
    ],
    'payments' => [$payment]
]);

$response = Verteil::createOrder($request);

# Order Creation with Enhanced Metadata

When creating orders with complex metadata requirements, you can use the enhanced metadata structure:

```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";
}
```

Metadata Types
--------------

[](#metadata-types)

### Price Metadata

[](#price-metadata)

Used for price-related information and rules:

```
'price' => [
    [
        'key' => 'VDC-AIRLINE-SRID',
        'augmentationPoints' => [
            [
                'javaType' => 'java.util.HashMap',
                'value' => ['key' => 'value'],
                'key' => 'someKey'
            ]
        ],
        'offerItemRefs' => ['OI1'],
        'description' => 'Description'
    ]
]
```

### Payment Form Metadata

[](#payment-form-metadata)

Defines payment form characteristics:

```
'paymentForm' => [
    [
        'key' => 'PAYMENT_FORM1',
        'text' => 'Credit Card Payment',
        'description' => 'Description',
        'warningText' => 'Warning message',
        'restrictionText' => 'Restrictions'
    ]
]
```

### Currency Metadata

[](#currency-metadata)

Specifies currency handling rules:

```
'currency' => [
    [
        'key' => 'INR',
        'decimals' => 2,
        'roundingPrecision' => 0.01,
        'exchangeRate' => [
            'rate' => 1.0,
            'baseCurrency' => 'INR',
            'targetCurrency' => 'EUR'
        ],
        'displayFormat' => '#,##0.00',
        'allowedPaymentCurrencies' => ['INR', 'EUR']
    ]
]
```

Payment Card Security
---------------------

[](#payment-card-security)

The package automatically adds required security nodes:

```
'card' => [
    // ... your card details ...
    // Automatically added:
    'SecurePaymentVersion' => [
        'PaymentTrxChannelCode' => 'MO'
    ]
]
```

### Order Retrieval and Cancellation

[](#order-retrieval-and-cancellation)

```
use Santosdave\VerteilWrapper\DataTypes\OrderRetrieve;
use Santosdave\VerteilWrapper\DataTypes\OrderCancel;

// Retrieve order
$retrieveRequest = OrderRetrieve::create([
    'owner' => 'BA',
    'orderId' => 'ABC123',
    'channel' => 'NDC'
]);

$order = Verteil::retrieveOrder($retrieveRequest);

// Cancel order
$cancelRequest = OrderCancel::create([
    'orders' => [
        [
            'owner' => 'BA',
            'orderId' => 'ABC123',
            'channel' => 'NDC'
        ]
    ],
    'expectedRefundAmount' => [
        'amount' => 1200.00,
        'currency' => 'INR'
    ]
]);

$response = Verteil::cancelOrder($cancelRequest);
```

### Seat Availability and Service List

[](#seat-availability-and-service-list)

```
use Santosdave\VerteilWrapper\DataTypes\SeatAvailability;
use Santosdave\VerteilWrapper\DataTypes\ServiceList;

// Create flight details for service list
$flight = Builder::createFlightType([
    'departureAirport' => 'LHR',
    'arrivalAirport' => 'JFK',
    'departureDate' => '2024-12-01',
    'departureTime' => '09:00',
    'airlineCode' => 'BA',
    'flightNumber' => '123'
]);

// Check seat availability
$seatRequest = SeatAvailability::create('pre', [
    'query' => [
        'originDestinations' => [
            [
                'segmentRefs' => ['SEG1', 'SEG2']
            ]
        ],
        'offers' => [
            [
                'owner' => 'BA',
                'offerId' => 'OFF123',
                'offerItems' => ['ITEM1']
            ]
        ]
    ],
    'travelers' => [
        [
            'objectKey' => 'T1',
            'passengerType' => 'ADT'
        ]
    ]
]);

$seats = Verteil::getSeatAvailability($seatRequest);

// Get service list
$serviceRequest = ServiceList::create('pre', [
    'query' => [
        'originDestinations' => [
            [
                'flights' => [$flight]
            ]
        ]
    ],
    'travelers' => [
        [
            'passengerType' => 'ADT'
        ]
    ]
]);

$services = Verteil::getServiceList($serviceRequest);
```

### Order Change Example

[](#order-change-example)

```
use Santosdave\VerteilWrapper\DataTypes\OrderChange;

$payment = Builder::createPaymentCardType([
    'cardNumber' => '4111111111111111',
    'cvv' => '123',
    'expiryDate' => '1225',
    'holderName' => 'John Doe',
    'brand' => 'VI'
]);

// Create order change request
$orderChangeParams = [
    'orderId' => [
        'owner' => 'BA',
        'orderId' => 'ABC123'
    ],
    'changes' => [
        [
            'type' => 'FLIGHT_CHANGE',
            'segments' => [
                [
                    'origin' => 'LHR',
                    'destination' => 'JFK',
                    'departureDate' => '2024-12-01',
                    'departureTime' => '09:00',
                    'airlineCode' => 'BA',
                    'flightNumber' => '123'
                ]
            ]
        ]
    ],
    'payments' => [
        [
            'amount' => 100.00,
            'currency' => 'INR',
            'card' => [
                'number' => '4111111111111111',
                'securityCode' => '123',
                'holderName' => 'John Doe',
                'expiryDate' => '1225'
            ]
        ]
    ]
];

// Change order
$response = Verteil::changeOrder($orderChangeParams);
```

Helper Classes
--------------

[](#helper-classes)

The package includes a `VerteilRequestBuilder` class with helper methods to create common data structures:

```
use Santosdave\VerteilWrapper\DataTypes\VerteilRequestBuilder as Builder;

// Create passenger name
$name = Builder::createNameType([
    'given' => 'John',
    'surname' => 'Doe',
    'title' => 'Mr'
]);

// Create contact information
$contacts = Builder::createContactType([
    'phoneNumber' => '1234567890',
    'phoneCountryCode' => '44',
    'email' => 'john.doe@example.com',
    'street' => '123 Main St',
    'city' => 'London',
    'postalCode' => '12345',
    'countryCode' => 'GB'
]);

// Create passport/document information
$document = Builder::createPassengerDocumentType([
    'documentNumber' => 'AB123456',
    'issuingCountry' => 'GB',
    'type' => 'PT',
    'expiryDate' => '2030-01-01'
]);

// Create payment card details
$payment = Builder::createPaymentCardType([
    'cardNumber' => '4111111111111111',
    'cvv' => '123',
    'expiryDate' => '1225',
    'holderName' => 'John Doe',
    'brand' => 'VI'
]);;

// Create flight details
$flight = Builder::createFlightType([
    'departureAirport' => 'LHR',
    'arrivalAirport' => 'JFK',
    'departureDate' => '2024-12-01',
    'departureTime' => '09:00',
    'airlineCode' => 'BA',
    'flightNumber' => '123',
    'arrivalDate' => '2024-12-01',
    'arrivalTime' => '12:00',
    'classOfService' => 'Y'
]);

// Create price information
$price = Builder::createPriceType([
    'baseAmount' => 1000.00,
    'taxAmount' => 200.00,
    'currency' => 'INR'
]);
```

### Order Reshop Example

[](#order-reshop-example)

```
use Santosdave\VerteilWrapper\DataTypes\OrderReshop;

$reshopParams = [
    'owner' => 'BA',
    'orderId' => 'ABC123',
    'qualifiers' => [
        [
            'type' => 'CABIN',
            'cabin' => 'Y',
            'preferenceLevel' => 'Preferred'
        ],
        [
            'type' => 'FARE',
            'fareTypes' => ['PUBL', 'CORP'],
            'fareBasis' => 'Y1N2C3'
        ]
    ],
    'segments' => [
        [
            'segmentKey' => 'SEG1',
            'newFlight' => [
                'origin' => 'LHR',
                'destination' => 'JFK',
                'departureDate' => '2024-12-01',
                'departureTime' => '09:00',
                'airlineCode' => 'BA',
                'flightNumber' => '123'
            ]
        ]
    ],
    'searchAlternateDates' => true
];

$response = Verteil::reshopOrder($reshopParams);
```

### Itinerary Reshop Example

[](#itinerary-reshop-example)

```
use Santosdave\VerteilWrapper\DataTypes\ItinReshop;

// Create itinerary reshop request
$itinReshopParams = [
    'orderId' => [
        'owner' => 'BA',
        'value' => 'ABC123'
    ],
    'itineraryChanges' => [
        [
            'type' => 'SEGMENT_CHANGE',
            'oldSegment' => [
                'origin' => 'LHR',
                'destination' => 'JFK',
                'departure' => [
                    'date' => '2024-12-01',
                    'time' => '09:00'
                ],
                'airline' => 'BA',
                'flightNumber' => '123'
            ],
            'newSegment' => [
                'origin' => 'LHR',
                'destination' => 'JFK',
                'departure' => [
                    'date' => '2024-12-02',
                    'time' => '11:00'
                ],
                'airline' => 'BA',
                'flightNumber' => '175'
            ]
        ]
    ],
    'pricingQualifiers' => [
        [
            'type' => 'CABIN',
            'code' => 'Y'
        ]
    ],
    'party' => [
        'type' => 'CORPORATE',
        'code' => 'CORP123',
        'name' => 'Example Corp'
    ]
];

// Reshop itinerary
$response = Verteil::reshopItinerary($itinReshopParams);
```

### Order Change Notification Example

[](#order-change-notification-example)

```
use Santosdave\VerteilWrapper\DataTypes\OrderChangeNotif;

// Create order change notification
$notificationData = OrderChangeNotif::create([
    'orderId' => [
        'owner' => 'BA',
        'value' => 'ABC123'
    ],
    'notification' => [
        'type' => 'SCHEDULE_CHANGE',
        'reason' => 'OPERATIONAL',
        'severity' => 'WARNING',
        'description' => 'Flight schedule has been modified due to operational constraints',
        'affectedSegments' => [
            [
                'segmentRef' => 'SEG1',
                'changeType' => 'TIME_CHANGE',
                'description' => 'Departure time changed',
                'oldValue' => '09:00',
                'newValue' => '11:00',
                'impacts' => [
                    'duration' => [
                        'change' => 120,
                        'unit' => 'MIN'
                    ]
                ]
            ]
        ],
        'customerNotification' => [
            'required' => true,
            'method' => 'EMAIL',
            'template' => 'SCHEDULE_CHANGE_NOTIFICATION'
        ]
    ],
    'serviceImpact' => [
        [
            'serviceId' => 'SVC1',
            'serviceType' => 'MEAL',
            'status' => 'MODIFIED',
            'description' => 'Meal service adjusted due to new flight time',
            'compensation' => [
                'type' => 'VOUCHER',
                'amount' => 15.00,
                'currency' => 'INR'
            ]
        ]
    ],
    'alternatives' => [
        [
            'type' => 'RESCHEDULE',
            'description' => 'Alternative flight options',
            'validity' => [
                'start' => '2024-12-01',
                'end' => '2024-12-03'
            ],
            'segments' => [
                [
                    'origin' => 'LHR',
                    'destination' => 'JFK',
                    'airline' => 'BA',
                    'flightNumber' => '175',
                    'departure' => [
                        'date' => '2024-12-01',
                        'time' => '14:00'
                    ],
                    'arrival' => [
                        'date' => '2024-12-01',
                        'time' => '17:00'
                    ]
                ]
            ],
            'pricing' => [
                'difference' => 0,
                'currency' => 'INR'
            ]
        ]
    ]
]);

$response = Verteil::sendOrderChangeNotification($notificationData);
```

Error Handling
--------------

[](#error-handling)

The package includes a custom exception class for handling Verteil API errors:

```
use Santosdave\VerteilWrapper\Exceptions\VerteilApiException;

try {
    $response = Verteil::airShopping($request);
} catch (VerteilApiException $e) {
    // Handle API-specific errors
    $errorMessage = $e->getErrorMessage();
    $errorResponse = $e->getErrorResponse();

    // Log the error or notify administrators
    Log::error('Verteil API Error', [
        'message' => $errorMessage,
        'response' => $errorResponse
    ]);
} catch (\Exception $e) {
    // Handle other errors
}
```

### Caching

[](#caching)

The package includes built-in caching for appropriate endpoints:

```
// Check cache
$response = Verteil::getCache()->get('airShopping', $params);

// Clear cache for specific endpoint
Verteil::flushCache('airShopping');

// Clear all cache
Verteil::flushCache();
```

### Rate Limiting

[](#rate-limiting)

Rate limiting is handled automatically, but you can configure limits in the config file:

```
// config/verteil.php
'rate_limits' => [
    'default' => [
        'requests' => 60,
        'duration' => 60 // seconds
    ],
    'airShopping' => [
        'requests' => 30,
        'duration' => 60
    ]
]
```

### Health Monitoring

[](#health-monitoring)

The package includes a health monitoring system:

This will display metrics including:

- API uptime
- Response times
- Error rates
- Cache hit rates
- Rate limit status
- Token status

```
php artisan verteil:health
```

### Security Features

[](#security-features)

The package includes several security features:

- Automatic input sanitization
- Secure token storage with encryption
- Request validation
- XSS protection
- SQL injection protection

### Logging

[](#logging)

All API interactions are automatically logged. You can customize the logging channel in the config:

```
// config/verteil.php
'logging' => [
    'channel' => 'verteil',
    'level' => 'debug'
]
```

### Console Commands

[](#console-commands)

Available artisan commands:

```
php artisan verteil:health
php artisan verteil:cache:flush
php artisan verteil:cache:flush airShopping
```

### Events

[](#events)

The package dispatches several events that you can listen for:

- ApiRequestEvent
- ApiResponseEvent
- ApiErrorEvent
- TokenRefreshEvent

Testing
-------

[](#testing)

Run the test suite:

```
composer test
```

### Advanced Configuration

[](#advanced-configuration)

The package provides extensive configuration options:

```
// config/verteil.php
return [
    'credentials' => [
        'username' => env('VERTEIL_USERNAME'),
        'password' => env('VERTEIL_PASSWORD'),
    ],
    'base_url' => env('VERTEIL_BASE_URL'),
    'timeout' => env('VERTEIL_TIMEOUT', 30),
    'verify_ssl' => env('VERTEIL_VERIFY_SSL', true),
    'retry' => [
        'max_attempts' => 3,
        'delay' => 100, // milliseconds
        'multiplier' => 2
    ],
    'cache' => [
        'enabled' => true,
        'ttl' => [
            'airShopping' => 5, // minutes
            'flightPrice' => 2,
            'serviceList' => 5
        ]
    ],
    'monitoring' => [
        'enabled' => true,
        'metrics_retention' => 24 // hours
    ],
    'notifications' => [
        'slack_webhook_url' => env('VERTEIL_SLACK_WEBHOOK'),
        'notification_email' => env('VERTEIL_NOTIFICATION_EMAIL')
    ]
];
```

Contributing
------------

[](#contributing)

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

Security
--------

[](#security)

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

Credits
-------

[](#credits)

santosdave

License
-------

[](#license)

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

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance48

Moderate activity, may be stable

Popularity8

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~6 days

Recently: every ~16 days

Total

23

Last Release

382d ago

Major Versions

v1.2.2 → v2.0.02024-12-13

v2.0.8 → v3.0.02025-03-28

### Community

Maintainers

![](https://www.gravatar.com/avatar/c58a87513095fe0454c5dd566a2a18cf274ec91c3d4de92fb0854f863d84da9e?d=identicon)[santodave86](/maintainers/santodave86)

---

Top Contributors

[![santosdave](https://avatars.githubusercontent.com/u/51959957?v=4)](https://github.com/santosdave "santosdave (29 commits)")

---

Tags

apitravelsantosdaveverteil-wrapperverteilndc

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/santosdave-verteil-wrapper/health.svg)

```
[![Health](https://phpackages.com/badges/santosdave-verteil-wrapper/health.svg)](https://phpackages.com/packages/santosdave-verteil-wrapper)
```

###  Alternatives

[checkout/checkout-sdk-php

Checkout.com SDK for PHP

553.3M7](/packages/checkout-checkout-sdk-php)[smodav/mpesa

M-Pesa API implementation

16363.7k1](/packages/smodav-mpesa)[convertkit/convertkitapi

Kit PHP SDK for the Kit API

2167.1k1](/packages/convertkit-convertkitapi)[ardakilic/mutlucell

Mutlucell SMS API wrapper for sending sms text messages for Laravel

457.3k](/packages/ardakilic-mutlucell)[dariusiii/tmdb-laravel

Laravel Package for TMDB ( The Movie Database ) API. Provides easy access to the wtfzdotnet/php-tmdb-api library.

1821.1k](/packages/dariusiii-tmdb-laravel)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)