PHPackages                             tripklik/blue-ribbon-bags - 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. tripklik/blue-ribbon-bags

ActiveLibrary[API Development](/categories/api)

tripklik/blue-ribbon-bags
=========================

Laravel package for Blue Ribbon Bags API integration, powered by Tripklik

v2.2.1(9mo ago)31.2k[1 PRs](https://github.com/tripklik/blue-ribbon-bags/pulls)PHPPHP ^8.1

Since Jan 29Pushed 9mo agoCompare

[ Source](https://github.com/tripklik/blue-ribbon-bags)[ Packagist](https://packagist.org/packages/tripklik/blue-ribbon-bags)[ RSS](/packages/tripklik-blue-ribbon-bags/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (5)Dependencies (2)Versions (7)Used By (0)

Blue Ribbon Bags Laravel Package
================================

[](#blue-ribbon-bags-laravel-package)

A Laravel package for integrating with the Blue Ribbon Bags API. This package provides a clean and type-safe way to interact with the Blue Ribbon Bags service for baggage tracking and protection services.

[![Tripklik](https://camo.githubusercontent.com/0f786dd9ff0450f7789aeca3de2bead786868fe67f71fd789098fd18059262c5/68747470733a2f2f747269706b6c696b2e636f6d2f77702d636f6e74656e742f75706c6f6164732f323032332f30372f6c6f676f2e737667)](https://camo.githubusercontent.com/0f786dd9ff0450f7789aeca3de2bead786868fe67f71fd789098fd18059262c5/68747470733a2f2f747269706b6c696b2e636f6d2f77702d636f6e74656e742f75706c6f6164732f323032332f30372f6c6f676f2e737667)

Powered by [Tripklik - BY INFOTEK TECHNOLOGY FZCO](https://tripklik.com)

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require tripklik/blue-ribbon-bags
```

Configuration
-------------

[](#configuration)

Publish the configuration file:

```
php artisan vendor:publish --provider="Tripklik\BlueRibbonBags\BlueRibbonBagsServiceProvider"
```

Add your Blue Ribbon Bags credentials to your `.env` file:

```
BLUE_RIBBON_BAGS_BASE_URL=https://validation-api.blueribbonbags.com/api/
BLUE_RIBBON_BAGS_AUTH_TOKEN=your-auth-token
```

Usage
-----

[](#usage)

### Getting Available Products

[](#getting-available-products)

```
use Tripklik\BlueRibbonBags\BlueRibbonBagsClient;

public function getProducts(BlueRibbonBagsClient $client)
{
    $products = $client->getProducts('USD');

    foreach ($products as $product) {
        echo "Product: {$product->productName}\n";
        echo "Price: {$product->productPrice} {$product->currencyCode}\n";
        echo "Coverage: {$product->bagCoverage}\n";
    }
}
```

### Getting Available Currencies

[](#getting-available-currencies)

```
use Tripklik\BlueRibbonBags\BlueRibbonBagsClient;

public function getCurrencies(BlueRibbonBagsClient $client)
{
    $currencies = $client->getCurrencies();

    foreach ($currencies as $currency) {
        echo "Currency: {$currency->currencyName} ({$currency->currencyCode})\n";
    }
}
```

### Purchasing a Service

[](#purchasing-a-service)

```
use Tripklik\BlueRibbonBags\Purchase\Request\PurchaseRequest;
use Tripklik\BlueRibbonBags\Purchase\Request\Passenger;
use Tripklik\BlueRibbonBags\Purchase\Request\PassengersCollection;

public function purchaseService(BlueRibbonBagsClient $client)
{
    $passengers = new PassengersCollection([
        new Passenger(
            orderSequence: 1,
            lastName: 'Smith',
            firstName: 'John',
            email: 'john@example.com',
            airlineCode: 'AA',
            airlineCodeType: 'IATA',
            airlineConfirmationNumber: 'ABC123',
            phone: '',
            sendSMS: true
        ),
        new Passenger(
            orderSequence: 2,
            lastName: 'Smith',
            firstName: 'Jane',
            email: 'jane@example.com',
            airlineCode: 'AA',
            airlineCodeType: 'IATA',
            airlineConfirmationNumber: 'ABC456',
            phone: '',
            sendSMS: true
        )
    ]);

    $request = new PurchaseRequest(
        productCode: 'GOLD',
        isInternational: true,
        promoCode: '',
        userLogin: '',
        userPassword: '',
        customerReferenceNumber: '',
        replaceServiceNumberWithCRN: false,
        flightDetails: 'Flight details here',
        departureDt: new DateTime('2024-02-01 10:00:00'),
        lastArrivalDt: new DateTime('2024-02-02 15:00:00'),
        currencyCode: 'USD',
        agentEmailSend: 'agent@example.com',
        passengerList: $passengers
    );

    $response = $client->purchaseService($request);

    echo "Service Number: {$response->serviceNumber}\n";
    echo "Total Price: {$response->totalPrice}\n";
    echo "Status: {$response->statusCode}\n";
}
```

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

[](#error-handling)

The package provides detailed error information in the response objects. Always check the `status` and `errors` properties of the response:

```
$response = $client->purchaseService($request);

if (!$response->status) {
    foreach ($response->errors as $error) {
        // Handle errors
        echo "Error: {$error}\n";
    }
}
```

Available Methods
-----------------

[](#available-methods)

### BlueRibbonBagsClient

[](#blueribbonbagsclient)

- `getProducts(string $currencyCode)`: Get available products for a specific currency
- `getCurrencies()`: Get list of available currencies
- `purchaseService(PurchaseRequest $request)`: Purchase a baggage protection service

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

[](#contributing)

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

License
-------

[](#license)

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

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance58

Moderate activity, may be stable

Popularity23

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity51

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 ~48 days

Total

5

Last Release

274d ago

Major Versions

V1.0.0 → v2.0.02025-02-02

### Community

Maintainers

![](https://www.gravatar.com/avatar/30c073afdcb47b23791b3e831523d9c4cae8756a29bf4b03208da9ac2ccc123b?d=identicon)[yehiaAbdullah](/maintainers/yehiaAbdullah)

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

---

Top Contributors

[![yahiaAbdullah](https://avatars.githubusercontent.com/u/32086501?v=4)](https://github.com/yahiaAbdullah "yahiaAbdullah (6 commits)")

### Embed Badge

![Health badge](/badges/tripklik-blue-ribbon-bags/health.svg)

```
[![Health](https://phpackages.com/badges/tripklik-blue-ribbon-bags/health.svg)](https://phpackages.com/packages/tripklik-blue-ribbon-bags)
```

###  Alternatives

[skagarwal/google-places-api

Google Places Api

1913.0M8](/packages/skagarwal-google-places-api)[dcblogdev/laravel-microsoft-graph

A Laravel Microsoft Graph API (Office365) package

168285.5k1](/packages/dcblogdev-laravel-microsoft-graph)[vluzrmos/slack-api

Wrapper for Slack.com WEB API.

102589.1k3](/packages/vluzrmos-slack-api)[smodav/mpesa

M-Pesa API implementation

16363.7k1](/packages/smodav-mpesa)[jasara/php-amzn-selling-partner-api

A fluent interface for Amazon's Selling Partner API in PHP

1344.8k1](/packages/jasara-php-amzn-selling-partner-api)[grantholle/powerschool-api

A Laravel package to make interacting with PowerSchool less painful.

1715.6k1](/packages/grantholle-powerschool-api)

PHPackages © 2026

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