PHPackages                             stitchua/yii2-paymento - 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. [Payment Processing](/categories/payments)
4. /
5. stitchua/yii2-paymento

ActiveYii2-extension[Payment Processing](/categories/payments)

stitchua/yii2-paymento
======================

Payment system Paymento

v1.0.0(4y ago)00MITPHPPHP &gt;=7.4.0

Since May 16Pushed 3y ago1 watchersCompare

[ Source](https://github.com/StitchUA/yii2-paymento)[ Packagist](https://packagist.org/packages/stitchua/yii2-paymento)[ RSS](/packages/stitchua-yii2-paymento/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)Dependencies (1)Versions (4)Used By (0)

System do opłacania zamówień w `Paymento`
=========================================

[](#system-do-opłacania-zamówień-w-paymento)

System realizowany jako moduł pod nazwą `paymento`, będzie konfigurowany w pliku konfiguracyjnym `config/web.php`sekcja `modules`. Moduł realizuje tylko jeden sposób płatności: [Bramkę płatności](https://paymentopaywall.docs.apiary.io/#/introduction/wprowadzenie)

Instalacja
----------

[](#instalacja)

Zalecany sposób instalacji przez [composer](http://getcomposer.org/download/)

Możesz uruchomić

```
php composer.phar require --prefer-dist ststichua/yii2-paymento

```

lub dodać

```
"stitchua/yii2-paymento":"*"

```

do sekcji `require` twojego composer.json

Po instalacji pakietu należy uruchomić migrację (w konsoli):

```
php yii migrate --migrationPath="@stitchua/paymento/migrations"

```

Konfiguracja
------------

[](#konfiguracja)

Do konfigurowania modułu służą:

- `merchantId` - ID konta w systemie płatnościowym Paymento
- `payloadModelClass` - Klasa opłacanego zamówienia np. 'app/models/Invoice'. Dana klasa ma realizowywać dwa interface-y:
    - \[stitchua\\paymento\\base\\PaymentoPayloadRequestDataInterface\]
    - \[stitchua\\paymento\\base\\PaymentoResponseDataInterface\]
- `shops` - sklepy z systemu płatnościowego Paymento. Sklepów może być kilka. Każdy sklep jest skonfigurowany za pomocą trzech parametrów:
    - `nazwaSklepu` - klucz, dowolna unikalna nazwa pośród innych sklepów, można je dodać do stałych w klasie realizującej ww. interfasy.
    - `serviceId` - identyfikator sklepu nadany w systemie Paymento;
    - `serviceKey` - prywatny klucz nadany w systemie Paymento, jest wykorzystywany do obliczenia `sygnatury` (hash kodu) przekazywanych danych do systemu Paymeno.

Klasa odzwierciedlająca dane przekazywane do Paymento \[\[stitchua/paymento/models/Paywall\]\]

### Wyliczenie sygnatury notyfikacji z Paymento

[](#wyliczenie-sygnatury-notyfikacji-z-paymento)

> Sygnatura w notyfikacji z Paymento wylicza się ze wszystkich pól **'transaction'** przekazanej w notyfikacji i ma być porównywana z sygnaturą przekazaną w nagłówku `x-paymento-signature`

### Jak korzystyać

[](#jak-korzystyać)

1. W klasie która odpowiada w twoim systemie za zamówienie implementuj dwa interface-y:

- \[stitchua\\paymento\\base\\PaymentoPayloadRequestDataInterface\]
- \[stitchua\\paymento\\base\\PaymentoResponseDataInterface\]

2. Skonfigurować jak opisno w sekcji [konfiguracja](#konfigurujemy)
3. Dodać przycisk do płatności

#### Realizujemy interface-y

[](#realizujemy-interface-y)

```
// Istniejąca klasa/model Invoice
namespace app\models;

use stitchua\paymento\models\PaymentoTransaction;
use yii\db\ActiveRecord;
use stitchua\paymento\base\{
    PaymentoPayloadRequestDataInterface,
    PaymentoResponseDataInterface
};

class Invoice extends ActiveRecord implements PaymentoPayloadRequestDataInterface, PaymentoResponseDataInterface
{

    public function getCustomerFirstName() : string{
     // TODO: Implement getCustomerFirstName() method.
     return $this->account->first_name;
    }
    public function getCustomerLastName() : string{
     // TODO: Implement getCustomerLastName() method.
     return $this->account->last_name;
    }
    public function getCustomerEmail() : string{
     // TODO: Implement getCustomerEmail() method.
     return $this->account->email;
    }
    public function getAmount() : int{
     // TODO: Implement getAmount() method.
     return $this->amount * 100; // Zwracamy w groszach
    }
    public function getId() : int{
     // TODO: Implement getId() method.
     return $this->id;
    }
    public function getTitle() : string{
     // TODO: Implement getTitle() method.
     return $this->invoicenumber;
    }
    public function paymentoOrderInvoiced(PaymentoTransaction $transaction){
         // TODO: Implement paymentoOrderInvoiced() method.
         if($transaction->canBeSettled()){
            $this->settle();
         }
    }
}
```

#### Konfigurujemy

[](#konfigurujemy)

W pliku konfiguracyjnym config/web.php (dla basic template) dodajesz:

```
[
    'modules' => [
        'paymento' => [
            'class' => 'stitchua\paymento\Paymento',
            'merchantId' => 'jahds-we4fde-erge-fgsf', // ID twojego konta w Paymento
            'payloadModelClass' => 'app\models\Invoice', // Klasa realizująca interface-y
            'successReturnUrl' => 'https://mysite.com/site/payment-landig-page?status=success',
            'failureReturnUrl' => 'https://mysite.com/site/payment-landig-page?status=error',
            'shops' => [
                // Nazwa sklepu, dowolno ustawiona przez ciebie
                'myShop1' => [
                    'serviceId' => 'id-sklepu-nadany-przez-paymento', // ID sklepu z Paymento
                    'serviceKey' => 'tayny-klusz-twojego-sklepu' // klucz sklepu z Paymento
                ]
            ]
        ]
    ]
]
```

##### Dane do konfiguracji

[](#dane-do-konfiguracji)

Dane do konfiguracji pobierz ze swojego konta w Paymento [![Dane do konfiguracji](img/dane_paymento.jpg)](img/dane_paymento.jpg)

> WAŻNE!!! Nie zapomnij podać URL do wiadomości zwrotnych od Paymento. Bo w takim razie nie będą księgowane twoje zamówienia u Ciebie w systemie.

#### Tworzymy przycisk w widoku

[](#tworzymy-przycisk-w-widoku)

W widoku faktury `app\views\invoice\view.php` wyświetlamy przycisk do opłacenia faktury jeśli faktura jeszcze nie jest opłacona

```
use stitchua\paymento\models\Paywall;

$invoice = Invoice::findOne(10);
if(!$invoice->isSettled){
 echo \yii\helpers\Html::a('Opłać fakturę',  [
        '/stitchua/paymento/pay-for-order',
        'id' => $invoice->fld_id,
        'shopName' => 'myShop1',
        'payMethod' => Paywall::METHOD_PBL],
        [
            'class' => 'btn btn-success',
            'target' => '_blank'
        ]
    );
}
```

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity0

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity54

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

Total

2

Last Release

1816d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/826c3130f9dea7b0b5b0ab1874efa3829308cfc1ca0d6bdc12e4d5a3d45212a3?d=identicon)[StitchUA](/maintainers/StitchUA)

---

Top Contributors

[![StitchUA](https://avatars.githubusercontent.com/u/3766841?v=4)](https://github.com/StitchUA "StitchUA (25 commits)")

---

Tags

yii2paymento

### Embed Badge

![Health badge](/badges/stitchua-yii2-paymento/health.svg)

```
[![Health](https://phpackages.com/badges/stitchua-yii2-paymento/health.svg)](https://phpackages.com/packages/stitchua-yii2-paymento)
```

###  Alternatives

[yii2mod/yii2-cashier

Yii2 Cashier provides an interface to Stripe's subscription billing services.

467.3k](/packages/yii2mod-yii2-cashier)

PHPackages © 2026

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