Como configurar o Universal Commerce Protocol na sua loja.O Google precisa aprovar a integração antes que um comprador possa comprar de você no AI Mode ou no Gemini.

Um comprador no AI Mode do Google pede um produto, o agente o encontra no seu catálogo e a compra acontece sem que o comprador jamais carregue o seu site. O Universal Commerce Protocol (UCP) permite que o agente faça isso, e ele só funciona quando a sua loja responde corretamente no momento em que o agente pergunta. O que a sua loja precisa publicar? Quais produtos um agente pode comprar? O que o Google verifica antes de deixar você entrar no ar? Nos projetos de UCP que fizemos, a página de produto sempre sabia mais do que o feed, e um endpoint criado só a partir do feed daria aos agentes menos com que trabalhar do que um comprador vê na página.

O UCP é um padrão aberto, e a sua loja publica o que suporta

O UCP foi desenvolvido pelo Google em conjunto com a Shopify, a Etsy, a Wayfair, a Target e o Walmart, e a especificação fica em ucp.dev. A sua loja é o merchant of record: você fica com o cliente, o pedido e a responsabilidade pelo pagamento, e o agente age em nome do comprador.

Tudo começa com um perfil que a sua loja publica em /.well-known/ucp. Ele informa a versão do protocolo, os serviços que você oferece e como acessá-los, os seus handlers de pagamento e as chaves públicas que um agente usa para verificar as suas mensagens assinadas. Um agente o lê antes de fazer qualquer outra coisa.

As versões do UCP são datas. A especificação mais recente em outubro de 2026 é a 2026-08-25, e os guias de implementação do Google usam a 2026-04-08. Uma loja pode oferecer REST, MCP, A2A ou um checkout incorporado, e REST é o principal.

Passo 1: Corrija os dados de produto que estão errados

O Google lê um feed em uma programação fixa, mas um agente chama um endpoint UCP em tempo real, então tudo o que estiver errado nos seus dados chega ao comprador no momento da compra, sem ninguém ali para pegar o erro. Corrigimos os dados errados antes de adicionar qualquer coisa, e essas correções compensam no Merchant Center, quer o UCP chegue a ser lançado ou não.

Mantenha os GTINs como texto de ponta a ponta. Um sistema que os trata como números remove os zeros à esquerda, e o GTIN deixa de corresponder. Confira cada um no registro GS1 do fabricante em vez de completá-lo até que se encaixe.

Passo 2: Adicione os dados de que um agente precisa para concluir uma compra

As páginas de produto costumam ter mais do que o feed: a galeria completa de imagens, a marca, as avaliações, o preço de tabela real e as condições de entrega. Um agente só vê o que você envia.

• Descrições longas. Coloque primeiro o principal diferencial do produto, porque um agente pode citar só o começo. Declare as restrições com clareza, como limites de peso, requisitos de energia e para onde o produto pode ser enviado, e informe as medidas nos dois sistemas de unidades.
• Variantes separadas. Um produto principal com tamanhos ou cores achatados em uma única linha precisa virar uma linha por variante, agrupadas com item_group_id.
• Frete, devoluções e garantia como dados, e não só como parágrafos em uma página de políticas.
• Todas as imagens que a página mostra. Um feed que leva só a primeira deixa o agente com menos do que o comprador vê.
• Níveis de estoque em tempo real em vez de um indicador de em estoque ou fora de estoque. O Google exige uma verificação de estoque em tempo real no checkout, e um erro out_of_stock quando o item se esgota.

O Merchant Center limita uma descrição a 5,000 caracteres e não quer nela detalhes promocionais como preços ou ofertas de frete, enquanto uma descrição UCP pode trazer entrega, garantia e restrições. Escreva a versão completa para o UCP e enxugue-a para o feed.

No UCP, os preços são números inteiros na menor unidade da moeda, então $129.99 é enviado como 12999. Errar a unidade deixa o preço do produto errado por um fator de cem, para mais ou para menos, então verifique isso antes de qualquer coisa entrar no ar.

Passo 3: Decida quais produtos um agente pode comprar

As diretrizes do Merchant Center do Google excluem categorias inteiras do checkout por agentes, entre elas:

• assinaturas e planos de parcelamento ou financiamento;
• produtos personalizados, itens recondicionados, usados e sem direito a devolução, e pré-vendas;
• serviços agregados como instalação ou garantias estendidas, transporte de carga e entrega premium, e ativação na loja;
• produtos com restrição de idade e proibidos, serviços, aluguéis e itens virtuais.

Deixe esses de fora e inclua o restante produto por produto.

Um produto caro que muitos compradores compram com um plano de financiamento pode vender pior por um checkout de carteira digital que não oferece o plano. Meça quantos pedidos desse produto usam financiamento antes de ativar o checkout por agentes para ele. Uma loja também pode publicar o seu catálogo para agentes e manter o checkout no próprio site, o que é uma configuração UCP legítima e muitas vezes a primeira fase certa.

Passo 4: Prepare o Merchant Center

O guia de implementação do Google começa pelo Merchant Center: a conta precisa estar em situação regular, com produtos aprovados para listagens gratuitas.

