Guida tecnica all'implementazione dell'Universal Commerce Protocol (UCP)

Questa guida fornisce istruzioni dettagliate per gli sviluppatori che eseguono l'integrazione con Universal Commerce Protocol (UCP). Descrive i passaggi necessari per attivare le transazioni direttamente sulle piattaforme AI di Google (Ricerca, Gemini).

Implementazione in sintesi

Segui questi passaggi per pubblicare la tua app sulle piattaforme Google AI. Puoi scegliere di supportare i pagamenti come ospite o esperienze più approfondite collegate all'account.

  1. Prepara il tuo account Merchant Center. Configura spedizione, resi e il feed dei prodotti per consentire agli utenti di scoprire e acquistare i tuoi prodotti sulle piattaforme Google.
    • Quando è tutto pronto, iscriviti alla lista di attesa per contattare Google per l'implementazione di UCP. La tua integrazione deve essere approvata da Google prima di poter essere pubblicata in AI Mode e Gemini.
  2. Pubblica il profilo commerciante. In questo modo, Google potrà negoziare servizi e funzionalità e scoprire i tuoi gestori dei pagamenti e le chiavi pubbliche per la verifica della firma.
  3. Completa l'integrazione del pagamento nativo. Implementa tre endpoint REST principali per la creazione, gli aggiornamenti e il completamento delle sessioni.
  4. Scegli un percorso per l'identificazione dell'utente:
    • Pagamento come ospite (impostazione predefinita): non sono necessari passaggi aggiuntivi.
    • Pagamento collegato all'account: implementa OAuth 2.0 per sincronizzare i profili utente.
  5. Sincronizza lo stato dell'ordine. Chiama i webhook di Google per trasmettere gli aggiornamenti degli ordini.