Puoi permettere agli utenti di ChatGPT di comprare dal tuo negozio senza uscire dalla conversazione. È quello che fa Instant Checkout, e gira su una specifica pubblica che puoi implementare già oggi. Questa guida percorre i tre livelli necessari: un feed prodotti strutturato, la Agentic Checkout API e i pagamenti delegati. Preparati a vero lavoro di ingegneria, ma niente di esotico: endpoint REST, webhook e un provider di pagamento che probabilmente usi già.
Instant Checkout è il flusso di acquisto costruito sull'Agentic Commerce Protocol (ACP) di OpenAI che permette a chi compra di completare un ordine dentro ChatGPT, mentre il tuo negozio continua a processare il pagamento e resta titolare dell'ordine. ChatGPT gestisce scoperta e conversazione; i tuoi sistemi gestiscono inventario, checkout ed evasione.
Un avvertimento prima dei passaggi: Instant Checkout al momento è disponibile solo per gli e-commerce con base negli Stati Uniti. Se vendi altrove, considera questo tempo come preparazione, non come tempo perso.
Passo 1: costruisci il feed prodotti
Il feed è il modo in cui ChatGPT impara cosa vendi. Fornisce i dati strutturati che il modello usa per trovare, mostrare e gestire i tuoi prodotti quando un utente chiede qualcosa.
OpenAI pubblica una specifica del feed prodotti dettagliata che supporta TSV, CSV, JSON e XML. Scegli il formato che il tuo stack già produce, poi rispetta lo schema alla lettera.
Il feed copre queste categorie di dati:
- Flag OpenAI: impostazioni di visibilità che decidono se un prodotto è trovabile e se è idoneo al checkout.
- Dati di base del prodotto: titolo, descrizione, URL, ID prodotto del merchant, GTIN e MPN.
- Attributi: brand, categoria, condizione, dimensioni.
- Media: fino a due immagini, un URL video, un URL di modello 3D.
- Prezzo e promozioni: prezzo base, sconti, prezzi promozionali.
- Disponibilità e varianti: stock in tempo reale, opzioni di ritiro, varianti di colore e taglia.
- Spedizione e dati del merchant: opzioni e costi di spedizione per area, ragione sociale, privacy e politica di reso.
- Conformità, recensioni e Q&A: avvertenze legali, requisiti minimi di età, recensioni strutturate opzionali.
La freschezza è un requisito rigido, e 15 minuti è il numero da ricordare. OpenAI si aspetta che il feed si aggiorni almeno con quella frequenza, così prezzo, stock e promozioni restano attuali. Un feed vecchio significa prezzi sbagliati e checkout falliti, esattamente l'esperienza che uccide la fiducia nell'acquisto conversazionale.
Passo 2: implementa la Agentic Checkout API
Quando un prodotto è trovabile, ChatGPT gestisce la transazione attraverso la Agentic Checkout API, definita nell'Agentic Commerce Protocol. La tua parte del contratto sono cinque endpoint REST che coprono il ciclo di vita del checkout:
- POST /checkout_sessions crea una sessione con il carrello iniziale e i dati del cliente.
- POST /checkout_sessions/{checkout_session_id} aggiorna la sessione quando cambiano articoli, quantità o indirizzi.
- GET /checkout_sessions/{checkout_session_id} restituisce lo stato attuale della sessione.
- POST /checkout_sessions/{checkout_session_id}/complete finalizza l'ordine e acquisisce i dati di pagamento.
- POST /checkout_sessions/{checkout_session_id}/cancel annulla la sessione.
Ogni endpoint parla HTTPS e JSON, porta header standardizzati (bearer token, timestamp, request ID) e richiede idempotenza e gestione strutturata degli errori. Cura i percorsi di errore. Un AI agent riprova in modo più meccanico di quanto farebbe mai un umano.
Tieni gli ordini sincronizzati con i webhook
Due eventi webhook tengono allineata la vista di ChatGPT sull'ordine con la tua:
- order_created scatta quando l'ordine viene creato con successo.
- order_updated scatta ai cambi di stato: spedito, evaso, rimborsato.
Firma ogni webhook con lo schema HMAC previsto dalla specifica, così entrambi i sistemi possono verificarne autenticità e integrità.
Passo 3: collega i pagamenti delegati
Il livello dei pagamenti passa da un payment service provider (PSP) secondo la Delegated Payment Specification di ACP. OpenAI e Stripe supportano oggi questo modello con l'implementazione ACP di Stripe.
Il principio è semplice: né ChatGPT né il tuo negozio toccano mai i dati grezzi della carta. Il PSP conserva, tokenizza e autorizza le credenziali, mantenendo il flusso conforme a PCI DSS Level 1. Dove si applica la Strong Customer Authentication è supportata la verifica 3D Secure. Autorizzazioni e regolamenti passano dall'ambiente sandbox o di produzione del PSP, a seconda della fase di deployment.
Per te questo riduce parecchio la superficie di integrazione. La sicurezza dei pagamenti resta a un provider il cui intero business è la sicurezza dei pagamenti.
Passo 4: valida il flusso da capo a fondo
Un rollout tipico segue quest'ordine:
- Mappa il catalogo sullo schema di OpenAI e automatizza il ciclo di aggiornamento.
- Sviluppa i cinque endpoint di checkout e la logica dei webhook.
- Collega il PSP e testa i flussi di token delegati in sandbox.
- Simula transazioni complete: selezione prodotto, checkout, pagamento, conferma e percorsi di annullamento.
Non saltare annullamenti e rimborsi. Chi compra in chat cambia idea a metà conversazione, e l'agente ha bisogno di un modo pulito per chiudere la sessione.
Ti serve davvero un'integrazione custom?
Dipende dalla piattaforma:
- Chi vende su Shopify ed Etsy beneficia già di Instant Checkout senza lavoro di integrazione aggiuntivo.
- Piattaforme custom ed enterprise devono costruire i tre livelli visti sopra: feed, checkout API e pagamenti delegati.
Noi di RankWit costruiamo queste integrazioni, dalla gestione del feed all'orchestrazione dei pagamenti. Ma a ogni merchant diciamo prima la stessa cosa: il checkout è l'ultimo miglio. Rende solo se ChatGPT fa emergere i tuoi prodotti, e questo è un problema di visibilità prima che di ingegneria. La nostra analisi su come ChatGPT sceglie le sue fonti spiega quel livello di selezione, e la guida alla agentic engine optimization (AEO) copre come prepararsi agli AI agent oltre la singola piattaforma.
FAQ
Instant Checkout è disponibile fuori dagli Stati Uniti?
Non ancora. Il programma copre al momento gli e-commerce con base negli USA. OpenAI non ha pubblicato una tempistica di espansione, quindi chi vende altrove dovrebbe usare questo tempo per preparare feed e infrastruttura di checkout, che è comunque la parte lenta del lavoro.
ChatGPT vede i dati delle carte dei miei clienti?
No. Con la Delegated Payment Specification, il PSP conserva e tokenizza le credenziali di pagamento. ChatGPT e il merchant si scambiano token sicuri, mai numeri di carta in chiaro, e il flusso resta conforme a PCI DSS Level 1. Dove la normativa lo richiede è supportato il 3D Secure.
Vendo su Shopify: devo costruire qualcosa?
No. I merchant su Shopify ed Etsy sono coperti senza integrazioni aggiuntive. Il tuo lavoro si sposta a monte: tieni i dati di prodotto puliti e completi, perché la scoperta dentro ChatGPT dipende dalla qualità del catalogo che il modello riceve.
Ogni quanto deve aggiornarsi il feed prodotti?
Almeno ogni 15 minuti, secondo i requisiti di OpenAI per i partner commerce. Quella cadenza tiene accurati prezzi, disponibilità e promozioni nel momento in cui chi compra conferma l'acquisto dentro la conversazione.