Developers

Forbind din webshop med API'et og webhooks

Olvano har et REST-API og webhooks — udsted fakturaer programmatisk, og reagér på hændelser i realtid.

Petr Svoboda

·2.6.2026

Har du en webshop eller dit eget system? Med Olvanos REST-API fakturerer du uden manuelle klik, og med webhooks får du straks at vide, hvad der sker med en faktura.

API-token

Autentificér kald med en token i Authorization: Bearer …-headeren. Token oprettes af kontoejeren, hører til præcis én konto og bærer sine egne scopes (invoices, expenses, reports). Klarteksten vises kun én gang — kun et hash gemmes.

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

I stedet for at spørge API'et igen og igen kan du få hændelser sendt til dig. Registrér en URL, og vælg hændelserne (eller * for alle):

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

Hver levering bærer en Idempotency-Key-header (UUID) — brug den til at fjerne dubletter.
Sæt din egen authHeader for at bekræfte, at en forespørgsel virkelig kom fra Olvano.
En mislykket levering forsøges igen op til 5 gange med eksponentiel backoff.