Bijgewerkt op 17 juli 2026 · 2 min leestijd
Heb je een developer, of een webshopsysteem dat webhooks kan versturen? Dan is de Orders API de beste route: je server meldt elke afgeronde bestelling bij ons aan en wij regelen de rest.
Stap 1 — Maak een sleutel aan
Ga in je dashboard naar Koppelingen en klik op Sleutel aanmaken. Geef hem een naam die je later terugkent — "Shopify-koppeling" of "Bestelsysteem productie".
Stap 2 — Bewaar hem veilig
Een API-sleutel is een wachtwoord. Dus:
- Alleen op je server. Nooit in browsercode, een mobiele app of een publieke repository — daar kan iedereen hem uitlezen.
- Niet in je thema of via e-mail. Gebruik een omgevingsvariabele of de wachtwoordkluis van je hostingpartij.
- Kwijtgeraakt of gelekt? Trek hem direct in via Intrekken. Vanaf dat moment werkt hij niet meer, en maak je een nieuwe aan.
Wil je geen sleutel beheren? Gebruik dan het snippet op je bedankpagina — daar zit geen geheim in.
Stap 3 — Meld je bestellingen aan
Eén verzoek per afgeronde bestelling:
curl -X POST https://api.trustbedrijf.nl/v1/orders \
-H "Authorization: Bearer tbk_jouw_sleutel" \
-H "Content-Type: application/json" \
-d '{
"email": "[email protected]",
"orderNumber": "2026-00123"
}'
Meer velden zijn er niet nodig. Stuur ons vooral niet het adres, de betaalgegevens of de bestelregels van je klant: die hebben we niet nodig en dan hoef je ze ook niet met ons te delen.
Je volgt in je dashboard onder Reviews → Uitnodigingen precies wat elke koppeling oplevert:
Je krijgt terug wanneer de uitnodiging de deur uit gaat:
{
"inviteId": "9f8c1e70-…",
"scheduledFor": "2026-07-22T10:14:00.000Z"
}
Was de bestelling al aangemeld, dan krijg je hetzelfde inviteId terug met "duplicate": true. Je kunt dus veilig opnieuw proberen na een storing — er gaat nooit een tweede mail uit.
Wanneer roep je het aan?
Bij de status waarop je zeker weet dat de bestelling doorgaat: betaald of verzonden. Niet bij aangemaakt — dan nodig je ook mensen uit die hun winkelwagen alsnog lieten staan.
De vertraging tot de uitnodiging regel je bij ons (standaard vijf dagen), dus je hoeft zelf niets in te plannen. Je meldt de bestelling aan, wij wachten en versturen.
Foutafhandeling
| Code | Betekenis | Wat doe je |
|---|---|---|
401 | Sleutel ontbreekt, klopt niet of is ingetrokken | Controleer de Authorization-header |
403 | Je keurmerk is (nog) niet actief | Rond eerst de keuring af |
422 | Ongeldige invoer | Controleer het e-mailadres |
429 | Te veel verzoeken | Wacht even; de limiet is 120 per minuut |
5xx | Storing bij ons | Probeer het later opnieuw — dubbele mails zijn uitgesloten |
Laat een mislukte melding je eigen bestelproces nooit blokkeren. Log de fout, ga door, probeer het later opnieuw.
De volledige documentatie
Alle endpoints, velden en limieten staan in de API-documentatie. Loop je vast? Neem contact op — we denken graag mee, ook als je systeem er niet bij staat.