Sandbox
Test the Integrated API against Joulo's staging environment • no real machtigingen, no ERE registration, no payouts.
Sandbox
The sandbox is a full copy of the Integrated API running on Joulo's staging environment. Build and test your integration here before you touch production.
Base URL
https://api-staging.joulo.nl/functions/v1/apiTokens come from the staging token endpoint:
POST https://api-staging.joulo.nl/functions/v1/oauth-tokenThe endpoints, scopes, request and response shapes are identical to production • only the host differs. Swap the base URL and your integration moves environments.
Get sandbox credentials
Sandbox credentials are separate from production credentials: a production
client_id does not work on the sandbox and vice versa. Ask your Joulo
contact for a sandbox client • you receive a client_id and client_secret
scoped to your own test partner.
What the sandbox does not do
The sandbox is deliberately inert. Accounts, mandate links and charging data behave exactly like production, but nothing leaves the environment:
- No ERE registration. Nothing is ever submitted to the NEa from the sandbox. A test machtiging has no legal effect and does not bind an EAN.
- No payouts. No payment provider is connected.
- No email. Customers you create receive nothing.
- No charger-backend syncs. Session data only enters through the API endpoints you call.
The flip side: never test against production. A machtiging signed on production is a legal act that binds that EAN to Joulo, even when it was meant as a test.
Data lifetime
Sandbox data is kept indefinitely but carries no guarantees. We reset the environment on request rather than on a schedule, and we announce a reset to active integrators beforehand.