• Política de devolução. Defina o custo da devolução, o prazo de devolução e um link para a política completa, no nível da conta ou por produto com o atributo returns. O Google a mostra na tela de checkout.
• Atendimento ao cliente. Adicione pelo menos uma forma de contato: uma página de suporte, um endereço de e-mail ou um número de telefone. É ela que alimenta o link “Contact Merchant” na confirmação do pedido.
• Inclua os produtos. Defina native_commerce(checkout_eligibility) como TRUE para cada produto qualificado. O Google recomenda uma fonte de dados suplementar, para que a inclusão não interfira no seu feed principal.
• Avisos regulatórios. Produtos que trazem um aviso legal, um alerta de segurança ou um aviso da Proposition 65 precisam de um consumer_notice, com o tipo e uma mensagem de até 1,000 caracteres.
• IDs correspondentes. O id do feed precisa corresponder ao ID de produto que o seu checkout espera. Quando forem diferentes, envie merchant_item_id.

Passo 5: Entre na lista de espera do Google

O Google diz que uma integração “precisa ser aprovada pelo Google antes que você possa entrar no ar” no AI Mode e no Gemini. O caminho é o formulário de interesse em integração UCP na Central de Ajuda do Merchant Center, que coloca a sua loja na lista de espera. O checkout incorporado, em que o seu próprio checkout roda dentro da interface do Google, é limitado a lojistas aprovados. Envie o formulário enquanto desenvolve, já que a aprovação é a etapa que você não consegue acelerar sozinho.

Passo 6: Crie o perfil e os endpoints

Uma loja usa o suporte a UCP integrado à sua plataforma de ecommerce ou o desenvolve. Quando desenvolvemos, colocamos um serviço enxuto na frente da loja, que fala UCP com os agentes e a própria API da plataforma com a loja, montado sob o domínio da loja para que o perfil e os endpoints compartilhem uma única origem. O UCP é revisado com frequência, e mantê-lo fora da plataforma significa que uma nova versão não depende de um lançamento da plataforma.

• Publique só o que funciona. Um agente que encontra o checkout no seu perfil vai tentar usá-lo. Uma primeira versão pode anunciar só a busca e a consulta no catálogo e adicionar o checkout quando ele estiver pronto.
• Use chaves de assinatura reais. As chaves públicas do perfil verificam as suas atualizações de pedido assinadas, então gere um par de chaves e mantenha a metade privada no servidor.
• Torne as novas tentativas seguras. Aceite uma chave de idempotência nas chamadas de checkout, para que uma requisição repetida não cobre duas vezes.
• Sirva tudo por HTTPS. A especificação REST exige no mínimo TLS 1.3.
• Valide endereços. Retorne um endereço em que não é possível entregar como um erro recuperável, para que o comprador possa corrigi-lo em vez de ficar sem saída.
• Inclua links para as suas políticas. Os seus termos se aplicam a toda compra via UCP, então inclua na resposta do checkout links para as suas políticas de privacidade, termos, reembolso e envio.

Passo 7: Conecte os pagamentos

No caminho de checkout nativo do Google, o seu perfil declara o handler de pagamento do Google Pay. Você não precisa da API do Google Pay no seu próprio site, mas o seu processador de pagamentos precisa aceitar os tokens de pagamento do Google, e a maioria dos grandes processadores aceita. O FAQ do Google observa que as superfícies de IA do Google usam apenas o método de autorização PAN_ONLY e que as configurações do Google Pay no perfil usam nomes em snake_case. Mantenha separadas as credenciais de teste e de produção do processador e nunca as registre em log.

Passo 8: Teste do jeito que o Google vai testar

O Google envia verificações de integridade com o user agent Google-UCP-Prober/1.0 e marca as requisições de agentes com um cabeçalho UCP-Agent e um user agent que começa com Google/UCP. Antes de se inscrever, faça requisições aos seus próprios endpoints como o Google faria.

• O /.well-known/ucp chega à sua loja? Uma regra do servidor web pode responder a esse caminho com o próprio 404 antes mesmo de a requisição chegar à aplicação, mesmo enquanto os seus endpoints UCP funcionam.
• O seu firewall deixa o Google entrar? Uma proteção contra bots que bloqueia tráfego automatizado também vai bloquear o prober, então libere as requisições UCP do Google pelos cabeçalhos, e não pelo endereço.
• Os endpoints protegidos se comportam como deveriam? Os endpoints de checkout, pagamento e pedidos devem recusar requisições sem credenciais e aceitar as do Google.

Passo 9: Planeje-se para a próxima versão do UCP

A especificação 2026-08-25 adiciona políticas padrão de devolução e garantia que a 2026-04-08 não tem, e o Google documenta a 2026-04-08. Até que os guias do Google adotem uma versão mais nova, a sua política de devolução no Merchant Center carrega essa informação. Quando você adotar uma nova versão, o Google recomenda servi-la a partir de um endpoint separado, para poder mandar o tráfego de volta para a antiga se algo der errado.

A WISLR configura o UCP para marcas e para clientes de agências

Cada passo acima faz parte do serviço Agentic Commerce Optimization da WISLR. Auditamos o catálogo com base nos requisitos do Google, corrigimos e completamos os dados de produto, preparamos o Merchant Center e o feed de inclusão, e criamos e testamos o perfil UCP e os endpoints até a integração estar pronta para a aprovação do Google. As marcas nos contratam diretamente, e as agências nos contratam sob o próprio nome para configurá-lo para os seus clientes. Veja como configuramos o UCP e solicite uma avaliação do seu catálogo.