Webhooky umožňují Fakturoidu informovat WooCommerce o přijatých platbách. Správně nastavený webhook znamená, že objednávky se ve WordPressu automaticky přepínají do stavů, které jste zvolili v sekci Změna stavu po zaplacení.

Cíl

  • Získat unikátní adresu webhooku (URL) v pluginu.
  • Zapsat ji do Fakturoidu spolu s tajným klíčem (secret).
  • Ověřit, že WooCommerce přebírá aktualizace (např. invoice_paid).

Kde sekci najdete

  1. V administraci přejděte na České pluginy → Fakturoid pro WooCommerce.
  2. Sjeďte k sekci Webhooky (nachází se pod blokem „Vytváření faktur“).

Screenshot checklist:

  • Přehled sekce Webhooky (URL, secret, tlačítko pro zkopírování).
  • Detail tabulky „Změna stavu po zaplacení“.
  • Vložený webhook ve Fakturoidu (obrazovka Nastavení → Webhooky).

Popis prvků v sekci

1. Webhook URL

  • Vypadá jako https://vasweb.cz/wp-json/wc-fakturoid/v1/webhook?key=abc123....
  • Obsahuje unikátní klíč v query parametru key=.
  • Kliknutím na tlačítko Kopírovat zkopírujete URL do schránky.
  • Tip: Uložte si adresu do dokumentace k e-shopu. Při přesunu webu ji budete potřebovat aktualizovat.

2. Webhook secret

  • Textové pole pouze ke čtení.
  • Tajný klíč, kterým Fakturoid podepisuje požadavky.
  • Bezpečnost: Nikdy ho veřejně neukazujte. Pokud máte podezření na únik, klikněte na Znovu vygenerovat.

3. Tlačítko „Znovu vygenerovat“

  • Vytvoří nový secret a okamžitě ho uloží.
  • Po vygenerování musíte přepsat hodnotu ve Fakturoidu, jinak budou požadavky odmítány.
  • Screenshot (volitelný): Zachyťte potvrzovací hlášku po regeneraci.

4. Změna stavu po zaplacení (tabulka)

  • Každý řádek odpovídá kombinaci dopravce nebo obecného nastavení.
  • Vyberte stav WooCommerce, do kterého má objednávka přejít po přijetí platby.
  • Příklad:
    • Balík do ruky → Dokončeno
    • Zásilkovna → Probíhá zpracování
    • Obecný fallback → Probíhá zpracování
  • Pokud se určitý dopravce nehodí, nechte jeho řádek prázdný – plugin použije obecné nastavení.

Nastavení ve Fakturoidu

  1. Přihlaste se do Fakturoidu.
  2. Klikněte na Nastavení → Webhooky.
  3. Zvolte Přidat webhook.
  4. Do pole URL vložte adresu z pluginu.
  5. Pole Tajný klíč (secret) vyplňte hodnotou z pluginu.
  6. Zaškrtněte události:
    • invoice_paid
    • payment_received
    • případně invoice_created (pokud chcete logovat tvorbu faktur)
  7. Uložte změny.

Screenshot: Zachyťte formulář ve Fakturoidu s vyplněnými hodnotami. Před sdílením nezapomeňte zamaskovat secret.

Testování

  1. Vytvořte objednávku a vystavte fakturu (podle předchozích sekcí).
  2. Ve Fakturoidu otevřete fakturu a klikněte na Zaplaceno (nebo přidejte platbu).
  3. Počítejte s prodlevou několik sekund.
  4. V WooCommerce objednávka přejde do stavu, který jste nastavili v tabulce.
  5. Zkontrolujte poznámku „Webhook: invoice_paid“ v detailu objednávky.

Pokud se stav nezmění:

  • Ověřte log v sekci Diagnostika (je-li zapnuté API logování).
  • Zkontrolujte, zda secret ve Fakturoidu odpovídá současnému secretu v pluginu.
  • Prověřte, zda hosting neblokuje příchozí požadavky (např. firewall).

Typické chyby a řešení

PotížPravděpodobná příčinaŘešení
Invalid signature v debug loguSecret ve Fakturoidu neodpovídáZnovu zkopírujte secret a uložte webhook podruhé.
WooCommerce nereagujeWebhook URL špatně zkopírovaná, chybí https://Vložte URL znovu a uložte.
Webhook se neuloží ve FakturoiduNení vyplněný secretFakturoid vyžaduje secret, jinak uloží jen část nastavení.
Stav se změní dvakrátDuplicitní weby nebo staging posílá stejné požadavkyUjistěte se, že staging používá jiný secret nebo webhook deaktivujte.

Doporučení pro screenshoty

  • V pluginu vyfoťte sekci s URL a secretem – údaje před zveřejněním zamaskujte.
  • V tabulce „Změna stavu po zaplacení“ zvýrazněte řádek s konkrétní dopravou.
  • Ve Fakturoidu udělejte screenshot nastavení webhooku s viditelnými zaškrtnutými událostmi.

Související dokumenty

Po úspěšném nastavení webhooků pokračujte na konfiguraci e-mailů, aby zákazníci dostávali správné doklady včetně zabezpečených odkazů.