UCP su WooCommerce: plugin, limiti e che cosa serve davvero

WooCommerce supporta UCP?

Non ufficialmente. Sul blog per sviluppatori di WooCommerce e sul sito woocommerce.com, a novembre 2026, non compare nessun annuncio sul protocollo UCP. Il blog racconta invece il lavoro su ACP, il protocollo di Stripe e OpenAI, e scrive che WooCommerce sta provando soluzioni di partner come Google e Stripe.

Questo non vuol dire che un negozio WooCommerce non possa arrivarci: il protocollo è aperto, e tutto ciò che chiede si può costruire con gli strumenti che WordPress e WooCommerce già offrono. Vuol dire che il lavoro non lo fa la piattaforma, come succede invece su Shopify.

Che cosa sia il protocollo e che cosa resti al negozio è spiegato nella pagina sul protocollo UCP. Qui conta capire che cosa esiste già per WooCommerce e che cosa manca.

Che cosa fa il plugin UCP per WooCommerce?

Nella directory di WordPress c’è «Universal Commerce Protocol (UCP) for WooCommerce», di un autore di terze parti. A novembre 2026 è alla versione 1.0.4, con più di 30 installazioni attive e nessuna recensione. Chiede WordPress 5.8, WooCommerce 5.0, PHP 7.4 e i permalink attivi.

• Che cosa dichiara: il profilo su /.well-known/ucp, il catalogo con informazioni per gli agenti, sessioni di checkout con spedizioni e sconti, il collegamento dell’account con OAuth 2.0, i trasporti REST, MCP ed Embedded, la lettura dello stato degli ordini.
• Come si paga: la pagina del plugin scrive che il cliente completa il pagamento nel checkout esistente di WooCommerce.
• Che cosa non dichiara: l’incasso del token di Google Pay, che il checkout dentro Google richiede, e gli avvisi sugli ordini mandati a Google, che sono obbligatori per andare online.

Può quindi servire a far leggere il negozio agli agenti che rimandano al sito, ma da solo non porta al pulsante di acquisto dentro AI Mode e Gemini. Prima di installarlo su un negozio vero conviene leggerne il codice: un plugin con poche installazioni ha alle spalle poche prove.

Che cosa serve per il pulsante di acquisto di Google?

Le guide di Google per i commercianti elencano i pezzi, ed è utile vederli tutti prima di stimare il lavoro.

1. Il feed: l’attributo native_commerce(checkout_eligibility) sui prodotti acquistabili, meglio con un feed supplementare.
2. Il profilo: un file pubblico su /.well-known/ucp che dichiara funzioni, indirizzo delle chiamate, Google Pay e chiavi di firma.
3. Le chiamate del checkout: creare, leggere, aggiornare, completare e annullare una sessione di acquisto.
4. Il pagamento: il token di Google Pay passato al fornitore di pagamenti, che lo incassa.
5. Gli avvisi sugli ordini: creato, spedito e consegnato, mandati a Google e firmati.
6. Le prove: l’area di test in Merchant Center, poi la convalida in produzione e l’esame del supporto di Google.

Il plugin di terze parti copre una parte del secondo e del terzo punto. Gli altri restano da costruire, e sono proprio quelli che toccano soldi e ordini: il pagamento e gli avvisi a Google.

Come si costruisce su WooCommerce?

Con un plugin proprio, separato dal tema, così sopravvive agli aggiornamenti. Ogni pezzo ha già un posto naturale in WordPress.

• Il profilo si serve con una regola di riscrittura di WordPress oppure come file statico nella cartella /.well-known/, con il tipo application/json.
• Le chiamate si registrano come rotte dell’API REST di WordPress, sotto /wp-json/: l’indirizzo va scritto nel profilo senza la barra finale.
• La sessione non è ancora un ordine: si salva a parte, con una scadenza, e diventa un ordine WooCommerce solo quando arriva il completamento e il pagamento è riuscito.
• Il pagamento passa dall’API del fornitore di pagamenti, non dal plugin di pagamento del checkout, che si aspetta un cliente nel browser.
• Gli avvisi partono ai cambi di stato dell’ordine e si mettono in coda con le azioni pianificate di WooCommerce, che riprovano da sole se Google non risponde.

Il codice passo per passo è nella guida all’implementazione, che si chiede dal modulo nella pagina sul protocollo.

Che cosa controllare prima di iniziare?

Alcuni dettagli tipici di WooCommerce fanno perdere tempo se emergono a metà lavoro.

• Gli identificativi delle varianti: l’ID che arriva dal feed deve essere quello che il checkout riconosce. Con i prodotti variabili non è scontato; il tema è spiegato nelle varianti su Google Shopping.
• Firewall e cache dell’hosting: Google non ripete le chiamate di checkout che ricevono 403 o 429. Sfide anti-bot, CAPTCHA e blocchi per paese sulle rotte del protocollo diventano vendite perse.
• I tempi di risposta: Google chiede che 95 creazioni su 100 rispondano entro 4 secondi e 95 completamenti su 100 entro 10. Un negozio con molti plugin lenti va misurato prima.
• Il fornitore di pagamenti: deve saper incassare i token di Google Pay.

E poi la misura: gli acquisti fatti dentro Google non passano dal tracciamento del sito, quello descritto in tracciamento WooCommerce con Google Tag Manager. Vanno mandati dal server, come spiegato in come misurare le vendite fatte dentro AI Mode e Gemini.

Domande frequenti

Fonti

• WordPress.org: Universal Commerce Protocol (UCP) for WooCommerce
• 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
• Google: UCP, attributi in Merchant Center
• The WooCommerce Developer Blog: AI & Agentic Commerce in WooCommerce Roadmap