Verificador UCP

Digite o endereço de uma loja e veja se o arquivo de descoberta UCP realmente existe — e se é realmente válido.

UCP (Universal Commerce Protocol) é o padrão aberto que permite que um assistente de IA compre em nome de uma loja. Uma loja que fala UCP publica um perfil JSON legível por máquina em /.well-known/ucp — sua versão do protocolo, os serviços que oferece, os processadores de pagamento que aceita e as chaves públicas com que assina. Este verificador baixa esse arquivo do nosso servidor, confere-o com as regras de hospedagem e de perfil da especificação oficial e testa os endpoints que ele declara. O verificador de prontidão para agentes procura o arquivo de descoberta como um sinal entre muitos; esta ferramenta é a análise aprofundada do UCP. O artigo o que é UCP e como verificá-lo examina um documento real passo a passo.

Última atualização:

Verificar uma loja

Um domínio (allbirds.com) ou uma URL completa (https://allbirds.com). O verificador solicita https://<domínio>/.well-known/ucp — sempre por HTTPS, sem nunca seguir um redirecionamento.

🔒 O destino é baixado pelo nosso servidor de verificação, nunca pelo seu navegador — sem bloqueio CORS, e a loja vê a requisição do verificador, não a sua. Nada sobre você é enviado à loja.

O que há em /.well-known/ucp

Um perfil UCP é um objeto JSON com um membro ucp obrigatório. Dentro dele, ucp.version, ucp.services e ucp.payment_handlers são obrigatórios — os dois últimos devem estar presentes mesmo quando vazios. ucp.capabilities é opcional, embora um perfil comercial útil normalmente anuncie pelo menos uma. Um array keys[] de nível superior pode publicar as chaves públicas de assinatura da loja como um conjunto JWK segundo a RFC 7517.

As versões são datas, nunca palavras como "draft": a primeira versão foi 2026-01-11 e a versão estável mais recente é 2026-08-25. Um perfil que declara uma versão antiga ainda valida, mas este verificador avisa — e lista abaixo as mudanças incompatíveis — porque as contrapartes podem rejeitar entradas cuja versão não corresponda à do perfil. Uma loja que ainda serve versões antigas lista-as em supported_versions, cada uma apontando para o seu próprio perfil de versão.

Entre as mudanças incompatíveis de 2026-08-25, estas afetam um perfil publicado: o campo antigo signing_keys[] foi removido e substituído pelo array keys[] de nível superior; a configuração de fulfillment foi reestruturada (as opções perderam o prefixo allows_ e multi_destination passou de mapa para array); o consentimento do comprador passou de opções booleanas fixas para um mapa dinâmico com chaves de domínio reverso; e as extensões de pagamento passaram de dev.ucp.shopping.* para dev.ucp.common.payment.*.

As regras de hospedagem são rígidas porque os perfis são material de confiança: um perfil deve ser servido por HTTPS, não deve redirecionar (qualquer 3xx é uma falha) e deve trazer Cache-Control: public com max-age de pelo menos 60 segundos — nunca private, no-store nem no-cache. As lojas Shopify servem um perfil 2026-08-25 em /.well-known/ucp por padrão — experimente o botão de demonstração.

O que este verificador faz — e o que não faz

Ele baixa, valida e testa — a partir do servidor. O verificador solicita https://<domínio>/.well-known/ucp diretamente (uma requisição, sem seguir redirecionamentos), valida o documento com as regras desta página e testa cada endpoint declarado com uma requisição HEAD (GET quando HEAD é recusado). Seu navegador nunca contata o destino, então a verificação não é bloqueada por CORS.

Ele não faz pedidos, não se autentica como comprador e não valida a criptografia dos processadores de pagamento. Um perfil aprovado aqui prova que a loja pode ser descoberta e que seus endpoints são alcançáveis — não que o pagamento vá funcionar, que o preço esteja certo ou que um processador de pagamento seja confiável.

Ele não verifica documentos ACP, AP2 ou x402 — apenas UCP. Um endpoint declarado inalcançável é um aviso, não um erro: o endpoint pode exigir autenticação, e uma resposta 401 ou 404 ainda conta como alcançável, porque o servidor respondeu. Só uma conexão que falha completamente conta como inalcançável.

Seja honesto consigo mesmo antes de confiar em um perfil

Um perfil válido não é um pagamento que funciona. A descoberta é o primeiro passo: o perfil diz o que a loja oferece e onde estão seus endpoints. Se esses endpoints aceitam requisições reais, devolvem preços reais e concluem um pedido real é outra questão, e este verificador não a responde.

Uma versão antiga é um aviso, não uma falha, por um motivo. Uma loja em 2026-04-08 ainda pode operar com uma plataforma que fale 2026-04-08 — mas uma plataforma que só fale 2026-08-25 deve rejeitar as entradas cuja versão não corresponda, então um perfil antigo reduz quem pode comprar ali.

Um 404 geralmente significa "aqui não há UCP", não "loja quebrada". A maioria dos sites da internet não publica nenhum perfil UCP — a demonstração negativa mostra exatamente isso. Trate um perfil ausente como um fato sobre a prontidão da loja para agentes, não como um erro da loja em si.

Fatos principais

Universal Commerce ProtocolO padrão aberto que permite que um assistente de IA descubra o catálogo, o checkout e o pós-venda de uma loja, e compre em nome de um comprador.
Arquivo de descobertaO perfil JSON publicado em /.well-known/ucp no próprio domínio da loja.
Versão mais recente2026-08-25. As versões são datas; a primeira versão foi 2026-01-11.
Campos obrigatóriosucp.version, ucp.services, ucp.payment_handlers — os dois últimos devem estar presentes mesmo quando vazios. ucp.capabilities é opcional.
Regra de cacheCache-Control: public com max-age de pelo menos 60 segundos; nunca private, no-store nem no-cache.
Regra de redirecionamentoOs perfis devem ser servidos por HTTPS sem redirecionamentos — qualquer resposta 3xx é uma falha.
Especificação oficialUniversal Commerce Protocol (UCP) Official Specification

Perguntas frequentes

Por que a verificação roda em um servidor e não no meu navegador?

Porque os navegadores bloqueiam leituras entre origens. Uma página em sysosx.com não pode baixar o /.well-known/ucp de outra loja diretamente — o servidor da loja teria de permitir com cabeçalhos CORS, e a maioria não permite. O verificador baixa o arquivo do seu próprio servidor, onde essa restrição não se aplica, e devolve o resultado ao seu navegador.

Minha loja está na Shopify — preciso publicar alguma coisa?

Não. A Shopify serve um perfil 2026-08-25 em /.well-known/ucp em todas as lojas por padrão — experimente o botão de demonstração, que verifica allbirds.com. Se a sua loja está na Shopify e a verificação falha, o problema está em outro lugar (um redirecionamento na frente da loja, ou um domínio personalizado que não serve a loja).

O documento existe, mas o veredito é "parcial" — o que corrijo primeiro?

Corrija primeiro os achados marcados como Falha: um campo obrigatório ausente (versão, serviços ou processadores de pagamento), um documento que não é JSON válido ou um redirecionamento. Os avisos — um cabeçalho de cache abaixo de 60 segundos, uma versão antiga, um endpoint inalcançável — são apenas orientações e por si sós não impedem um veredito de pronto para UCP.