Developers

Connectez votre boutique en ligne via l'API et les webhooks

Olvano dispose d'une API REST et de webhooks — émettez des factures par programmation et réagissez aux événements en temps réel.

Petr Svoboda

·02/06/2026

Vous avez une boutique en ligne ou votre propre système ? Avec l'API REST de Olvano, vous facturez sans clics manuels, et grâce aux webhooks vous savez instantanément ce qu'il advient d'une facture.

Le jeton d'API

Authentifiez les appels avec un jeton dans l'en-tête Authorization: Bearer …. Le jeton est créé par le propriétaire du compte, appartient à un seul compte et porte ses propres portées (invoices, expenses, reports). Le texte en clair n'est affiché qu'une seule fois — seule une empreinte est conservée.

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

Plutôt que d'interroger l'API en boucle, faites-vous pousser les événements. Enregistrez une URL et choisissez les événements (ou * pour tous) :

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

Chaque livraison porte un en-tête Idempotency-Key (UUID) — utilisez-le pour dédupliquer.
Définissez votre propre authHeader pour vérifier qu'une requête provient bien de Olvano.
Une livraison échouée est réessayée jusqu'à 5 fois avec un délai exponentiel.