Krok 6: webhooky

Webhooky pro první PSB integraci: registrujte topicy, vraťte 2xx do 100 s, ověřujte HMAC SHA256 podpisy.

Bez webhooků vidíte jen synchronní API odpovědi. Stav doručení, opakování a příjem běží asynchronně. Hooky patří ke každé vážné integraci.

Minimální nastavení v sandboxu
  1. Zveřejněte HTTPS endpoint, který dokáže přijímat JSON (dočasně: tunel jako ngrok je pro accp v pořádku)
  2. Zaregistrujte hook s topicem InvoiceSent (odesílání) a/nebo InvoiceReceived (příjem)
  3. Odpovězte do 100 sekund HTTP 2xx
  4. Ověřte podpis HMAC SHA256, než payloadu důvěřujete

Přesné registrační API, hlavičky a chování opakování: Nastavení webhooků.

Co chcete vidět v prvním testu
  1. Odešlete fakturu (krok 5)
  2. Přijměte hook pro odesílací událost
  3. Zalogujte topic, document/correlation id a výsledek ověření
  4. Záměrně vynucujte non-2xx, abyste viděli start opakování; potom obnovte 2xx
Bezpečnost
  • Nedávejte hook secret do client-side kódu
  • Používejte oddělené secrety/URL pro accp a produkci
  • Odmítněte požadavky s neplatným podpisem (a zalogujte je)
Hotovo s Getting started?

Pokračujte s: