Stap 1: sandbox-account aanvragen

Sandbox-account aanvragen voor de PSB API, en hoe je van sandbox naar productie gaat.

Zonder sandbox geen veilige integratie. In acceptatie test je tokens, verzending en webhooks zonder productieimpact. Documenten vanaf een testaccount blijven op het Peppol-testnetwerk.

Wat je aanvraagt

Vraag OAuth2-credentials aan via de sandbox-wizard. Kies het type koppeling dat je bouwt (eigen software, ERP, serviceprovider).

Sandbox aanvragen

Na afronding van de aanvraag maakt eConnect doorgaans aan:

GegevenBetekenisclientIdIdentificeert jouw applicatie bij de Identity ServerclientSecretGeheim voor token-requests — behandel als wachtwoordTest-partyPeppol-party op het testnetwerk (voor verzenden/ontvangen in accp)Eventueel username/passwordAlleen nodig bij Resource Owner Password-flow; zie Authenticatie
Kosten en limieten

Sandbox-/acceptatietoegang (accp-psb) is gratis, zodat je drempelloos kunt beginnen met bouwen:

  • Geen productietarieven of transactiebundels op sandbox-/acceptatieverkeer
  • Geen harde limiet op de looptijd van je test-/acceptatietoegang
  • Geen maximum op het aantal testtransacties
  • Wel fair use: oneigenlijk of onevenredig zwaar gebruik kan worden bijgestuurd

Verzendkosten op de sandbox gaan niet van een saldo of documentbundel af. Productie-PSB volgt het partnership. Er is geen publiek tarief per document en geen selfservice om een documentbundel te zien of op te waarderen. Wijs voor PSB-verbruik niet naar Platform-saldo of Platform-opwaarderen.

Aanbevolen flow

Voor server-naar-server integraties: Client Credentials (grant_type=client_credentials, scope ap). Zo koppel je rechten aan de applicatie zonder eindgebruikerswachtwoorden in je backend.

Wat je nog niet doet
  • Geen productie-clientId in lokale .env van developers
  • Geen testtraffic naar psb.econnect.eu / identity.econnect.eu
  • Geen aanname dat accp-data of -parties in productie bestaan
  • Geen aanname dat sandbox-credentials in productie werken
Van sandbox naar productie

Een sandbox-account wordt niet vanzelf een productieomgeving. Voor productie is een afspraak met Sales nodig. Kosten en doorlooptijd worden per klantsituatie in dat gesprek bepaald. Er is geen vaste publieke prijs en geen vaste commerciële doorlooptijd los van die afspraak.

  1. Afspraak met Sales.
  2. Sales maakt een agreement ter ondertekening.
  3. Je tekent en vult het onboardingsformulier in.
  4. Daarna gaat een opleverticket naar Delivery. Delivery neemt de opdracht in behandeling.
  5. Standaard productie (geen maatwerk): TechSupport levert binnen 10 werkdagen.
  6. Maatwerk: de oplevertermijn hangt af van de impact.

Dit pad geldt niet voor de sandbox-wizard, een partnertraject en het softwarepakket-productiegesprek. Sandbox-credentials werken niet in productie.

Checklist voordat je verdergaat
  1. Credentials ontvangen en veilig opgeslagen (secrets manager / vault)
  2. Je weet welke partyId je test-party heeft
  3. Je kent het verschil tussen acceptatie- en productiehosts — volgende stap: Acceptatie-endpoints