PHPackages                             regna/urbaniqo-sdk - 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. regna/urbaniqo-sdk

ActiveLibrary[API Development](/categories/api)

regna/urbaniqo-sdk
==================

Official PHP SDK for the Urbaniqo Transit protocol — sell your tickets, passes and subscriptions through the Urbaniqo app.

v1.0.1(2mo ago)00MITPHPPHP ^8.2

Since May 4Pushed 2mo agoCompare

[ Source](https://github.com/regnatech/urbaniqo-sdk-php)[ Packagist](https://packagist.org/packages/regna/urbaniqo-sdk)[ Docs](https://github.com/regnatech/urbaniqo-sdk-php)[ RSS](/packages/regna-urbaniqo-sdk/feed)WikiDiscussions main Synced 3w ago

READMEChangelogDependencies (6)Versions (3)Used By (0)

Urbaniqo Transit SDK · PHP
==========================

[](#urbaniqo-transit-sdk--php)

Official PHP client for **Urbaniqo Transit** — the channel that lets your customers buy your tickets, passes and subscriptions through the Urbaniqo app.

> Looking for the JavaScript / Node SDK? It lives in a separate repository: [`regnatech/urbaniqo-sdk-js`](https://github.com/regnatech/urbaniqo-sdk-js).

PackageManagerStatus`regna/urbaniqo-sdk`Composer · PHP ≥ 8.2v1Wire-level spec for both SDKs: [`docs/protocol.md`](./docs/protocol.md).

Install
-------

[](#install)

```
composer require regna/urbaniqo-sdk guzzlehttp/guzzle
```

`guzzlehttp/guzzle` is the recommended PSR-18 implementation. Bring your own if you already have a different one.

Quick start
-----------

[](#quick-start)

```
use GuzzleHttp\Client as Guzzle;
use GuzzleHttp\Psr7\HttpFactory;
use Regna\UrbaniqoSdk\Client;

$factory = new HttpFactory();
$urbaniqo = new Client(
    agencyId:       $_ENV['URBANIQO_AGENCY_ID'],
    keyId:          $_ENV['URBANIQO_KEY_ID'],
    secret:         $_ENV['URBANIQO_SECRET'],
    httpClient:     new Guzzle(),
    requestFactory: $factory,
    streamFactory:  $factory,
    // baseUrl defaults to https://urbaniqo.com/api/transit/v1
);

$urbaniqo->upsertTariffs([
    [
        'id' => 'AMT-110',
        'name' => ['en' => 'Single ride 110\'', 'it' => 'Corsa singola 110 minuti'],
        'kind' => 'single_ride',
        'fare_cents' => 200,
        'currency' => 'EUR',
        'default_validity_seconds' => 110 * 60,
        'is_active' => true,
    ],
]);
```

What the SDK gives you
----------------------

[](#what-the-sdk-gives-you)

- HMAC-SHA256 request signing (Authorization header in canonical-request form)
- Idempotent retries with exponential backoff for safe verbs (PUT, GET, idempotent POSTs)
- `Webhooks\Verifier` for inbound webhook signature checking — pass the **raw** request body
- Typed exceptions: `UrbaniqoApiException`, `UrbaniqoTransportException`, `UrbaniqoWebhookException`

Webhook handler (Laravel example)
---------------------------------

[](#webhook-handler-laravel-example)

A complete drop-in lives at [`examples/php-laravel-webhook/routes-snippet.php`](./examples/php-laravel-webhook/routes-snippet.php).

Docs
----

[](#docs)

- [`docs/protocol.md`](./docs/protocol.md) — wire-level spec
- [`docs/getting-started.md`](./docs/getting-started.md) — onboarding walkthrough
- [`docs/webhooks.md`](./docs/webhooks.md) — webhook events + payload shapes
- [`docs/error-codes.md`](./docs/error-codes.md) — full error code reference
- [`docs/barcode-formats.md`](./docs/barcode-formats.md) — supported ticket formats
- [`docs/changelog.md`](./docs/changelog.md)

License
-------

[](#license)

MIT — see [`LICENSE`](./LICENSE).

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance84

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity47

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

Total

2

Last Release

81d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/20618268?v=4)[regna](/maintainers/regna)[@regna](https://github.com/regna)

---

Top Contributors

[![foxyed](https://avatars.githubusercontent.com/u/265133781?v=4)](https://github.com/foxyed "foxyed (1 commits)")

---

Tags

sdktransporttransitticketingurbaniqo

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/regna-urbaniqo-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/regna-urbaniqo-sdk/health.svg)](https://phpackages.com/packages/regna-urbaniqo-sdk)
```

###  Alternatives

[tempest/framework

The PHP framework that gets out of your way.

2.2k34.4k16](/packages/tempest-framework)[telnyx/telnyx-php

Official Telnyx PHP SDK — APIs for Voice, SMS, MMS, WhatsApp, Fax, SIP Trunking, Wireless IoT, Call Control, and more. Build global communications on Telnyx's private carrier-grade network.

36789.4k2](/packages/telnyx-telnyx-php)[flow-php/flow

PHP ETL - Extract Transform Load - Data processing framework

85036.3k](/packages/flow-php-flow)[mollie/mollie-api-php

Mollie API client library for PHP. Mollie is a European Payment Service provider and offers international payment methods such as Mastercard, VISA, American Express and PayPal, and local payment methods such as iDEAL, Bancontact, SOFORT Banking, SEPA direct debit, Belfius Direct Net, KBC Payment Button and various gift cards such as Podiumcadeaukaart and fashioncheque.

60316.0M89](/packages/mollie-mollie-api-php)[getbrevo/brevo-php

Official Brevo provided RESTFul API V3 php library

1003.9M50](/packages/getbrevo-brevo-php)[bushlanov-dev/max-bot-api-client-php

Max Bot API Client library

486.3k](/packages/bushlanov-dev-max-bot-api-client-php)

PHPackages © 2026

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