UCP su Magento e Adobe Commerce: moduli disponibili e lavoro da fare

Magento ha un supporto ufficiale a UCP?

Nelle pagine ufficiali lette a novembre 2026 non c’è una funzione UCP pronta per Magento o Adobe Commerce. Alcuni articoli di terze parti parlano di un impegno di Adobe sul protocollo, ma l’annuncio non è stato trovato sulle pagine di Adobe: prima di aspettare una funzione ufficiale conviene verificarlo direttamente con Adobe o con il proprio partner.

Il protocollo, intanto, è aperto e Magento ha tutti gli strumenti per implementarlo. Il quadro completo, dall’acquisto alle responsabilità del venditore, sta nella pagina sul protocollo UCP.

La differenza con Shopify, che porta da sé i negozi idonei dentro AI Mode e Gemini, è raccontata in UCP su Shopify: su Magento il lavoro resta al negozio o all’agenzia che lo sviluppa.

Che cosa fanno i moduli di terze parti?

Su GitHub ci sono due progetti, entrambi con licenza MIT, con obiettivi diversi.

	angeo/module-ucp	Modulo di Magebit
Che cosa fa	Genera il profilo su /.well-known/ucp, con le chiavi pubbliche e le funzioni accese o spente per vista negozio	Dichiara checkout, ordini e collegamento dell’account
Checkout e ordini	In moduli separati dello stesso autore, non letti qui	Elencati, ma il progetto è in sviluppo
Stato	Carrello e consenso dell’acquirente non ancora disponibili	«Coming Soon»: in sviluppo
Versioni di Magento	Non indicate nel README; il composer.json chiede PHP da 8.1 a 8.5	Non dichiarate

angeo/module-ucp può verificare anche le firme delle richieste in arrivo (funzione spenta di base, da attivare), come chiede il protocollo, e prevede un collegamento opzionale per gli agenti che usano MCP. Il modulo di Magebit ha un indirizzo di prova per le verifiche di conformità che, scrive il suo autore, non va attivato su un negozio in produzione.

Sono buoni punti di partenza da leggere, non prodotti finiti: prima di usarli su un negozio vero serve una revisione del codice e una prova su una copia.

Che cosa chiede Google, oltre al profilo?

Il profilo è il primo pezzo, non l’ultimo. Le guide di Google per i commercianti chiedono anche:

1. L’attributo native_commerce nel feed di Merchant Center, sui prodotti acquistabili, di solito con un feed supplementare.
2. Le chiamate della sessione di acquisto: creare, leggere, aggiornare con l’indirizzo, completare e annullare.
3. L’incasso del token di Google Pay con il fornitore di pagamenti del negozio.
4. Gli avvisi sugli ordini a Google: creato, spedito con il tracciamento, consegnato, firmati e con nuovi tentativi.
5. Le prove nell’area UCP di Merchant Center, la convalida in produzione e l’esame del supporto di Google.

Con i prodotti configurabili di Magento serve un’attenzione in più: l’ID che arriva a Google deve essere quello del prodotto semplice che il checkout riconosce, oppure va indicato con merchant_item_id. Il tema delle varianti su Google Shopping è lo stesso.

Come si costruisce il resto su Magento?

Con un modulo proprio. Ogni pezzo del protocollo ha un posto naturale nell’architettura di Magento.

• Gli indirizzi: un router personalizzato riconosce le richieste di /ucp/v1/checkout-sessions e risponde in JSON. Le API REST standard di Magento hanno indirizzi e formati diversi da quelli del protocollo.
• La sessione di acquisto è un carrello di Magento: si crea, si riempie con prodotti e indirizzi, si ricalcolano spedizioni e tasse a ogni aggiornamento.
• L’ordine nasce dal carrello alla chiamata di completamento, dopo l’incasso, con un metodo di pagamento del modulo che registra la transazione del fornitore.
• Gli avvisi a Google partono da osservatori sul salvataggio dell’ordine e del tracciamento della spedizione, e passano da una coda, così un ritardo di Google non rallenta il pannello.
• La cache: le rotte del protocollo e il profilo vanno esclusi da Varnish e dalla cache di pagina, che non devono servire risposte vecchie.

I nomi esatti delle classi e degli eventi, con lo scheletro dei file di configurazione, sono 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 incassare i token di Google Pay chiamato dal server. Senza, il progetto non parte.
2. I tempi: Google chiede che 95 creazioni di sessione su 100 rispondano entro 4 secondi e 95 completamenti entro 10, misurati su 24 ore.
3. Firewall e CDN: niente sfide anti-bot, CAPTCHA o blocchi per paese sulle rotte del protocollo; Google non ripete le chiamate respinte con 403 o 429.
4. Più viste negozio: valute, lingue e prezzi diversi vanno dichiarati con coerenza nel profilo e nelle risposte.
5. Il paese dei clienti: il programma di Google riguarda per ora i prodotti venduti negli Stati Uniti, come spiegato in che cosa cambia per un e-commerce italiano.

E la misura: gli acquisti chiusi dentro Google non passano dalle pagine del negozio. Come recuperarli dal server è in come misurare le vendite fatte dentro AI Mode e Gemini.

Domande frequenti

Fonti

• GitHub: angeo/module-ucp per Magento 2
• GitHub: modulo UCP di Magebit per Magento 2
• 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: composer.json di angeo/module-ucp