PHPackages                             hopsey/blue-media-connector - 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. hopsey/blue-media-connector

ActiveLibrary[API Development](/categories/api)

hopsey/blue-media-connector
===========================

BlueMedia API PHP wrapper

0.9(9y ago)01.2kPHPPHP ^5.6 || ^7.0

Since Jan 2Pushed 9y ago1 watchersCompare

[ Source](https://github.com/hopsey/BlueMediaConnector)[ Packagist](https://packagist.org/packages/hopsey/blue-media-connector)[ RSS](/packages/hopsey-blue-media-connector/feed)WikiDiscussions master Synced yesterday

READMEChangelog (10)Dependencies (7)Versions (12)Used By (0)

BlueMediaConnector
==================

[](#bluemediaconnector)

Prosty interfejs do obsługi API BlueMedia

Bilbioteka obsługuje

- rozpoczynanie transakcji POST
- interpretacja komunikatów ITN.

Jeśli zbierze się więcej osób zainteresowanych użyciem tej biblioteki, może stworzę jakąś dokumentację, testy jednostkowe, obsługę innych funkcji API. Na razie wystarcza na podstawowe potrzeby :)

Biblioteka oparta jest o bebechy zendframework (v3)

\###I. Instalacja

```
composer require hopsey/blue-media-connector

```

\###II. API ####1. Inicjowanie transakcji

```
use BlueMediaConnector\Transaction\RedirectMode;

$bmService = BlueMediaConnector\Factory::build("http://url.bm.pl/url", 123456, "verySecretString");
$bmService->makeTransaction(
    new RedirectMode(), // typ wywolania: RedirectMode - przekierowanie, jest jeszcze wywołanie w tle, niezaimplemenotwane
    1.50,       // float - kwota
    "Wplata",   // opis
    1,          // gatewayId
    "PLN",      // currency
    "example@email.com"   // customer email
);
```

Wywołanie generuje zdarzenie `preTransaction`, pod które można się podpinać. Do obsługi zdarzeń wykorzystywany jest moduł `zendframework/zend-eventmanager`.

Przykład podpięcia się pod zdarzenie:

```
use BlueMediaConnector\Event\PreTransactionEvent;

$bmService->getEventManager()->attach(PreTransactionEvent::EVENT_PRE_TRANSACTION, function (PreTransactionEvent $event) {
    /** @var BlueMediaConnector\Message\InitTransactionMessage */
    $message = $event->getParam('message');
    $message->amount; // 1.50
    $message->currency; // PLN

    // ... do stuff here. np zapis do bazy, etc.
});
```

Ewentualnie można podpiąć się obiektem implementującym `Zend\EventManager\ListenerAggregateInterface`

\####2. ITN - Instant Transaction Notification

Obsługa zmiany statusu odbywa się w podłączonych do zdarzeń listenerach. Najpierw deifniujemy listener, następnie poprzez wywołanie metody `BmService::receiveItnResult($xmlContent)` odpalamy event. Metoda sparsuje i przygotuje odpowiedź, sprawdza także czy zgadza się nadesłany hash. Jeśli nie, wyrzucany jest wyjątek `BlueMediaConnector\Message\InvalidHashException`. Na samym końcu uruchamiany jest event.

```
use BlueMediaConnector\Event\MessageReceivedEvent;

$transactionContent = base64_decode($_GET['transactions']);

$bmService->getEventManager()->attach(MessageReceivedEvent::EVENT_MESSAGE_RECEIVED, function (MessageReceivedEvent $event) {
    /** @var BlueMediaConnector\Message\ItnMessage */
    $message = $event->getParam('message');
    $messageArray = $message->toArray();
    $messageArray['transactions'][0]['status'] // pending, success, failure ...
    // ...
});

$bmService->receiveItnResult($transactionContent);
```

\####3. Dodatkowa konfiguracja

1. Algorytm hashowania

Domyślnie SHA256. Można zaimplementować własny, poprzez dodanie klasy implementującej `BlueMediaConnector\ValueObject\Hash\Algo\AlgoInterface`.

```
// PHP7
$bmService->getHashFactory()->setAlgo(new class implements AlgoInterface {
    public function hash($string)
    {
        return md5($string);
    }
});
```

2. Message transport

Domyślnie XML. Można zaimplementować dowolny format.

```
// PHP7
use BlueMediaConnector\Transport\TransportInterface;

$bmService->setTransport(new class implements TransportInterface {
    public function parse($content)
    {
        return json_decode($content);
    }
})
```

Copyright: Tomasz Chmielewski <tom(malpa)hop.ventures>

###  Health Score

26

—

LowBetter than 41% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community4

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

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

Total

11

Last Release

3400d ago

### Community

Maintainers

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

---

Tags

blue media

### Embed Badge

![Health badge](/badges/hopsey-blue-media-connector/health.svg)

```
[![Health](https://phpackages.com/badges/hopsey-blue-media-connector/health.svg)](https://phpackages.com/packages/hopsey-blue-media-connector)
```

###  Alternatives

[audeio/spotify-web-api

PHP library for the Spotify Web API

671.1k](/packages/audeio-spotify-web-api)[evandotpro/edp-github

Github API integration module for Zend Framework 2

242.2k](/packages/evandotpro-edp-github)

PHPackages © 2026

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