Senza webhook vedi solo risposte API sincrone. Stato di consegna, retry e ricezione sono asincroni. Gli hook fanno parte di ogni integrazione seria.

1. Pubblica un endpoint HTTPS che possa ricevere JSON (temporaneo: un tunnel come ngrok va bene per accp)
2. Registra un hook con topic InvoiceSent (invio) e/o InvoiceReceived (ricezione)
3. Rispondi entro 100 secondi con HTTP 2xx
4. Verifica la firma HMAC SHA256 prima di fidarti del payload

La firma è nell'header X-EConnect-Signature (sha256= più hex), calcolata con la secureKey dell'URL dell'hook. Se la risposta non è 2xx, la PSB ritenta la consegna fino a 5 giorni.

API di registrazione esatta, header e comportamento di retry: Configurare i webhook.

1. Invia una fattura (passo 5)
2. Ricevi un hook per l'evento di invio
3. Registra topic, id documento/correlazione e risultato della verifica
4. Forza intenzionalmente un non-2xx per vedere i retry; poi ripristina il 2xx

• Non mettere il secret dell'hook nel codice client-side
• Usa secret/URL separati per accp e produzione
• Rifiuta le richieste con firma non valida (e registrale)

Continua con:

• SDK e CLI
• Validate API
• API Reference
• Gestione errori