Onboarding Setup

To send invoices on the Peppol network, your company must be registered as a legal entity. This is the official identity that appears as the sender on every invoice you send.

Required fields

• companyName — your registered business name
• street — street address
• city — city
• postalCode — postal / ZIP code
• country — ISO 3166-1 alpha-2 country code (e.g. BE, NL, FR)

A Peppol Identifier is your address on the Peppol network — it's how other participants find and send documents to you. The format is {EAS scheme}:{endpoint ID}.

Common EAS schemes

For example, a Belgian company with KBO number 0456.789.012 would use the Peppol ID 0208:BE0456789012.

Sandbox

• Use any company name and address — they don't need to be real
• A test Peppol ID is auto-created for you (de:lwid scheme)
• Invoices are validated and processed but never reach the live Peppol network
• Perfect for development, testing, and integration work
• See Sandbox for rate limits and detailed limitations

Production

• Use your real company details (registered name, address)
• Provide your actual Peppol Identifier (e.g. KBO, SIRET, KVK number)
• Invoices are delivered on the live Peppol network
• Requires a paid plan (Starter, Pro, or Business)

The onboarding wizard appears automatically when you create a new organization. Here's what to expect:

1. 1. Create an account

   Sign up at console.getpeppr.dev and create a new organization.

2. 2. Complete the onboarding form

   The wizard asks for your company name, street address, city, postal code, and country. In sandbox mode, you can use test values.

3. 3. Click "Complete Setup"

   Behind the scenes, getpeppr creates your legal entity and registers a Peppol identifier. In sandbox, this happens instantly with auto-generated test credentials.

4. 4. Create an API key

   Once onboarding is complete, head to the API Keys page in the console to create your first sk_sandbox_... key.

After sandbox setup

Your sandbox Peppol ID is active immediately. You can start sending test invoices using the SDK or the API. Head to the Authentication guide to create your API key, then follow Send an Invoice to send your first document.

Finding recipients

Need to find a recipient's Peppol ID before sending an invoice? Use the Peppol Directory search to look up participants by name, country, or VAT number — and import them directly into your contact list. See the Contacts & Directory guide for details.

Moving to production

When you're ready to go live, upgrade to a paid plan from the console. You'll need to update your legal entity with real company details and provide your actual Peppol identifier (your country's business registration number in the correct EAS scheme). See Going to Production for the full checklist.