Skip to main content

Przegląd

Dostawa dynamiczna pozwala programowo obsługiwać realizację produktów poprzez implementację endpointu webhook, który odbiera informacje o zamówieniu i zwraca treść dostawy. Idealne do dostarczania produktów cyfrowych, kluczy licencyjnych, kodów gier lub integracji z zewnętrznymi systemami realizacji. Gdy klient kupuje produkt z włączoną dostawą dynamiczną, Komerza natychmiast wysyła żądanie POST do skonfigurowanego URL webhooka ze szczegółami zamówienia, a Twój endpoint odpowiada treścią do dostarczenia klientowi.
Dostawa dynamiczna jest konfigurowana dla każdego wariantu produktu w ustawieniach produktu w sekcji metod dostawy.

Przypadki użycia

Produkty cyfrowe

Dostarczaj klucze licencyjne, linki do pobierania lub kody dostępu w czasie rzeczywistym

Integracja zewnętrzna

Połącz się z zewnętrznymi systemami realizacji lub zarządzania magazynem

Niestandardowa logika

Implementuj złożone reguły dostawy bazujące na danych klienta, produktu lub zamówienia

Kody do gier

Automatycznie dostarczaj klucze do gier, kody aktywacyjne lub przedmioty w grze

Jak to działa

  1. Klient kupuje - Klient finalizuje zakup produktu z włączoną dostawą dynamiczną
  2. Webhook wyzwolony - Komerza wysyła żądanie POST do skonfigurowanego URL webhooka
  3. Twoja odpowiedź - Twój endpoint przetwarza żądanie i zwraca treść dostawy
  4. Klient otrzymuje - Zwrócona treść jest dostarczana klientowi jako zwykły tekst

Konfiguracja

Konfigurowanie dostawy dynamicznej

  1. Przejdź do swojego produktu w panelu Komerza
  2. Wybierz wariant, który chcesz skonfigurować
  3. Wybierz Dostawa dynamiczna jako metodę dostawy
  4. Wprowadź URL swojego endpointu webhooka
  5. Wygeneruj i zapisz swój sekret webhooka
Chroń swój sekret webhooka. Służy do weryfikacji, że żądania pochodzą rzeczywiście od Komerza.

Żądanie webhook

Nagłówki żądania

Weryfikacja podpisu

Wszystkie żądania webhook zawierają nagłówek X-Signature z podpisem HMAC SHA256. Powinieneś zweryfikować ten podpis, aby upewnić się, że żądanie pochodzi od Komerza. Obliczanie podpisu:

Struktura payload

Webhook otrzymuje ładunek JSON o następującej strukturze:

Odpowiedź webhook

Format odpowiedzi

Twój endpoint musi odpowiedzieć zwykłym tekstem (text/plain) zawierającym treść dostawy. Zostanie ona wyświetlona klientowi dokładnie tak, jak zostanie zwrócona.
Ostatnia modyfikacja 6 kwietnia 2026