Production-ready PHP client for the Monobank Acquiring API: invoices, subscriptions, statements, merchant details, webhook signature verification, and structured error handling.

• Invoices: create, status, cancel, invalidate, and hold finalization.
• Subscriptions: create, status, list, payment history, cancel/edit.
• Statements and merchant details.
• Verified webhook parsing with X-Sign support.
• Typed webhook payload helpers for invoice and subscription events.
• Stale webhook protection via modifiedDate.
• Replaceable HTTP layer for tests and framework integrations.
• Structured exceptions and safe logging helpers.

• PHP 8.0+
• ext-curl
• ext-json
• ext-mbstring
• ext-openssl

composer require vladchornyi/mono:^1.4

use Vladchornyi\Mono\MonoClient;

$mono = new MonoClient($_ENV['MONO_KEY']);

$merchant = $mono->merchant()->getDetails();
$publicKey = $mono->pubkey()->get();

• Installation and client setup
• Invoices
• Webhooks
• Subscriptions
• Statements and merchant details
• Errors and safe logging

composer test

The default test suite is self-contained and does not call Monobank.

For an optional live smoke test, set MONO_KEY or MONO_ENV_FILE:

MONO_KEY=... composer test:live
MONO_ENV_FILE=/path/to/.env composer test:live

To verify live invoice and subscription creation with a test merchant key:

MONO_KEY=... composer test:live-create
MONO_ENV_FILE=/path/to/.env composer test:live-create

The live create smoke test uses a minimal amount and attempts cleanup after creation.

MIT