Connect your e-shop with the API and webhooks

Got an e-shop or your own system? With Olvano's REST API you invoice without manual clicking, and with webhooks you learn instantly what happens to an invoice.

API token

Authenticate calls with a token in the Authorization: Bearer … header. The token is created by the account owner, belongs to exactly one account, and carries its own scopes (invoices, expenses, reports). The plaintext is shown only once — only a hash is stored.

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

Instead of polling the API, have events pushed to you. Register a URL and pick the events (or * for all):

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

• Every delivery carries an Idempotency-Key header (UUID) — use it to deduplicate.
• Set your own authHeader to verify a request really came from Olvano.
• A failed delivery is retried up to 5 times with exponential backoff.