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.
Send invoice from your controller
Call Peppol::documents()->send() from your Laravel controller or job with your invoice data as an array.
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.
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.
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.
Install the package
Run composer require peppol-sh/sdk to add the peppol.sh PHP SDK to your Laravel project. Laravel discovers it automatically.
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.
Send your first invoice
Call Peppol::documents()->send() with your invoice data. We handle conversion, validation, and delivery.
Pay per invoice. No monthly fees.
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 →