UCP: o perfil em /.well-known/ucp que publica o checkout
O Universal Commerce Protocol (UCP): capacidades de checkout, identidade e pedido, o perfil publicado em /.well-known/ucp e o que a Wortic declara hoje.

O Universal Commerce Protocol, ou UCP, é um padrão aberto para que plataformas, como agentes de IA e aplicativos, conversem com negócios de forma padronizada. Segundo o README do projeto, ele reúne as capacidades que um negócio declara, como checkout e pedido, e permite que a plataforma descubra essas capacidades sozinha. Na prática, o negócio publica um perfil, e o agente lê esse perfil antes de pedir qualquer coisa.
O UCP é licenciado sob Apache 2.0, e os autores aparecem como UCP Authors no próprio arquivo de licença. A documentação e a especificação ficam no domínio ucp.dev. A especificação publicada ali tem a versão 2026-08-25, a mesma que o perfil da Wortic declara.
O README resume a proposta em alguns objetivos. O UCP quer padronizar a interação entre plataformas e negócios, sem depender do sistema de cada um por trás. Quer modularizar o comércio em capacidades, como checkout e pedido, e em extensões, como descontos e entrega. Quer habilitar o comércio agêntico, em que agentes de IA agem em nome do usuário para descobrir produtos, montar carrinhos e concluir compras com segurança. E quer reforçar a segurança com padrões como os mandatos do AP2 e as credenciais verificáveis. O projeto também diz que se apoia em padrões abertos já existentes para pagamento, identidade e segurança, em vez de criar tudo do zero.
O que o UCP chama de capacidade?
O README lista quatro capacidades iniciais. A primeira é o checkout, com gestão de carrinho e cálculo de impostos, em fluxos com ou sem intervenção humana. A segunda é a ligação de identidade, em que a plataforma recebe autorização para agir em nome do usuário por OAuth 2.0. A terceira é o pedido, com atualizações por webhook sobre envio, entrega e devolução. A quarta é a troca de tokens de pagamento entre processadores e provedores de credenciais, feita de forma segura.
Esse conjunto é o que um agente precisa para sair da busca e chegar ao pagamento. O checkout cuida do carrinho, a ligação de identidade cuida da autorização, o pedido acompanha a entrega, e a troca de tokens cuida dos meios de pagamento. O README trata cada capacidade como um bloco separado, o que permite implementar uma parte sem as outras.
O UCP também não amarra o negócio a um único transporte. O README diz que as capacidades podem ser oferecidas por REST, por MCP ou por A2A, conforme a infraestrutura de cada um. O perfil da Wortic, pelo que aparece no arquivo, usa REST no endereço do serviço de compras, o que mostra uma escolha de transporte, e não uma exigência do protocolo.
Na parte de segurança, o README cita o uso de padrões de mandato, como o AP2, e de credenciais verificáveis. Isso liga o UCP ao tema da prova de autorização, que é o centro do AP2, e explica por que os dois aparecem juntos na documentação.
Como o perfil em /.well-known/ucp funciona?
O negócio publica o seu perfil no caminho /.well-known/ucp. Esse arquivo diz quais serviços, versões, capacidades e manipuladores de pagamento o negócio suporta. O README chama isso de declarar capacidades para permitir a descoberta autônoma pela plataforma.
O perfil da Wortic, em app.wortic.com/.well-known/ucp, mostra essa estrutura. Há um bloco de serviços com dev.ucp.shopping na versão 2026-08-25, apontando para o endereço https://app.wortic.com/ucp/v1, em REST. Há também uma capacidade dev.ucp.shopping.checkout, com a especificação e o esquema JSON da mesma versão. E o campo de manipuladores de pagamento aparece vazio.
Esse último ponto importa. Um manipulador de pagamento vazio não é erro de formato, mas significa que, no perfil publicado hoje, a Wortic não declara um meio de pagamento pelo UCP. O texto não vai além disso e não promete integração de pagamento.
Como o UCP se relaciona com o ACP e com o AP2?
O UCP e o ACP são especificações separadas, com repositórios, governança e versões próprias. O perfil da Wortic publica os dois na mesma base: o bloco de UCP e um bloco de ACP com api_version 2026-04-17. Isso não quer dizer que um substitui o outro. Quer dizer que o negócio pode oferecer mais de um caminho de checkout.
O AP2 entra como mandato. O site do UCP descreve uma AP2 Mandates Extension, e um dos cenários é o do agente autônomo com AP2. Uma leitura útil é esta: o UCP define como o agente chega ao checkout, e o AP2 define a prova de autorização que acompanha a compra.
Do lado da plataforma, a promessa do UCP é a descoberta autônoma. O README diz que, com o perfil publicado, a plataforma pode descobrir as capacidades do negócio e se configurar sozinha. Isso reduz as integrações feitas caso a caso, que é o problema que o projeto diz querer resolver. O roteiro do projeto fica em ucp.dev, na seção de roadmap, e as discussões ficam no GitHub.
Como um negócio começa a publicar o perfil?
Comece pelo que a especificação pede no seu caso. Escolha as capacidades que o negócio vai oferecer, descreva os serviços e os endereços de cada um, e publique o perfil em /.well-known/ucp. Os esquemas do projeto ficam no diretório source do repositório, e a ferramenta ucp-schema valida a sintaxe e as referências entre eles.
Depois, rode os testes de conformidade que o projeto publica em repositório próprio. Eles existem para que plataformas diferentes falem a mesma linguagem, e o README aponta esse repositório na seção de começo, ao lado de um repositório de exemplos e de outro de SDKs. Antes de divulgar o perfil, confira se ele responde com status 200 no endereço público.
Quando as versões não batem, a plataforma precisa saber o que fazer. A forma mais simples de evitar o problema é checar a versão antes de enviar qualquer dado. Por isso, o perfil deve dizer exatamente a versão que o negócio suporta.
Para uma loja que não programa, o começo é outro. A página de conectar IA da Wortic é o ponto de partida para conhecer o que a casa publica, e a página de sistemas lista os ramos atendidos. As notícias ficam na newsroom.
Perguntas frequentes
O UCP substitui o ACP?
Não há essa relação nas fontes. São especificações separadas, com repositórios e versões próprias. O perfil da Wortic publica as duas, o que mostra que um negócio pode oferecer mais de um caminho de checkout.
O que o negócio precisa publicar?
Um perfil em /.well-known/ucp que declare as capacidades, os serviços, a versão e os endereços, conforme o README. O perfil deve responder no endereço público e bater com a versão da especificação.
A Wortic aceita pagamento pelo UCP?
O perfil publicado hoje traz o campo de manipuladores de pagamento vazio. O texto não afirma que há pagamento pelo UCP; afirma apenas o que o perfil declara.
Fontes
Quer isso funcionando na sua empresa?
Um consultor da Wortic olha o seu caso e mostra o caminho, sem compromisso.
Falar com um consultorEquipe editorial
Equipe editorial da Wortic especializada em automacao, IA, ERP, CRM e crescimento operacional.
- Automacao com IA
- Gestao empresarial
- CRM
- ERP
- Marketing digital
