Developers

Koppel je webshop via de API en webhooks

Olvano heeft een REST API en webhooks — maak facturen programmatisch op en reageer in realtime op events.

Petr Svoboda

·2-6-2026

Heb je een webshop of een eigen systeem? Met de REST API van Olvano factureer je zonder handmatig klikken, en met webhooks weet je meteen wat er met een factuur gebeurt.

Het API-token

Authenticeer aanroepen met een token in de Authorization: Bearer …-header. Het token wordt aangemaakt door de accounteigenaar, hoort bij precies één account en draagt zijn eigen scopes (invoices, expenses, reports). De platte tekst wordt maar één keer getoond — alleen een hash wordt bewaard.

curl -X POST "$STARGATE/api/accounts/$SLUG/invoices" \
  -H "Authorization: Bearer sg_your_token" \
  -H "Content-Type: application/json" \
  -d '{ "subjectId": "ID", "lines": [ { "name": "Item", "unitPrice": "1000", "vatRate": 21 } ] }'

Webhooks

In plaats van de API steeds te bevragen, laat je events naar je toe sturen. Registreer een URL en kies de events (of * voor alle):

invoice_created, invoice_sent, invoice_paid, invoice_overdue, invoice_cancelled, invoice_uncollectible, invoice_viewed, invoice_reminder_sent, recurring_generator_invoice_created.

Elke aflevering draagt een Idempotency-Key-header (UUID) — gebruik die om te dedupliceren.
Stel je eigen authHeader in om te verifiëren dat een verzoek echt van Olvano komt.
Een mislukte aflevering wordt tot 5 keer opnieuw geprobeerd met exponentiële backoff.