v1.3.0

What's changed

This is a docs + default-version release. The SDK default API version moves to 2026-04-20 (minor bump per the versioning policy), and the SDK now self-identifies on every request via a User-Agent header.

New features

• User-Agent header on every request — the SDK identifies itself as B2BRouter-PHP/1.3.0 (PHP/{version}; curl/{version}). Applies to JSON and binary endpoints. No caller action required.
• app_info constructor option — applications that wrap the SDK (integrators, plugins) can identify themselves in the User-Agent header.
• B2BRouterClient::VERSION constant and B2BRouterClient::getUserAgent() getter.

Default API version → 2026-04-20

The SDK default api_version moves from 2026-03-02 to 2026-04-20. The PHP interface is unchanged; callers can pin the previous API version via the api_version config option.

The CHANGELOG [1.3.0] entry includes a full migration guide covering the 2026-04-20 API delta (invoice_references[] in place of flat amend fields, classification_code_scheme typo fix, removed payment_method_info response field, inline contact identifier requirement, stricter contact/parent_id validation, Peppol transport response shape changes, plus all new fields).

The CHANGELOG also notes that the new TIN verification endpoint and tin_verification.finished webhook event ship with v2026-04-20 but are not yet surfaced by the SDK.

Also included

• New example: identify_caller_app.php
• docs/VERSIONING.md adds a "Supported API versions" section
• All examples updated to use the new default

Quick start

// Identify your integrating app in the User-Agent header
$client = new B2BRouterClient('your-api-key', [
    'app_info' => [
        'name'    => 'B2BRouter-WooCommerce',
        'version' => '1.0.3',
        'url'     => 'https://shop.example.com',
    ],
]);

// Pin the previous API version if you need time to migrate
$client = new B2BRouterClient('your-api-key', [
    'api_version' => '2026-03-02',
]);

Full Changelog: v1.2.0...v1.3.0