PHPackages                             sovic/pays-cz-php-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. [Payment Processing](/categories/payments)
4. /
5. sovic/pays-cz-php-sdk

ActiveLibrary[Payment Processing](/categories/payments)

sovic/pays-cz-php-sdk
=====================

PHP SDK for Pays.cz payment gateway

v1.0.0(4y ago)08MITPHPPHP >=7.4

Since Feb 16Pushed 4y ago1 watchersCompare

[ Source](https://github.com/sovic/pays-cz-php-sdk)[ Packagist](https://packagist.org/packages/sovic/pays-cz-php-sdk)[ RSS](/packages/sovic-pays-cz-php-sdk/feed)WikiDiscussions main Synced 4w ago

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

PHP SDK for Pays.cz payment gateway
===================================

[](#php-sdk-for-payscz-payment-gateway)

![packagist](https://camo.githubusercontent.com/53f7ec3dded5c7e61497b1cb583aa66884ad90a57dc0d5f7c7d542d5fb40c37e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f736f7669632f706179732d637a2d7068702d73646b3f7374796c653d666c61742d737175617265266d61784167653d32353932303030) ![license](https://camo.githubusercontent.com/5fab57ede073a0f098e56525ba8d8fe71f7b4f201a0c469c36775df24664fa18/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f736f7669632f706179732d637a2d7068702d73646b3f7374796c653d666c61742d737175617265)

Requirements
------------

[](#requirements)

- PHP >= 7.4

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

[](#installation)

Using [Composer](https://getcomposer.org/doc/00-intro.md)

```
composer require sovic/pays-cz-php-sdk
```

Usage
-----

[](#usage)

Init

```
$pays = new Pays('{merchant-id}', '{shop-id}', '{secret}');
```

Create payment

```
$paysPayment = $pays->createPayment('{shop-payment-id}', '{price}', '{currency}');
$paysPayment->setEmail('{customer-email}'); // optionally add customer email for Pays.cz notifications

// get Pays.cz gateway url (E.g. for payment button)
$url = $pays->buildPaymentUrl($paysPayment, '{return-url}');

// redirect to Pays.cz gateway directly
$pays->redirectToPaymentUrl($paysPayment, '{return-url}');
```

Validate Pays.cz status request

```
$query = [ … ]; // query params array from HTTP request

try {
    $paysPayment = $pays->validatePaymentRequestQuery($query);
    if ($paysPayment->isPaid()) {
        // handle successful payment
        $clientPaymentId = $paysPayment->getClientPaymentId();
    } else {
        // handle failed|cancelled payment
    }
} catch(Exception $e) {
    // invalid request, some parameter missing or invalid signature hash, output 400 Bad Request
}

// all OK, output 202 Accepted
```

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity49

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

Unknown

Total

1

Last Release

1543d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/266229236caa1b298d9560793c5da740fcfe5b6eb69e23d497ca241ce52e04c3?d=identicon)[sovic](/maintainers/sovic)

---

Top Contributors

[![sovic](https://avatars.githubusercontent.com/u/2230633?v=4)](https://github.com/sovic "sovic (32 commits)")

---

Tags

payment-gatewaypays-czphpphpsdkpaymentsgatewaypays.cz

### Embed Badge

![Health badge](/badges/sovic-pays-cz-php-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/sovic-pays-cz-php-sdk/health.svg)](https://phpackages.com/packages/sovic-pays-cz-php-sdk)
```

PHPackages © 2026

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