PHPackages serdominus/monobank-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. serdominus/monobank-pay ActiveLibrary[Payment Processing](/categories/payments) serdominus/monobank-pay ======================= This is simple library for Monobank Acquiring called "MonoPay" based on REST API (v2304) docs located at https://api.monobank.ua/docs/acquiring.html 1.0.2(1y ago)010Apache-2.0PHPPHP >=7.4 Since Aug 30Pushed 1y agoCompare [ Source](https://github.com/serdominus/monobank-pay)[ Packagist](https://packagist.org/packages/serdominus/monobank-pay)[ RSS](/packages/serdominus-monobank-pay/feed)WikiDiscussions main Synced today READMEChangelog (3)Dependencies (2)Versions (2)Used By (0) 🇺🇦 Проста бібліотека для еквайрінгу [MonobankPay](https://api.monobank.ua/) (MonoPay) ===================================================================================== [](#-проста-бібліотека-для-еквайрінгу-monobankpay-monopay) > 🔄 Цей проєкт є форком [oneb-pub/monobank-pay](https://github.com/oneb-pub/monobank-pay) > Оригінальна бібліотека ліцензована за Apache 2.0. Документація по REST API [тут](https://api.monobank.ua/docs/acquiring.html) Для ведення запитів вам знадобиться токен з особистого кабінету або тестовий токен з Встановити бібліотеку: ``` composer require serdominus/monobank-pay ``` ### Мінімальні вимоги: [](#мінімальні-вимоги) - php >=7.4 - guzzlehttp/guzzle >= 7.0 - starkbank/ecdsa >= 0.0.5 ### Приклади використання: [](#приклади-використання) ``` require_once 'vendor/autoload.php'; //створили клієнта - через нього запити будуть слатись $monoClient = new \MonoPay\Client('YOUR_TOKEN_HERE'); //із клієнта можна отримати id та назву мерчанта echo $monoClient->getMerchantId(); echo $monoClient->getMerchantName(); //для створення платежів створюємо цей об'єкт $monoPayment = new \MonoPay\Payment($monoClient); //створення платежу $invoice = $monoPayment->create( 1000, [ //деталі оплати 'merchantPaymInfo' => [ 'reference' => 'my_shop_order_28142', //номер чека, замовлення, тощо; визначається мерчантом (вами) 'destination' => 'Оплата за замовлення #28142', //призначення платежу 'basketOrder' => [ //наповнення замовлення, використовується для відображення кошика замовлення [ 'name' => 'Товар1', //назва товару 'qty' => 2, //кількість 'sum' => 500, //сума у мінімальних одиницях валюти за одиницю товару 'icon' => 'https://example.com/images/product1.jpg', //посилання на зображення товару 'unit' => 'уп.', //назва одиниці вимiру товару ], ], ], 'redirectUrl' => 'https://example.com/order-result', //адреса для повернення (GET) - на цю адресу буде переадресовано користувача після завершення оплати (у разі успіху або помилки) 'webHookUrl' => 'https://example.com/mono-webhook', //адреса для CallBack (POST) – на цю адресу буде надіслано дані про стан платежу при кожній зміні статусу. Зміст тіла запиту ідентичний відповіді запиту “перевірки статусу рахунку” 'validity' => 3600 * 24 * 7, //строк дії в секундах, за замовчуванням рахунок перестає бути дійсним через 24 години 'paymentType' => 'debit', //debit | hold. Тип операції. Для значення hold термін складає 9 днів. Якщо через 9 днів холд не буде фіналізовано — він скасовується ] ); print_r($invoice); //інформація про платіж $invoice = $monoPayment->info('2305046jUBEj8WfyaBdB'); print_r($invoice); //відшкодування $result = $monoPayment->refund('2305046jUBEj8WfyaBdB'); print_r($result); //скасування посилання на оплату $result = $monoPayment->cancel('2305046jUBEj8WfyaBdB'); print_r($result); //деталі успішної оплати $invoiceDetails = $monoPayment->successDetails('2305046jUBEj8WfyaBdB'); print_r($invoiceDetails); //Фіскальний чек $result = $monoPayment->fiscalchecks('2305046jUBEj8WfyaBdB'); print_r($result); //списати заблоковану сумму //зверніть увагу: списати можна тільки таку самму або меншу сумму яку ви заблокували $result = $monoPayment->captureHold('2305046jUBEj8WfyaBdB', 500); print_r($result); //список успішних оплат за останні сутки $list = $monoPayment->items(time() - 60 * 60 * 24); print_r($list); //оплата по токену (токен можна отримати якщо створити платіж і додати в цей платіж помітку saveCardData) $result = $monoPayment->createWithCardToken('67XZtXdR4NpKU3',50.99,[ 'ccy' => 980, //валюта гривня 'initiationKind' => \MonoPay\Payment::TOKEN_PAYMENT_INIT_KIND_MERCHANT //або client - ініціатор платежу ]); print_r($result); //список прив'язаник карток $result = $monoPayment->listCardTokens('user_245'); //user_245 - walletId який ви вказували при створенні токену на прешому платежі print_r($result); //видалення картки deleteCardToken('67XZtXdR4NpKU3'); ``` ### Отримання вебхуку: [](#отримання-вебхуку) > ЗАСТЕРЕЖЕННЯ!!! Обов'язково обгорніть обробку вебхука в try-catch, бо якщо ви відповісте НЕ 200 кодом, а веб-хуків буде багато - ваш IP може потрапити в тимчасовий бан (хз на скільки, в мене було на сутки) ``` require_once 'vendor/autoload.php'; //створили клієнта - через нього запити будуть слатись $monoClient = new \MonoPay\Client('YOUR_TOKEN_HERE'); //отримання публічного ключа (бажано закешувати) $publicKey = $monoClient->getPublicKey(); //класс для роботи з вебхуком $monoWebhook = new \MonoPay\Webhook($monoClient, $publicKey, $_SERVER['HTTP_X_SIGN']); //отримуємо вхідні дані $body = file_get_contents('php://input'); //валідуємо дані if ($monoWebhook->verify($body)) { echo 'Ці дані прислав монобанк, можна обробляти'; } else { echo 'Дані прислав шахрай, ігноруємо'; } ``` ### Health Score 25 — LowBetter than 35% of packages Maintenance39 Infrequent updates — may be unmaintained Popularity5 Limited adoption so far Community9 Small or concentrated contributor base Maturity40 Maturing project, gaining track record Bus Factor1 Top contributor holds 60.9% 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 671d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/13577430?v=4)[serdominus](/maintainers/serdominus)[@serdominus](https://github.com/serdominus) --- Top Contributors [![plakidan](https://avatars.githubusercontent.com/u/18316735?v=4)](https://github.com/plakidan "plakidan (14 commits)")[![serdominus](https://avatars.githubusercontent.com/u/13577430?v=4)](https://github.com/serdominus "serdominus (8 commits)")[![andrew-demb](https://avatars.githubusercontent.com/u/12499813?v=4)](https://github.com/andrew-demb "andrew-demb (1 commits)") ### Embed Badge ![Health badge](/badges/serdominus-monobank-pay/health.svg) ``` [![Health](https://phpackages.com/badges/serdominus-monobank-pay/health.svg)](https://phpackages.com/packages/serdominus-monobank-pay) ``` ### Alternatives [aws/aws-sdk-php AWS SDK for PHP - Use Amazon Web Services in your PHP project 6.3k543.5M2.6k](/packages/aws-aws-sdk-php)[neuron-core/neuron-ai The PHP Agentic Framework. 2.0k656.1k38](/packages/neuron-core-neuron-ai)[tencentcloud/tencentcloud-sdk-php TencentCloudApi php sdk 3741.3M46](/packages/tencentcloud-tencentcloud-sdk-php)[chargebee/chargebee-php ChargeBee API client implementation for PHP 758.5M9](/packages/chargebee-chargebee-php)[tempest/framework The PHP framework that gets out of your way. 2.2k34.4k15](/packages/tempest-framework)[imdhemy/google-play-billing Google Play Billing 491.5M5](/packages/imdhemy-google-play-billing) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)