PHPackages                             samdevxuz/algorix-pay - 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. samdevxuz/algorix-pay

ActiveLibrary[Payment Processing](/categories/payments)

samdevxuz/algorix-pay
=====================

Userbot-based P2P payment receiver for Laravel — listen to bank notification bots (Click, Payme, Uzum) via MTProto and emit PaymentReceived events.

v0.2.0(1mo ago)00[2 issues](https://github.com/SamDevXuz/algorix-pay/issues)MITPHPPHP ^8.2CI failing

Since Apr 30Pushed 3w agoCompare

[ Source](https://github.com/SamDevXuz/algorix-pay)[ Packagist](https://packagist.org/packages/samdevxuz/algorix-pay)[ RSS](/packages/samdevxuz-algorix-pay/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (2)Dependencies (7)Versions (3)Used By (0)

Algorix Pay
===========

[](#algorix-pay)

[![tests](https://github.com/SamDevXuz/algorix-pay/actions/workflows/tests.yml/badge.svg)](https://github.com/SamDevXuz/algorix-pay/actions/workflows/tests.yml)[![Latest Version on Packagist](https://camo.githubusercontent.com/0ff84f755971ac61bb29f3c8f14f668ed5f743a2aa64496618b07f55618fc8b6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f73616d64657678757a2f616c676f7269782d7061792e737667)](https://packagist.org/packages/samdevxuz/algorix-pay)[![PHP Version](https://camo.githubusercontent.com/11713069e9380a6f55655f546fb89a0021d13141f8f5c6edb1f2246b5a7bb79b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f73616d64657678757a2f616c676f7269782d7061792e737667)](https://packagist.org/packages/samdevxuz/algorix-pay)[![License: MIT](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](LICENSE)

Userbot-based P2P payment receiver for Laravel. Listens to Uzbek bank notification bots (Click, Payme, Uzum) on Telegram via MTProto, parses incoming-transfer messages, and emits a Laravel `PaymentReceived` event your app can react to.

> Bank API yo'q? Provider integratsiyasi qimmat? Algorix Pay sizning hisobingizga kelayotgan bank botlari xabarlarini o'qiydi va to'lovni Laravel event sifatida yetkazadi.

---

What it does
------------

[](#what-it-does)

1. Logs into Telegram as a **userbot** (your account, via `MadelineProto` MTProto session).
2. Watches messages from configured bank bots (e.g. `@clickuz`, `@payme`, `@uzumbank_bot`).
3. Parses the message text with the matching `Driver` (regex + heuristics).
4. Dispatches `AlgorixPay\Events\PaymentReceived` with the parsed amount, currency, transaction ID, sender/receiver cards, and timestamp.

Why MTProto (userbot) and not Bot API
-------------------------------------

[](#why-mtproto-userbot-and-not-bot-api)

Telegram's Bot API doesn't see messages between two regular users (or between a user and another bot). Bank notification "bots" send messages to the **account holder's chat** — a normal bot listener can't read them. A userbot session can.

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

[](#requirements)

- PHP **8.2+** (tested on 8.2 / 8.3 / 8.4)
- Laravel **11.x or 12.x**
- A Telegram account (for the userbot session)
- `api_id` / `api_hash` from

Install
-------

[](#install)

```
composer require samdevxuz/algorix-pay
php artisan vendor:publish --tag=algorix-pay-config
```

Configure
---------

[](#configure)

`.env`:

```
ALGORIX_API_ID=1234567
ALGORIX_API_HASH=abcdef0123456789abcdef0123456789

ALGORIX_CLICK_ENABLED=true
ALGORIX_CLICK_SOURCE=clickuz

ALGORIX_PAYME_ENABLED=true
ALGORIX_PAYME_SOURCE=payme

ALGORIX_UZUM_ENABLED=true
ALGORIX_UZUM_SOURCE=uzumbank_bot

ALGORIX_DEDUP_TTL=600
ALGORIX_DEDUP_CACHE=redis
```

EnvDefaultDescription`ALGORIX_API_ID`—Telegram `api_id` (required)`ALGORIX_API_HASH`—Telegram `api_hash` (required)`ALGORIX_SESSION_PATH``storage/app/algorix-pay/userbot.madeline`Persisted MTProto session path`ALGORIX__ENABLED``false` (Click: `true`)Enable a driver`ALGORIX__SOURCE``clickuz` / `payme` / `uzumbank_bot`Bot's Telegram username (lower-case, no `@`)`ALGORIX_DEDUP_TTL``10`Seconds to remember a `messageId` / `transactionId` for dedup. Bump to `600`+ in production.`ALGORIX_DEDUP_CACHE`default cache storeCache store name (e.g. `redis`) used for dedup`ALGORIX_LOG_CHANNEL``stack`Log channel for parser/listener eventsFirst-run login
---------------

[](#first-run-login)

The first time you run `php artisan pay:listen`, MadelineProto will prompt for phone number + login code in the terminal. The session is then persisted at `storage/app/algorix-pay/userbot.madeline` and reused on subsequent runs.

Listen for payments
-------------------

[](#listen-for-payments)

```
use AlgorixPay\Events\PaymentReceived;
use Illuminate\Support\Facades\Event;

Event::listen(function (PaymentReceived $event): void {
    $payment = $event->payment;

    $payment->amountTiyin;     // int — 1 so'm = 100 tiyin
    $payment->currency;        // 'UZS' | 'RUB' | 'USD' | 'EUR'
    $payment->transactionId;   // ?string — bot-provided receipt/transaction id
    $payment->senderMasked;    // ?string — '8600****1234' (when present)
    $payment->receiverMasked;  // ?string — '9860****5678' (your card, when present)
    $payment->receivedAt;      // ?string — ISO 8601 UTC, from Telegram message.date
    $payment->rawText;         // string  — original bot message

    $event->bankMessageId;     // 'clickuz:12345' — UNIQUE per bot message
    $event->bankSource;        // 'clickuz'
});
```

Order matching (v0.3+)
----------------------

[](#order-matching-v03)

P2P to'lovlarda eng katta muammo — qaysi to'lov qaysi order'niki ekanligini topish. Bir vaqtda 10 ta mijoz `50 000 so'm` jo'natsa, bank xabari shuni aytadi: "50 000 so'm tushdi". Qaysi biri?

Yechim: paket har bir kutilayotgan to'lov uchun **unikal tail** qo'shadi. Mijoz `50 000.37 so'm` to'laydi (37 — bizning marker), pul kelganda paket avtomatik aniqlaydi va `PaymentMatched` event chiqaradi.

### Setup

[](#setup)

Facade alias'ni `bootstrap/providers.php` yoki `config/app.php`'ga qo'shing (Laravel 11+ aliaslarni avtomatik ulamaydi):

```
// config/app.php
'aliases' => [
    'AlgorixPay' => \AlgorixPay\Facades\AlgorixPay::class,
],
```

### Expect a payment

[](#expect-a-payment)

```
use AlgorixPay\Facades\AlgorixPay;

$pending = AlgorixPay::expect(50_000)         // so'mda
    ->currency('UZS')
    ->forOrder($order)                         // Eloquent model, string ID, yoki array
    ->expiresInMinutes(15)
    ->create();

$pending->amountTiyin;   // 5_000_037 — to'liq summa (tiyin)
$pending->humanAmount;   // "50 000.37 so'm" — checkout sahifasida ko'rsating
$pending->expiresAt;     // ISO-8601 UTC
$pending->reference;     // log korrelyatsiya uchun
```

Checkout sahifasi mijozga **aynan `50 000.37 so'm`** ni jo'natishni so'raydi. Bu summa cache'da 15 daqiqaga rezerv qilingan.

### React to a match

[](#react-to-a-match)

```
use AlgorixPay\Events\PaymentMatched;
use Illuminate\Support\Facades\Event;

Event::listen(function (PaymentMatched $event): void {
    $order = $event->pending->resolvePayable();    // Eloquent model qaytadi
    $order?->markPaid($event->payment->transactionId);

    // $event->pending  → PendingPayment (sizning expectation)
    // $event->payment  → ParsedPayment (bank xabaridan)
    // $event->bankMessageId, $event->bankSource
});
```

### Tail mode

[](#tail-mode)

ModeRangeSlotsTrade-off`tiyin` (default)`50 000.01 – 50 000.99`99 ta sum-per-vaqtmijoz sezmaydi`sum``50 001 – 50 999 so'm`999 tako'proq slot, mijoz ortiqcha so'mni ko'radi`ALGORIX_MATCHER_TAIL_MODE=tiyin|sum` orqali tanlanadi.

### Matcher config

[](#matcher-config)

EnvDefaultDescription`ALGORIX_MATCHER_ENABLED``true`Listener'ni o'chirish/yoqish`ALGORIX_MATCHER_CACHE`defaultCache store (e.g. `redis`)`ALGORIX_MATCHER_TTL``900`Default expiration (sekund)`ALGORIX_MATCHER_TAIL_MODE``tiyin``tiyin` yoki `sum``ALGORIX_MATCHER_MAX_ATTEMPTS``50`Tail collision retry limit`ALGORIX_MATCHER_CURRENCY_MISMATCH``log``drop` | `log` | `match_anyway`### Custom tail generator

[](#custom-tail-generator)

`config/algorix-pay.php`'da `matcher.tail_generators` map'iga o'z class'ingizni qo'shing (interface: `\AlgorixPay\Contracts\TailGenerator`).

---

Run the listener
----------------

[](#run-the-listener)

```
php artisan pay:listen
```

In production: run as a supervisor / systemd service — the loop blocks.

Example **supervisord** snippet:

```
[program:algorix-pay]
command=php /var/www/app/artisan pay:listen
autorestart=true
user=www-data
stderr_logfile=/var/log/algorix-pay.err.log
stdout_logfile=/var/log/algorix-pay.out.log
```

Idempotency & dedup
-----------------------

[](#idempotency--dedup)

Every parsed payment carries:

- `bank_message_id` of `":"` — unique per bot message, safe as a `UNIQUE` column on your payments table.
- An additional **transaction-id-based dedup layer** (per source) catches bot reposts that arrive with a new `messageId` but the same `transactionId`.

Both layers use the configured cache store and respect `ALGORIX_DEDUP_TTL`.

Money
-----

[](#money)

All amounts are in **tiyin** — `1 so'm = 100 tiyin`. Format only at display time:

```
number_format($payment->amountTiyin / 100, 0, '.', ' ').' so\'m';
```

Architecture
------------

[](#architecture)

```
src/
├── Console/
│   └── ListenPaymentsCommand.php       # php artisan pay:listen
├── Contracts/
│   ├── PaymentDriver.php
│   └── TailGenerator.php
├── Drivers/
│   ├── AbstractRegexDriver.php         # normalize + amount + currency + cards
│   ├── ClickDriver.php
│   ├── PaymeDriver.php
│   └── UzumDriver.php
├── Events/
│   ├── PaymentReceived.php             # bank message → parsed
│   ├── PaymentExpected.php             # merchant created an expectation
│   └── PaymentMatched.php              # received ↔ expected matched
├── Facades/
│   └── AlgorixPay.php                  # AlgorixPay::expect(...)
├── Listeners/
│   └── MatchPendingPayment.php         # auto-matcher on PaymentReceived
├── Matcher/
│   ├── AlgorixPayManager.php           # facade accessor (fresh builder per call)
│   ├── PaymentExpectation.php          # fluent builder
│   ├── Exceptions/
│   │   └── TailExhaustedException.php
│   └── Tail/
│       ├── TiyinTailGenerator.php      # +1..99 tiyin
│       └── SumTailGenerator.php        # +1..999 so'm
├── Services/
│   └── MadelineService.php             # MTProto event loop + dedup + dispatch
├── Support/
│   ├── ParsedPayment.php
│   └── PendingPayment.php              # merchant-side DTO
└── AlgorixPayServiceProvider.php

```

Writing your own driver
-----------------------

[](#writing-your-own-driver)

Extend `AbstractRegexDriver` (recommended) and override the three pattern hooks:

```
namespace App\Algorix;

use AlgorixPay\Drivers\AbstractRegexDriver;

final class AnorDriver extends AbstractRegexDriver
{
    public function __construct(string $source = 'anorbank_bot')
    {
        parent::__construct($source);
    }

    protected function incomingMarkers(): array
    {
        return ['hisobingizga', 'tushdi', 'зачислен'];
    }

    protected function amountPatterns(): array
    {
        return [
            '/([0-9][0-9 .,]*)\s*(?:so\'?m|sum|сум|UZS)\b/iu',
        ];
    }

    protected function transactionPatterns(): array
    {
        return [
            '/(?:tranzaksiya|транзакция)\s*[:#№]\s*([A-Za-z0-9][A-Za-z0-9\-]{4,})/iu',
        ];
    }
}
```

Then register it in `config/algorix-pay.php`:

```
'drivers' => [
    'anor' => [
        'enabled' => true,
        'source' => 'anorbank_bot',
        'class' => \App\Algorix\AnorDriver::class,
    ],
],
```

For a custom parser that doesn't fit the regex template, implement `AlgorixPay\Contracts\PaymentDriver` directly.

Tests
-----

[](#tests)

```
composer install
./vendor/bin/phpunit
```

The suite covers:

- **Unit** — per-driver regex behavior across Uzbek/Russian, NBSP, comma/dot decimals, emoji, multiline.
- **Feature** — service provider wiring (Orchestra Testbench), `MadelineService` event dispatch, dedup, and edge cases (null peer, non-message updates, empty text).
- **Real-world** — emoji-rich multiline bot fixtures with arrow-notation card pairs.

Security
--------

[](#security)

This package handles a **userbot session** — treat the session file (`storage/app/algorix-pay/userbot.madeline`) as a credential. Don't commit it; restrict file permissions; rotate the Telegram session if leaked.

`ParsedPayment->rawText` contains the original bank message — log responsibly.

License
-------

[](#license)

MIT.

###  Health Score

35

—

LowBetter than 77% of packages

Maintenance93

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity37

Early-stage or recently created project

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

Total

2

Last Release

39d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/049e553bcfac361d79cf7321cd0c49420889bf2c2c48a8c6ed6039eb4008f9ac?d=identicon)[SamDevXuz](/maintainers/SamDevXuz)

---

Top Contributors

[![SamDevXuz](https://avatars.githubusercontent.com/u/245555067?v=4)](https://github.com/SamDevXuz "SamDevXuz (5 commits)")

---

Tags

clicklaravelmtprotoopen-sourcep2ppaymepaymenttelegramuserbotuzbekistanuzumlaravelpaymentp2pmtprotoclickУзбекистанuserbotpaymeuzum

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/samdevxuz-algorix-pay/health.svg)

```
[![Health](https://phpackages.com/badges/samdevxuz-algorix-pay/health.svg)](https://phpackages.com/packages/samdevxuz-algorix-pay)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3325.1M337](/packages/psalm-plugin-laravel)[larastan/larastan

Larastan - Discover bugs in your code without running it. A phpstan/phpstan extension for Laravel

6.4k51.0M7.4k](/packages/larastan-larastan)[laravel/ai

The official AI SDK for Laravel.

9782.1M153](/packages/laravel-ai)[laravel/sail

Docker files for running a basic Laravel application.

1.9k199.2M1.2k](/packages/laravel-sail)[laravel/pulse

Laravel Pulse is a real-time application performance monitoring tool and dashboard for your Laravel application.

1.7k14.1M120](/packages/laravel-pulse)[laravel/mcp

Rapidly build MCP servers for your Laravel applications.

76318.2M110](/packages/laravel-mcp)

PHPackages © 2026

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