Dodawanie i aktywacja webhooka

Podczas weryfikacji inFakt wysyła na podany adres żądanie POST z losowym kodem w polu verification_code. Aplikacja musi odesłać ten sam kod w odpowiedzi:

import express from "express";

const app = express();
app.post("/webhooks/infakt", express.json(), (req, res) => {
  if (req.body.verification_code) {
    return res.status(200).json({ verification_code: req.body.verification_code });
  }
  // Tu obsłuż zwykłe zdarzenia (req.body.event, req.body.resource).
  res.sendStatus(200);
});
app.listen(3000);

Webhook dodaje się w aplikacji inFakt, w Ustawienia → Inne opcje → Webhooki, przyciskiem Dodaj nowy webhook. Formularz zawiera pola:

• Adres URL: adres endpointu w aplikacji integratora.
• Opis: nazwa, która ułatwi rozpoznanie webhooka.
• Zawartość danych: pełne dane albo dane bez informacji poufnych (bez numeru faktury i kwot).
• Zdarzenia: zdarzenia, o których webhook ma powiadamiać.

Przycisk Utwórz webhook zapisuje webhook ze statusem Do weryfikacji.

Weryfikację uruchamia przycisk Zweryfikuj w szczegółach webhooka. Gdy aplikacja odeśle poprawny verification_code, status zmienia się na Aktywny.

Sekretny klucz HMAC ze szczegółów webhooka zapisuje się w zmiennej środowiskowej aplikacji, np. INFAKT_WEBHOOK_SECRET. Klucz służy do weryfikacji podpisu.