dev-lancer/von-halsky-php-sdk

Independent PHP SDK for the InPost Von Halsky API

dev-main 2026-08-28 18:12 UTC

Requires

• php: ^8.1
• ext-json: *
• nyholm/psr7: ^1.8
• psr/http-client: ^1.0
• psr/http-factory: ^1.0
• psr/http-message: ^1.1 || ^2.0
• symfony/http-client: ^6.4 || ^7.4 || ^8.1

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.95
• phpdocumentor/shim: ^3.10
• phpstan/phpstan: ^2.2.3
• phpstan/phpstan-phpunit: ^2.0.18
• phpstan/phpstan-strict-rules: ^2.0
• phpunit/phpunit: ^10.5

Suggests

• guzzlehttp/guzzle: Use Guzzle as the PSR-18 HTTP client through GuzzleHttpClientFactory.

MIT

• api
• sdk
• inpost
• von-halsky

Published on Packagist.org on 2026-08-28 18:14 UTC

README

An independent PHP 8.1+ SDK for the InPost Von Halsky API. It provides typed request objects, immutable response models, OAuth 2.0 helpers, PSR-18 HTTP integration, and resource clients for organizations, catalogue data, offers, attachments, orders, returns, refunds, and claims.

This is not an official InPost product and is not affiliated with or endorsed by InPost. InPost and Von Halsky are trademarks of their respective owners.

Status

The SDK implements 40 current operations across organizations, categories, offers, attachments, orders, returns, and claims. It intentionally excludes two deprecated upstream operations. It is not yet published on Packagist, so the repository is a development snapshot rather than a release promise.

Requirements

• PHP 8.1 or newer;
• Composer 2;
• the JSON extension.

Install

After the first tagged release is published, install the package with:

composer require dev-lancer/von-halsky-php-sdk

Until then, use a Composer VCS repository or clone this repository for development. See Installation and first client.

First API call

For an existing access token, create a client with the default secure Symfony transport and list the organizations available to that token:

<?php

declare(strict_types=1);

use DateTimeImmutable;
use DevLancer\VonHalsky\Auth\AccessToken;
use DevLancer\VonHalsky\Auth\StaticTokenProvider;
use DevLancer\VonHalsky\Environment\Environment;
use DevLancer\VonHalsky\VonHalskyClient;

$client = VonHalskyClient::create(
    new StaticTokenProvider(new AccessToken('access-token', new DateTimeImmutable('+5 minutes'))),
    Environment::stage(),
);

$organizations = $client->organizations()->list()->data;

For production integrations, obtain and rotate tokens with the OAuth guide; never hard-code or log real credentials.

Documentation

Choose the documentation language: English or Polish. Both versions offer focused reading paths for a first integration, OAuth, catalogue and offers, order and post-sale processing, and production reliability.

• Guides explain how the SDK fits into an application.
• Operation reference documents every public resource method.
• Production checklist summarizes the application responsibilities that the SDK deliberately leaves to you.
• Runnable examples demonstrate selected workflows without credentials.

License

The SDK source code is available under the MIT License.