FREE infrastructure module. Provides the shared HTTP clients, encrypted configuration, ECDSA webhook verification, and exception hierarchy used by all other MaGuru Monobank modules.
| Component | Version |
|---|---|
| Magento Open Source / Adobe Commerce | 2.4.4+ |
| PHP | 8.1–8.5 |
| MaGuru_Core | ^1.0.1 |
| ext-openssl | any |
| ext-json | any |
| guzzlehttp/guzzle | ^7.5 |
composer require maguru/module-mono-core
bin/magento module:enable MaGuru_MonoCore
bin/magento setup:upgrade
bin/magento cache:flushStores → Configuration → MaGuru → Monobank Integration
| Field | Description |
|---|---|
| Enabled | Enable/disable the integration |
| HTTP Timeout | Guzzle request timeout in seconds (default: 15) |
| Connect Timeout | TCP connect timeout in seconds (default: 5) |
| Debug Logging | Write detailed request/response logs to var/log/mono_core.log |
Acquiring API Token, Chast Store ID and Chast Secret are configured in the same admin section but are contributed by
MaGuru_MonoPaymentandMaGuru_MonoChastrespectively — see their READMEs. They only appear once the corresponding module is installed.
- AcquiringClient — Guzzle HTTP client for
api.monobank.uawithX-Tokenauth and error mapping (403→AuthException, 404→NotFoundException, 429→RateLimitException, 500→ApiException) - ChastClient — Guzzle HTTP client for Monobank Частини API with HMAC-SHA256
signatureheader - WebhookVerifier — ECDSA P-256 / SHA-256 verification of
X-Signwebhook signatures with pubkey caching and auto-retry on key rotation - CLI —
bin/magento mono:acquiring:validate-tokento verify your API token - Exception hierarchy —
ApiException,AuthException,RateLimitException,NotFoundException
This module provides interfaces only — no UI, no payment method.
Other modules interact via:
// In di.xml
<preference for="MaGuru\MonoCore\Api\AcquiringClientInterface"
type="MaGuru\MonoCore\Model\Client\AcquiringClient"/>Inject AcquiringClientInterface or ChastClientInterface in your service — never instantiate clients directly.
bin/clinotty php vendor/bin/phpunit -c app/code/MaGuru/MonoCore/Test/Unit/phpunit.xml57 unit tests · PHPStan Level 8 ✅
- Email: maguru.sup@gmail.com
- Issues: via Magento Marketplace order page
Free to use. See LICENSE.txt for details.