README

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

Features

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.

Requirements

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

Installation

composer require vladchornyi/mono:^1.4

Quick Start

use Vladchornyi\Mono\MonoClient;

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

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

Documentation

Testing From Source

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.

License

MIT

vladchornyi / mono

Maintainers

Package info

Statistics

Security