PHPackages                             maguru/module-mono-core - 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. [HTTP &amp; Networking](/categories/http)
4. /
5. maguru/module-mono-core

ActiveMagento2-module[HTTP &amp; Networking](/categories/http)

maguru/module-mono-core
=======================

Monobank Integration Core Module for Magento 2 — HTTP client, config, ECDSA webhook verification

1.0.2(today)00proprietaryPHPPHP ~8.1.0||~8.2.0||~8.3.0||~8.4.0||~8.5.0

Since Jun 26Pushed todayCompare

[ Source](https://github.com/MaGuruDev/MonoCore)[ Packagist](https://packagist.org/packages/maguru/module-mono-core)[ RSS](/packages/maguru-module-mono-core/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (3)Versions (3)Used By (0)

MaGuru MonoCore — Monobank Integration Core for Magento 2
=========================================================

[](#maguru-monocore--monobank-integration-core-for-magento-2)

[![Magento 2](https://camo.githubusercontent.com/2941a23c648159f569167aa70150a8e6f865c91c0fe33a569d2dc83a56d76eb7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4d6167656e746f2d322e342532422d627269676874677265656e)](https://camo.githubusercontent.com/2941a23c648159f569167aa70150a8e6f865c91c0fe33a569d2dc83a56d76eb7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4d6167656e746f2d322e342532422d627269676874677265656e)[![Stable Version](https://camo.githubusercontent.com/ee822f0cf3cdd96f94bb0217856043bc6d7f9e422eea9dc56de5ccf0bf79a3ea/68747470733a2f2f706f7365722e707567782e6f72672f6d61677572752f6d6f64756c652d6d6f6e6f2d636f72652f762f737461626c65)](https://packagist.org/packages/maguru/module-mono-core)[![Total Downloads](https://camo.githubusercontent.com/89801b0e1afc1369294a25f5628b31fc3008890586d971a21c71b87ede0fadb4/68747470733a2f2f706f7365722e707567782e6f72672f6d61677572752f6d6f64756c652d6d6f6e6f2d636f72652f646f776e6c6f616473)](https://packagist.org/packages/maguru/module-mono-core)[![License](https://camo.githubusercontent.com/381495dcf6550027ad27d0952b32dde1ea6f88cc82ae5b7e890103478dd2c0a5/68747470733a2f2f706f7365722e707567782e6f72672f6d61677572752f6d6f64756c652d6d6f6e6f2d636f72652f6c6963656e7365)](https://packagist.org/packages/maguru/module-mono-core)

**FREE** infrastructure module. Provides the shared HTTP clients, encrypted configuration, ECDSA webhook verification, and exception hierarchy used by all other MaGuru Monobank modules.

---

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

[](#requirements)

ComponentVersionMagento Open Source / Adobe Commerce2.4.4+PHP8.1–8.5MaGuru\_Core^1.0.1ext-opensslanyext-jsonanyguzzlehttp/guzzle^7.5---

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

[](#installation)

```
composer require maguru/module-mono-core
bin/magento module:enable MaGuru_MonoCore
bin/magento setup:upgrade
bin/magento cache:flush
```

---

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

[](#configuration)

**Stores → Configuration → MaGuru → Monobank Integration**

FieldDescriptionEnabledEnable/disable the integrationAcquiring API TokenYour Monobank merchant X-Token (encrypted)Chast Store IDStore ID for Monobank Частини APIChast SecretHMAC-SHA256 secret for Chast callbacks (encrypted)HTTP TimeoutGuzzle request timeout in seconds (default: 15)Connect TimeoutTCP connect timeout in seconds (default: 5)Debug LoggingWrite detailed request/response logs to `var/log/mono_core.log`---

Features
--------

[](#features)

- **AcquiringClient** — Guzzle HTTP client for `api.monobank.ua` with `X-Token` auth and error mapping (403→AuthException, 404→NotFoundException, 429→RateLimitException, 500→ApiException)
- **ChastClient** — Guzzle HTTP client for Monobank Частини API with HMAC-SHA256 `signature` header
- **WebhookVerifier** — ECDSA P-256 / SHA-256 verification of `X-Sign` webhook signatures with pubkey caching and auto-retry on key rotation
- **CLI** — `bin/magento mono:acquiring:validate-token` to verify your API token
- **Exception hierarchy** — `ApiException`, `AuthException`, `RateLimitException`, `NotFoundException`

---

Developer Notes
---------------

[](#developer-notes)

**This module provides interfaces only — no UI, no payment method.**

Other modules interact via:

```
// In di.xml

```

Inject `AcquiringClientInterface` or `ChastClientInterface` in your service — never instantiate clients directly.

---

Tests
-----

[](#tests)

```
bin/clinotty php vendor/bin/phpunit -c app/code/MaGuru/MonoCore/Test/Unit/phpunit.xml
```

57 unit tests · PHPStan Level 8 ✅

---

Support
-------

[](#support)

- Email:
- Issues: via Magento Marketplace order page

---

License
-------

[](#license)

Free to use. See [LICENSE.txt](LICENSE.txt) for details.

###  Health Score

42

—

FairBetter than 89% of packages

Maintenance100

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity52

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

Total

2

Last Release

0d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/8372937?v=4)[Maguru](/maintainers/maguru)[@Maguru](https://github.com/Maguru)

---

Top Contributors

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

---

Tags

integrationmagentomagento-2magento2magento2-extensionmagento2-modulemagurumonomonobank

### Embed Badge

![Health badge](/badges/maguru-module-mono-core/health.svg)

```
[![Health](https://phpackages.com/badges/maguru-module-mono-core/health.svg)](https://phpackages.com/packages/maguru-module-mono-core)
```

###  Alternatives

[aws/aws-sdk-php

AWS SDK for PHP - Use Amazon Web Services in your PHP project

6.2k532.1M2.5k](/packages/aws-aws-sdk-php)[neuron-core/neuron-ai

The PHP Agentic Framework.

2.0k496.1k33](/packages/neuron-core-neuron-ai)[illuminate/http

The Illuminate Http package.

11937.2M6.5k](/packages/illuminate-http)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3661.2M46](/packages/tencentcloud-tencentcloud-sdk-php)[dreamfactory/df-core

DreamFactory(tm) Core Components

1652.0k38](/packages/dreamfactory-df-core)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

252.5k](/packages/eslazarev-wildberries-sdk)

PHPackages © 2026

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