Peppol identifier verification

Before an account can send invoices in production, each Peppol identifier is verified against a public business registry. This page explains what that means, why we do it, and what to do if verification fails.

Why we verify

The Peppol network assumes senders are who they say they are. Our Integrator agreement with OpenPeppol requires us to make a reasonable effort to prevent invoices from being sent on behalf of entities unrelated to the sender. Verification is how we do that.

What we check

  • That your identifier (e.g. a UK Company Registration Number) exists in the relevant public registry.
  • That the legal name you declared is a close match to the registered name.

We currently verify UK identifiers against Companies House. Support for other EU registries (VIES, INSEE, KBO) is rolling out.

What happens at registration

  1. You add a production Peppol identifier in the dashboard, including the declared company name and the attestation checkbox.
  2. We begin verification immediately. Most checks complete in under a minute.
  3. Until verification succeeds, invoice sending is paused for that identifier.
  4. We email you when the outcome is resolved.

Verification states

The API returns a verificationState field on every Peppol identifier. The dashboard surfaces a human-readable badge for each.

API value Dashboard badge Meaning
sandbox_autoSandbox auto-approvedSandbox only — auto-approved without registry lookup.
unverifiedQueued…Waiting for verification to start.
verifyingVerifying…Currently checking against the registry.
verified✓ VerifiedMatched. Invoice sending is unlocked for this identifier.
mismatch⚠ Needs reviewIdentifier exists but the declared name doesn't match closely enough.
not_found⚠ Not foundIdentifier not found in the registry, or the entity is dissolved.
api_errorTemporarily unavailableRegistry is down. The cron retries automatically every 5 minutes.
manually_approved✓ Approved (reviewed)Manually approved by our team after review.

If verification fails

Reply to the notification email with proof of authorisation (for example your Articles of Incorporation or an extract from the public registry showing your entity), or email us at hello@getpeppr.dev. Our team typically responds within one business day.

Sandbox accounts

Sandbox identifiers are auto-approved and never verified against a registry — they are intended for integration testing only and cannot be used to send production invoices.