Krok 6: webhookyWebhooky 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
- Zveřejněte HTTPS endpoint, který dokáže přijímat JSON (dočasně: tunel jako ngrok je pro accp v pořádku)
- Zaregistrujte hook s topicem
InvoiceSent (odesílání) a/nebo InvoiceReceived (příjem) - Odpovězte do 100 sekund HTTP 2xx
- 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
- Odešlete fakturu (krok 5)
- Přijměte hook pro odesílací událost
- Zalogujte topic, document/correlation id a výsledek ověření
- 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: