UCP su PrestaShop: a che punto è e come si implementa

PrestaShop ha un modulo ufficiale per UCP?

Non risulta. Sul sito di PrestaShop, a novembre 2026, non c’è nessun riferimento al protocollo UCP. Il blog parla di commercio con gli agenti solo in termini generali. La ricerca nel negozio dei moduli, PrestaShop Addons, non si è potuta consultare in modo automatico: prima di decidere conviene cercare lì a mano «UCP» e «Universal Commerce Protocol».

Il protocollo, intanto, è aperto: tutto ciò che chiede si può costruire in un modulo PrestaShop, come per qualsiasi altra integrazione con un servizio esterno. Che cosa chieda nel suo insieme, e che cosa resti al negozio, è spiegato nella pagina sul protocollo UCP.

Rispetto a Shopify la differenza è netta: lì la piattaforma porta da sé i negozi idonei dentro AI Mode e Gemini, come spiegato in UCP su Shopify; su PrestaShop il lavoro è del negozio o di chi ne cura lo sviluppo.

Che cosa fa il modulo gratuito Fondouk?

Fondouk è un modulo gratuito con licenza MIT, il cui codice è pubblico su GitHub. Funziona con PrestaShop dalla 8.0 alla 9.2 e chiede indirizzi amichevoli e HTTPS attivi.

• Che cosa fa: pubblica il profilo del negozio su /.well-known/ucp ed espone il catalogo, cioè ricerca, consultazione e scheda prodotto, sia come API REST sia per gli agenti che usano MCP. Segue la versione 2026-04-08 del protocollo.
• Che cosa non fa: il suo autore lo descrive come solo in lettura e solo pubblico, senza carrello e senza checkout. Il carrello e il pagamento sono indicati fra i lavori futuri.
• Maturità: a novembre 2026 il progetto ha 14 versioni pubblicate su GitHub, l’ultima la 2.0.0 del 30 ottobre 2026. Il README cita anche una versione a pagamento sugli Addons, che qui non è stata verificata.

È quindi un buon modo per far leggere il catalogo agli agenti, ma non porta al pulsante di acquisto dentro le ricerche di Google, che chiede proprio il checkout e il pagamento.

Quali pezzi mancano per vendere dentro Google?

Le guide di Google per i commercianti chiedono, oltre al profilo, un insieme di pezzi che riguardano tutti soldi e ordini.

Pezzo	Che cosa fa	Con Fondouk
Attributo native_commerce nel feed	Dice a Google quali prodotti si possono comprare	Da fare nel feed
Profilo /.well-known/ucp	Dichiara funzioni, indirizzi, pagamenti e chiavi	Sì, per il catalogo
Sessione di acquisto	Creare, aggiornare, completare, annullare	No
Incasso del token di Google Pay	Il pagamento passa dal fornitore del negozio	No
Avvisi sugli ordini a Google	Creato, spedito, consegnato	No
Prove in Merchant Center	Area di test e convalida in produzione	Dopo lo sviluppo

L’attributo nel feed si aggiunge di solito con un feed supplementare. Attenzione alle combinazioni dei prodotti: l’ID che arriva a Google deve essere quello che il checkout riconosce, e con le combinazioni di PrestaShop non è scontato. Il tema è spiegato nelle varianti su Google Shopping.

Come si costruisce il modulo su PrestaShop?

La strada più ordinata è un modulo di pagamento, perché PrestaShop ha già tutto ciò che serve per far nascere un ordine pagato da un servizio esterno.

• Gli indirizzi delle chiamate si dichiarano con le rotte del modulo, che portano le richieste di /ucp/v1/checkout-sessions ai controller del modulo.
• La sessione di acquisto è un carrello di PrestaShop con indirizzo e vettore: a ogni aggiornamento si ricalcolano spedizione e tasse e si risponde con i totali.
• Il cliente arriva da Google senza account: si crea come ospite, con l’email ricevuta nella sessione.
• L’ordine nasce quando il fornitore di pagamenti ha incassato il token: il modulo, che estende quello di pagamento di PrestaShop, lo convalida come qualsiasi altro metodo di pagamento.
• Gli avvisi a Google partono quando cambia lo stato dell’ordine o arriva il numero di spedizione, e vanno in coda con nuovi tentativi, non dentro il cambio di stato.
• Il profilo si può servire come file statico, con il tipo application/json impostato nel server web.

Lo scheletro del modulo, con le rotte e i punti in cui agganciarsi, è nella guida all’implementazione che si chiede dal modulo nella pagina sul protocollo.

Che cosa controllare prima di iniziare?

1. Il fornitore di pagamenti: deve saper incassare i token di Google Pay chiamato dal server. È la prima domanda da fare, perché decide se il progetto è possibile.
2. Il firewall e la cache: Google non ripete le chiamate di checkout respinte con 403 o 429. Sfide anti-bot e blocchi per paese sulle rotte del protocollo vanno tolti.
3. I tempi di risposta: Google chiede che la creazione di una sessione risponda entro 4 secondi in 95 casi su 100 e il completamento entro 10.
4. Il paese dei clienti: il programma di Google, a novembre 2026, riguarda i prodotti venduti negli Stati Uniti. Chi vende in Italia può preparare tutto, ma non attivarlo, come spiegato in che cosa cambia per un e-commerce italiano.

Infine la misura: gli acquisti fatti dentro Google non passano dalle pagine del negozio, quindi i tag non li vedono. Vanno mandati a GA4 dal server, come spiegato in come misurare le vendite fatte dentro AI Mode e Gemini.

Domande frequenti

Fonti

• GitHub: Fondouk, modulo UCP per PrestaShop
• UCP: guida introduttiva per i commercianti
• UCP: checkout nativo e tempi di risposta
• UCP: rete e firewall
• UCP: impostazioni di Merchant Center e attributi del feed
• GitHub: le versioni di Fondouk
• PrestaShop: Visibility on AI tools, when ecommerce takes a new turn