Skip to content
PHP SDK

Add Peppol e-invoicing to
your Laravel app.

Install the peppol.sh Composer package and send compliant Peppol e-invoices from your Laravel application. Converted, validated, and delivered. Ship in minutes.

Your code calls. We deliver via Peppol.

Call the peppol.sh API from your Laravel app. We convert your invoice to Peppol BIS 3.0 UBL, validate it, and deliver it to your customer's access point on the Peppol network.

1

Send invoice from your controller

Call Peppol::documents()->send() from your Laravel controller or job with your invoice data as an array.

2

peppol.sh converts & validates

We convert your array to Peppol BIS Billing 3.0 UBL XML and run EN 16931 validation. A validation error comes back as an exception that names the field.

3

Delivered via the Peppol network

The validated e-invoice is delivered to your customer's Peppol access point. Track delivery status via webhooks or the API.

event flow
Laravel App
└→ Peppol::documents()->send()
└→ peppol.sh
JSON → UBL conversion
EN 16931 validation
BIS 3.0 compliance
└→ Peppol Network
└→ Customer Access Point
status: delivered ✓

Everything your Laravel app needs for Peppol

The official PHP SDK handles the full lifecycle from invoice array to Peppol delivery.

PHP SDK

Arrays in, arrays out, with the same field names as the API. Runs on PHP 7.4 and later with no other dependencies. Array shapes for PhpStorm and PHPStan.

EU e-invoicing compliance

Invoices are validated against EN 16931 and Peppol BIS 3.0 before delivery. Meet Belgium 2026 and EU ViDA mandates.

Laravel integration

Auto-discovered on Laravel 8 to 13. A Peppol facade, an injectable client, and a config file you can publish.

Webhook support

The peppol.webhook middleware verifies each signature. Receive delivery confirmations, failures, and status updates.

Sandbox and test fakes

Send test invoices in the sandbox without touching the live Peppol network. In your test suite, Peppol::fake() sends nothing at all.

Error handling

One exception class for each kind of failure, with the API error code. Know exactly what field is missing or invalid before delivery.

Three steps. Five minutes.

Get Peppol e-invoicing running in your Laravel app in under five minutes.

1

Install the package

Run composer require peppol-sh/sdk to add the peppol.sh PHP SDK to your Laravel project. Laravel discovers it automatically.

2

Configure your API key

Add your PEPPOL_API_KEY to your .env file. For a sandbox key, also set PEPPOL_BASE_URL=https://sandbox.peppol.sh. Get a key free from the dashboard.

3

Send your first invoice

Call Peppol::documents()->send() with your invoice data. We handle conversion, validation, and delivery.

EN 16931 validated
Peppol BIS 3.0 compliant
Belgium 2026 ready
EU ViDA ready
Certified Access Point

Pay per invoice. No monthly fees.

€0.25/ invoice sent via Peppol
Free sandbox foreverNo monthly feesCredit notes includedVolume discounts
Start for free →

Common questions

Does this work with Laravel queues?

Yes. You can dispatch invoice sending to a queue. The SDK works in any context. Controllers, jobs, commands, or event listeners. Put an idempotency_key in the payload, and a retried job does not send the invoice twice.

Do I need to generate UBL XML myself?

No. Send your invoice as a PHP array using the SDK. We handle the conversion to Peppol BIS Billing 3.0 UBL XML, validation against EN 16931, and delivery via the Peppol network.

What if my customer isn't on Peppol?

You can look up any company on the Peppol network with Peppol::lookup()->participant(). If the recipient isn't registered, the API returns a clear error before you attempt to send.

How do I handle webhooks in Laravel?

Create a route in routes/api.php and add the peppol.webhook middleware. Set your whsec_ secret as PEPPOL_WEBHOOK_SECRET. The middleware verifies the X-Peppol-Signature-V2 header (an HMAC-SHA256 over the timestamp and the raw body) in constant time, rejects stale timestamps to block replays, and answers 400 on a bad signature. The full algorithm is in the API reference.

Is this compliant with EU e-invoicing mandates?

Yes. Every invoice is validated against EN 16931 (the EU standard) and Peppol BIS Billing 3.0 before delivery. This covers the Belgium B2B mandate (January 2026), and prepares you for ViDA (EU-wide, 2030).

Can I test before going live?

Yes. Start in sandbox mode to send test invoices via email. In your own test suite, Peppol::fake() records the calls and sends nothing. When you're ready, complete KYC verification and switch to live mode to deliver via the real Peppol network.

Peppol e-invoicing for Laravel. Ship in minutes.

Install the SDK, configure your API key, and start sending compliant e-invoices from your Laravel app.

Get started →