The PHP SDK (econnect-psb-php) is a reference implementation for the PSB REST API. The library handles OAuth token management and provides typed API classes for common operations.

• PHP 7.2 or higher
• Extensions: curl, json, mbstring
• Composer

composer require everbinding/econnect-psb-php

Then load the Composer autoloader in your project:

require __DIR__ . '/vendor/autoload.php';

Set the default configuration with your credentials and the correct environment. During development, use the acceptance URLs.

$config = \EConnect\Psb\Configuration::getDefaultConfiguration();

$config
    ->setUsername('your-username')          // only for Resource Owner flow
    ->setPassword('your-password')          // only for Resource Owner flow
    ->setClientId('your-client-id')
    ->setClientSecret('your-client-secret')
    ->setHost('https://accp-psb.econnect.eu')
    ->setApiKey('Subscription-Key', 'your-subscription-key'); // optional, legacy

For the Identity Server, the SDK uses OpenID Connect internally via jumbojett/openid-connect-php. Which credentials you need depends on the chosen OAuth2 flow — see Authentication.

Tip: the Subscription-Key is legacy for the PSB API and is no longer required. If you send it, the value must still be valid.

After configuration, call login() to obtain and cache an access token:

$config = \EConnect\Psb\Configuration::getDefaultConfiguration();

$auth = new \EConnect\Psb\Authentication($config);
$auth->login();

The SDK refreshes the token automatically as long as you reuse the same Configuration instance.

With SalesInvoiceApi you send a UBL file to the PSB. The {partyId} is the sender's Peppol identifier; the receiver is optional — the PSB then picks the best route.

$config = \EConnect\Psb\Configuration::getDefaultConfiguration();

$salesInvoiceApi = new \EConnect\Psb\Api\SalesInvoiceApi(
    new GuzzleHttp\Client(),
    $config
);

$senderPartyId = '0106:12345678';
$filePath = './invoice.xml';
$receiverPartyId = null; // optional

$salesInvoiceApi->sendSalesInvoice($senderPartyId, $filePath, $receiverPartyId);

Make sure the UBL document is valid; otherwise the PSB blocks the send. More about the endpoint and idempotency: Send invoice.

The repository includes examples for receiving incoming invoices via webhooks:

• ExampleWebhookReceiver.php — webhook endpoint
• ExampleSendInvoice.php — send via Peppol

PSB webhooks are secured with an X-EConnect-Signature header. See Configure webhooks for platform configuration.

The SDK generates API classes per endpoint group from the OpenAPI spec. You can find the full list in the repository and on psb.econnect.eu. Typical classes:

Consult the Swagger UI for request and response schemas per operation.

The SDK uses Guzzle as the HTTP client. API errors (4xx, 5xx) surface as GuzzleHttp\Exception\ClientException or ServerException. Check $e->getResponse()->getBody() for the PSB error details.

Instead of this library, you can also generate PHP code from the OpenAPI spec. See OpenAPI codegen for the command and authentication notes.