Files
iti-technology/prompts/14-api-webhook-medusa.md
Lorenzo SanesiandClaude Opus 5.5 b83ce039fb
Deploy stack su Proxmox / deploy (push) Failing after 3s
Piattaforma ITI TECHNOLOGY: monorepo, Medusa, API, sito, area riservata e deploy
Monorepo npm con apps/public (Angular SSR), apps/private (Angular SPA),
apps/api (Fastify), packages/shared e packages/styles; Medusa 2.21 in medusa/;
infrastruttura Docker (Postgres PostGIS+pgvector, Redis, Caddy, backup) e
workflow Gitea Actions per il deploy via SSH a ogni push su master.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018jQyT6dR9czzGwqb7FkG6u
2026-10-20 09:30:48 +02:00

992 B

14 — API: ricezione webhook Medusa

Leggi CLAUDE.md.

Obiettivo

Endpoint POST /webhooks/medusa sicuro e idempotente.

Cosa fare

  • Verifica firma HMAC (x-signature) sul raw body con confronto a tempo costante; firma non valida → 401.
  • Idempotenza: inserisci l'evento in webhook_events con l'id ricevuto; se esiste già → 200 senza rielaborare.
  • Dispatcher per tipo evento:
    • order.placed → email di conferma ordine al cliente (template), notifica interna all'admin.
    • order.canceled → email di annullamento.
    • order.fulfillment_created → email di spedizione.
  • Errori di elaborazione salvati in webhook_events.error; risposta 500 così Medusa ritenta.
  • Endpoint escluso dal rate limit globale e dal CORS.

Criteri di accettazione

  • Test: firma valida → elaborato; firma errata → 401; stesso evento due volte → elaborato una volta sola.
  • Ordine di test reale da Medusa → email (anche solo loggata) inviata.
  • CLAUDE.md aggiornato.