Developers

Свържете онлайн магазина си чрез API и webhook-ове

Olvano има REST API и webhook-ове — издавайте фактури програмно и реагирайте на събития в реално време.

Petr Svoboda

·2.06.2026 г.

Имате онлайн магазин или собствена система? Чрез REST API на Olvano фактурирате без ръчно кликане, а чрез webhook-овете научавате веднага какво се случва с дадена фактура.

API токен

Удостоверявате повикванията с токен в хедъра Authorization: Bearer …. Токенът се създава от собственика на акаунта, принадлежи на точно един акаунт и носи собствени права (scopes: invoices, expenses, reports). Текстът в чист вид се показва само веднъж — от него се запазва само отпечатък (hash).

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 } ] }'

Webhook-ове

Вместо постоянно да питате API, оставете събитията да ви бъдат изпращани. Регистрирате URL адрес и избирате събитията (или * за всички):

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

Всяка доставка носи хедър Idempotency-Key (UUID) — използвайте го за дедупликация.
Задайте собствен authHeader, за да проверите, че заявката наистина идва от Olvano.
Неуспешна доставка се повтаря до 5 пъти с експоненциално нарастващ интервал.