PHPackages                             tpay-com/tpay-php - 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. tpay-com/tpay-php

ActiveLibrary[Payment Processing](/categories/payments)

tpay-com/tpay-php
=================

Tpay.com library

2.4.9(1mo ago)25280.6k↓55.3%27[1 PRs](https://github.com/tpay-com/tpay-php/pulls)7MITPHPPHP >=5.6.0CI passing

Since Mar 7Pushed 1mo ago8 watchersCompare

[ Source](https://github.com/tpay-com/tpay-php)[ Packagist](https://packagist.org/packages/tpay-com/tpay-php)[ RSS](/packages/tpay-com-tpay-php/feed)WikiDiscussions master Synced yesterday

READMEChangelog (10)Dependencies (8)Versions (36)Used By (7)

Tpay
====

[](#tpay)

Library for all payment methods available in [Tpay](https://docs.tpay.com/).

[![Latest stable version](https://camo.githubusercontent.com/cde26cc8c914c1009966ec1c32fbb00c7274986f98b9db316a40a37049b3ac3e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f747061792d636f6d2f747061792d7068702e7376673f6c6162656c3d63757272656e7425323076657273696f6e)](https://packagist.org/packages/tpay-com/tpay-php)[![PHP version](https://camo.githubusercontent.com/391b5cfa7d8a7826adfcb745ed834b1a2a56ee6383b16e552972d898da0abaa8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f747061792d636f6d2f747061792d7068702e737667)](https://php.net)[![License](https://camo.githubusercontent.com/5f325c5420ddbe56e1388ccfaa0f42cb7dc9194c089260f98328a497d0cee8a3/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f747061792d636f6d2f747061792d7068702e737667)](LICENSE)[![CI status](https://github.com/tpay-com/tpay-php/actions/workflows/ci.yaml/badge.svg?branch=master)](https://github.com/tpay-com/tpay-php/actions)[![Type coverage](https://camo.githubusercontent.com/7b941f1c40d30fff0f8999911b7803133c662438ab436c2348021d4525bebb9a/68747470733a2f2f73686570686572642e6465762f6769746875622f747061792d636f6d2f747061792d7068702f636f7665726167652e737667)](https://shepherd.dev/github/tpay-com/tpay-php)

[Polish version 🇵🇱 wersja polska](./README_PL.md)

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

[](#installation)

Install via [Composer](https://getcomposer.org):

```
composer require tpay-com/tpay-php
```

Install via [Git](https://git-scm.com) over SSH:

```
git clone git@github.com:tpay-com/tpay-php.git
```

Install via [Git](https://git-scm.com) over HTTPS:

```
git clone https://github.com/tpay-com/tpay-php.git
```

Manual download:

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

[](#configuration)

The only thing you need to do is to set your API access data via `$this->` ([see examples](examples)). You can generate access keys in [Tpay's merchant panel](https://secure.tpay.com/panel).

The [`loader.php`](examples/BasicPaymentForm.php) file handles all required class loading, so you can include this file to any file you are editing. (remember to configure your current working path correctly).

All methods described in [Tpay documentation](https://docs.tpay.com) can be easily executed by extending required class in main [`src`](src) directory ([see examples](examples)).

##### Basic Payments and bank selection forms

[](#basic-payments-and-bank-selection-forms)

Example of usages: [basic](examples/BasicPaymentForm.php), [bank selection HTML form](examples/BankSelection.php), [bank selection API form](examples/BankSelectionAPI.php), [BLIK form](examples/BlikTransactionExample.php).

##### Transaction API / create, get, refund, report

[](#transaction-api--create-get-refund-report)

Example of usages: [create transaction](examples/TransactionApiExample.php), [refund transaction](examples/TransactionRefund.php), [refund transaction status](examples/TransactionRefundStatus.php).

##### Card Basic / Card On-Site

[](#card-basic--card-on-site)

Example of usages: [card basic form](examples/CardBasic.php), [card on-site gateway](examples/CardGate.php), [card payment links builder](examples/CardPaymentLinkBuilder.php), [card on-site gateway with saved cards](examples/CardGateExtended.php).

Logs
----

[](#logs)

Library has own logging system to save all confirmations and notifications sent by Tpay.com server, outgoing requests and exceptions. Be sure that file `src/Logs` directory is writable and add rule to Apache `.htaccess` or NGINX to deny access to this area from browser. The log files are created for each day separately under `Logs` directory.

The logging is enabled by default, but you can disable this feature with:

```
Logger::disableLogging();
```

You can also set your own logging path by this command:

```
Logger::setLogPath('/my/own/path/Logs/');
```

You can also set you own Logger by this command it has to be compatible with `Psr\Log\LoggerInterface`:

```
Logger::setLogger(new CustomLogger());
```

The logs file names will be assigned automatically.

Custom templates path
---------------------

[](#custom-templates-path)

You can set your own templates path, so you can copy and modify the `phtml` template files from this library.

```
Util::$customTemplateDirectory = '/my/own/templates/path/';
```

Language
--------

[](#language)

Currently, the library supports two languages (English and Polish). Default language is English. Changing language example:

```
// All Tpay class constructors load Lang class
$tpay = new BankSelectionExample();

// After this line all static messages (input labels, buttons titles etc.) will be displayed in Polish
(new Util())->setLanguage('pl');

// If you want to access translations manually, use:
$language = new Lang();
$language->setLang('pl'); // for setting language
$language->l('pay'); // to echo translated key
```

License
-------

[](#license)

This library is released under the [MIT License](http://www.opensource.org/licenses/MIT), but uses third party libraries that are distributed under their own terms ([see `LICENSE-3RD-PARTY.md`](LICENSE-3RD-PARTY.md)).

###  Health Score

64

—

FairBetter than 99% of packages

Maintenance94

Actively maintained with recent releases

Popularity48

Moderate usage in the ecosystem

Community35

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 79.7% 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 ~102 days

Recently: every ~196 days

Total

34

Last Release

31d ago

Major Versions

1.0.5 → 2.0.02017-06-27

PHP version history (3 changes)1.0.0PHP >=5.6.0

1.0.2PHP >=5.4.0

1.0.5PHP >=5.3.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/9dcff1f4946f5f9513219ae1de2da28b89f32aec2f6dc5034a1a1f6da05bcef4?d=identicon)[piotrjozwiak](/maintainers/piotrjozwiak)

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

---

Top Contributors

[![piotrjozwiak](https://avatars.githubusercontent.com/u/22236446?v=4)](https://github.com/piotrjozwiak "piotrjozwiak (173 commits)")[![kubawerlos](https://avatars.githubusercontent.com/u/9282069?v=4)](https://github.com/kubawerlos "kubawerlos (18 commits)")[![s4ddly](https://avatars.githubusercontent.com/u/110701663?v=4)](https://github.com/s4ddly "s4ddly (8 commits)")[![SzczepaniakG](https://avatars.githubusercontent.com/u/52274854?v=4)](https://github.com/SzczepaniakG "SzczepaniakG (4 commits)")[![krzGablo](https://avatars.githubusercontent.com/u/147171777?v=4)](https://github.com/krzGablo "krzGablo (3 commits)")[![BanczerowskiM](https://avatars.githubusercontent.com/u/90452844?v=4)](https://github.com/BanczerowskiM "BanczerowskiM (2 commits)")[![kwojc](https://avatars.githubusercontent.com/u/5415799?v=4)](https://github.com/kwojc "kwojc (2 commits)")[![Karpol](https://avatars.githubusercontent.com/u/16548691?v=4)](https://github.com/Karpol "Karpol (1 commits)")[![thomas2411](https://avatars.githubusercontent.com/u/992685?v=4)](https://github.com/thomas2411 "thomas2411 (1 commits)")[![erizodelbosque](https://avatars.githubusercontent.com/u/125289729?v=4)](https://github.com/erizodelbosque "erizodelbosque (1 commits)")[![pstasicki](https://avatars.githubusercontent.com/u/125288731?v=4)](https://github.com/pstasicki "pstasicki (1 commits)")[![eazypl](https://avatars.githubusercontent.com/u/19469878?v=4)](https://github.com/eazypl "eazypl (1 commits)")[![Digital87](https://avatars.githubusercontent.com/u/3045250?v=4)](https://github.com/Digital87 "Digital87 (1 commits)")[![kdoroszewicz](https://avatars.githubusercontent.com/u/7294362?v=4)](https://github.com/kdoroszewicz "kdoroszewicz (1 commits)")

---

Tags

payment-gatewaypayment-integration

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/tpay-com-tpay-php/health.svg)

```
[![Health](https://phpackages.com/badges/tpay-com-tpay-php/health.svg)](https://phpackages.com/packages/tpay-com-tpay-php)
```

###  Alternatives

[symfony/cache

Provides extended PSR-6, PSR-16 (and tags) implementations

4.2k373.5M3.3k](/packages/symfony-cache)[matomo/matomo

Matomo is the leading Free/Libre open analytics platform

21.7k38.9k](/packages/matomo-matomo)[shopware/platform

The Shopware e-commerce core

3.4k1.5M3](/packages/shopware-platform)[civicrm/civicrm-core

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

751291.4k42](/packages/civicrm-civicrm-core)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.6M572](/packages/shopware-core)[magento/community-edition

Magento 2 (Open Source)

12.2k53.6k13](/packages/magento-community-edition)

PHPackages © 2026

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