Een API-sleutel aanmaken en de Orders API gebruiken

Kennisbank · 17 juli 2026

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".

Je ziet de sleutel maar één keer

Direct na het aanmaken tonen we de volledige sleutel. Kopieer hem meteen naar je wachtwoordmanager of je serverconfiguratie. Daarna bewaren wij alleen een versleutelde afdruk — ook wij kunnen hem dan niet meer tonen. Kwijt? Maak een nieuwe aan en trek de oude in.

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": "klant@example.com",
    "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

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.