This guide shows you how to connect PrintAPI.nl to Composerie. PrintAPI.nl is an EU print provider based in the Netherlands. Its catalog covers posters, canvas, photo books, and cards. You connect it with OAuth client credentials: a Client ID and a Client Secret. This article is for merchants who want PrintAPI.nl to fulfill personalized orders, and it walks you through testing the connection before you go live.
Before you start
PrintAPI.nl uses OAuth client credentials instead of a single API key. You create an application in the PrintAPI portal, and that application gives you a Client ID and a Client Secret. You enter both in Composerie.
Here is what to have ready:
- A PrintAPI account. You can create a free test account first if you want to try the connection before placing real orders.
- The applications page in the PrintAPI portal. This is where you create an application and read its credentials.
- An application named for Composerie. Create one, then copy its Client ID and Client Secret.
- A decision on which environment to start in. Use the test environment to validate the setup, or go straight to production if you are ready for real orders.
The connect page in Composerie shows a guide called “How merchants set up PrintAPI”. It has numbered steps that link out to the PrintAPI portal and docs, so you can open the right pages without searching for them.
To open the connect page, go to Integrations, open the Fulfillment section, and click the PrintAPI.nl card. That takes you to the PrintAPI connect page. If you are setting up your first provider, connect a provider gives you the wider picture first.
Choose an environment and enter credentials
On the connect page you pick an environment, paste your two credentials, and test them. Composerie validates the OAuth credentials with PrintAPI before it saves anything, so you find out right away if a value is wrong.
Pick the environment
Choose Test environment to validate first, or Production environment if you are ready to take real orders. The page defaults to the test base URL (test.printapi.nl/v2). Production points to api.printapi.nl/v2. Both options sit above the Client ID and Client Secret fields.
Enter your Client ID and Client Secret
Paste the Client ID and Client Secret from your PrintAPI application. The Client Secret is hidden as you type. Use the eye icon next to it to check what you pasted.
Test credentials usually start with a test_ prefix and map to the test base URL. If your Client ID starts with test_, keep the test environment selected.
Test the connection
Click Test connection. Composerie sends your credentials to PrintAPI and checks that they are valid. When the credentials pass, you see a success message that confirms they were accepted. If they fail, the message tells you what went wrong so you can fix the value and try again.
Finish and load the catalog
Once the test passes, you can finish the connection and bring the PrintAPI catalog into Composerie.
Click Connect to save the connection. Composerie encrypts your credentials at rest and only decrypts them to fulfill orders. After you connect, Composerie can fetch the PrintAPI product catalog and the product specifications for each item, so you can build products against real PrintAPI data.
The connect page now shows the connected state. You can see which environment you are on, a Last verified time, and a Browse Catalog button. From there you can browse a provider catalog and pick a product to start with, such as a poster or a canvas.
What is the difference between the test and production environments?
Test uses the test.printapi.nl base URL with test credentials, so nothing is produced or shipped. Production uses the api.printapi.nl base URL with production credentials and places real orders.
Why did my connection test fail?
The most common cause is a credential that does not match the selected environment. Confirm your Client ID prefix matches the environment, and that you copied the full Client ID and Client Secret from your PrintAPI application.
Where do I find my Client ID and Client Secret?
Open the applications page in the PrintAPI portal, create an application for Composerie, and copy both values from that application. The connect page links straight to the portal.
Can I change the environment later?
Yes. Reconnect with the credentials for the environment you want. Use the test environment while you set up, then production once you are ready for real orders.
If the connection later turns unhealthy or stops verifying, see keep a provider connection healthy. If you get stuck, contact support.
Next: browse a provider catalog to pick a PrintAPI product and start building.