PHPackages                             igormakarov/checkbox.paylink.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. igormakarov/checkbox.paylink.php.sdk

ActiveLibrary[Payment Processing](/categories/payments)

igormakarov/checkbox.paylink.php.sdk
====================================

Client for work with Checkbox PayLink REST API

v1.0.19(2y ago)05.3k↓15.6%MITPHPPHP >=8.0

Since Aug 28Pushed 2y ago1 watchersCompare

[ Source](https://github.com/MakarovIgor/checkbox.paylink.php.sdk)[ Packagist](https://packagist.org/packages/igormakarov/checkbox.paylink.php.sdk)[ RSS](/packages/igormakarov-checkboxpaylinkphpsdk/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (1)Versions (21)Used By (0)

[![License: MIT](https://camo.githubusercontent.com/fdf2982b9f5d7489dcf44570e714e3a15fce6253e0cc6b5aa61a075aac2ff71b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f772e737667)](https://opensource.org/licenses/MIT)

checkbox.paylink.php.sdk - проста бібліотека для роботи з POS терміналами через Paylink REST API
================================================================================================

[](#checkboxpaylinkphpsdk---проста-бібліотека-для-роботи-з-pos-терміналами-через-paylink-rest-api)

Бібліотека для роботи з POS терміналами через Paylink REST API як в локальній мережі, так і через інтеграції з web-CRM або інших.

#### Увага:

[](#увага)

Для роботи глобального доступу із мережі інтернет, треба білий IP та на роутері вивести порт, який зазначений у вкалдці "POS server"(за замовчуванням 9020) для зовнішнього доступу, для IP ПК на якому встановленний PayLink.

#### Підключення бібліотеки до проекту:

[](#підключення-бібліотеки-до-проекту)

```
composer require igormakarov/checkbox.paylink.php.sdk - https://packagist.org/packages/igormakarov/checkbox.paylink.php.sdk

```

```
require_once 'vendor/autoload.php';
```

#### Ініціалізація і робота з клієнтом:

[](#ініціалізація-і-робота-з-клієнтом)

Ініціалізація

```
use igormakarov\PayLink\HostConfig;
use igormakarov\PayLink\PayLinkClient;

$client = new PayLinkClient(
    new HostConfig("", 9020)
);

HostConfig(string $ipOrHost, int $port): $ipOrHost - може бути як у вигляді IP так і доменого імені(DynDNS), наприклад "192.168.1.102" або 'testlink.ddns.net'
```

#### Отримання списку всіх терміналів які зареєстровані в программі PayLink

[](#отримання-списку-всіх-терміналів-які-зареєстровані-в-программі-paylink)

```
$сlient->getDevices();

public function getDevices(): array
```

#### Отримання даних терміналу p PayLink по його ІД

[](#отримання-даних-терміналу-p-paylink-по-його-ід)

```
$сlient->getDevice('your-device-uu-id');

public function getDevice($deviceId): Device
```

> $deviceId - ІД терміналу

#### Підключення до терміналу/перевірка з'єднання

[](#підключення-до-терміналуперевірка-зєднання)

```
$сlient->ping('your-device-uu-id');

public function ping(string $deviceId): bool
```

> $deviceId - ІД терміналу

#### Відправка грошей на оплату картою в термінал, перед цим з'єднує PayLink з терміналом якщо підключення не було

[](#відправка-грошей-на-оплату-картою-в-термінал-перед-цим-зєднує-paylink-з-терміналом-якщо-підключення-не-було)

```
$сlient->purchase("your-device-uu-id", 1);

public function purchase(string $deviceId, int $amount): PurchaseResult
```

> $deviceId - ІД терміналу, $amount - кількість грошей(1 = одна копійка, 100 = одна гривня)

### Простий приклад

[](#простий-приклад)

```
use igormakarov\PayLink\HostConfig;
use igormakarov\PayLink\PayLinkClient;

$client = new PayLinkClient(
    new HostConfig("", 9020)
);

$purchaseResult = $client->purchase("1ad4ec2c-3aa3-44a0-812c-bd285ef253f0", 1);
```

а далі підставляєте дані $purchaseResult в чек у вашому коді чи бібліотеці якій використовуєте.

Приклад підстановки даних для віправки в чекбокс за допомогою бібліотеки [checkbox-in-ua-php-sdk](https://github.com/igorbunov/checkbox-in-ua-php-sdk):

```
$receipt = new SellReceipt(
    'Вася Пупкін',
    'Відділ продажів',
    new Goods(
        [
            new GoodItemModel(new GoodModel('vm-123', 100, 'Биовак'), 1000)
        ]
    ),
    new Payments([
        new CardPaymentPayload(
            $sum = 100,
            'Оплата картою',
            $purchaseResult->code(),
            $purchaseResult->cardMask(),
            $purchaseResult->cardName(),
            $purchaseResult->terminal(),
            $purchaseResult->rrn(),
            $purchaseResult->authCode(),
            $purchaseResult->paymentSystem(),
            $purchaseResult->receiptNo(),
            $purchaseResult->acquirerAndSeller(),
            $purchaseResult->commission()
        )
    ])
);
$api->createSellReceipt($receipt);
```

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity23

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity57

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

Recently: every ~34 days

Total

20

Last Release

755d ago

PHP version history (2 changes)v1.0.0PHP >=7.4.3 || ^8.1.2

v1.0.4PHP >=8.0

### Community

Maintainers

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

---

Top Contributors

[![MakarovIgor](https://avatars.githubusercontent.com/u/28019844?v=4)](https://github.com/MakarovIgor "MakarovIgor (26 commits)")

### Embed Badge

![Health badge](/badges/igormakarov-checkboxpaylinkphpsdk/health.svg)

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

###  Alternatives

[chargebee/chargebee-php

ChargeBee API client implementation for PHP

768.0M9](/packages/chargebee-chargebee-php)[imdhemy/google-play-billing

Google Play Billing

491.3M5](/packages/imdhemy-google-play-billing)[bitpay/sdk

Complete version of the PHP library for the new cryptographically secure BitPay API

42337.5k4](/packages/bitpay-sdk)[buckaroo/sdk

Buckaroo payment SDK

12189.1k9](/packages/buckaroo-sdk)[contica/facturador-electronico-cr

Un facturador de código libre para integrar facturación electrónica en Costa Rica a un proyecto PHP

2128.8k](/packages/contica-facturador-electronico-cr)[karson/mpesa-php-sdk

172.2k](/packages/karson-mpesa-php-sdk)

PHPackages © 2026

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