UCP de abril a agosto de 2026: o que mudou entre versões

Publicado em . Tradução da análise publicada em inglês a . Comparação feita com as duas versões oficiais publicadas no GitHub.

Resposta curta: o UCP passou de uma ampla base comercial em abril para um modelo transacional mais maduro e multissetorial em agosto. A versão de 8 de abril acrescentou carrinho, pesquisa e consulta do catálogo, operações de encomenda, associação de identidade baseada em OAuth, assinatura de pedidos, atribuição e um tratamento de erros completo. A versão de 25 de agosto reorganizou o protocolo para vários setores, acrescentou primitivas de retalho alimentar e de local, introduziu ações 3DS2 e restrições específicas de cada transação, alargou os planos de pagamento e os pagamentos divididos, e reconstruiu partes da identidade e do consentimento. Contém também alterações incompatíveis. É uma migração de esquema, não uma atualização de conteúdo de rotina.

Dois tubos cinzentos separados de diâmetros diferentes junto de um redutor cor de ferrugem.

A base de abril

A versão oficial v2026-04-08 já ia muito além do checkout. Acrescentava as primitivas necessárias para descobrir produtos, compor um carrinho, associar uma identidade, obter uma encomenda e explicar falhas. Introduzia também a assinatura de pedidos e respostas, sinais de abuso e de autorização, declarações de elegibilidade, atribuição de recomendações e um contrato de totais mais rico.

Essa combinação conta. O catálogo e o carrinho davam aos agentes algo com que comprar. A associação de identidade e a assinatura ofereciam uma forma de estabelecer continuidade e integridade. As encomendas e a atribuição ligavam a interação do agente ao fluxo comercial existente do comerciante.

O que tinha mudado a 25 de agosto

ÁreaAbril de 2026Agosto de 2026Efeito operacional
ArquiteturaCapacidades de compra e serviços comuns do protocoloDomínios Common, Shopping e Payment, com construções de pagamento independentes do setorClientes gerados, espaços de nomes e importações podem ter de ser deslocados
SetoresCatálogo, carrinho, checkout e encomenda do retalho geralPesquisa e consulta de locais, horários de funcionamento, contexto de levantamento e quantidades fracionáriasO retalho alimentar e o processamento associado a um local tornam-se representáveis
AutenticaçãoAssinatura de pedidos, base de identidade OAuth e nova autenticaçãoPrimitiva Actions, fluxos 3DS2, interoperabilidade com Web Bot Auth e chaves de perfil canónicasUma autenticação fora de banda pode ser pedida dentro de um fluxo de transação
PagamentosInstrumentos disponíveis e configuração dos gestores de pagamentoInstrumentos divididos, depósitos, prestações, condições diferidas e credenciais PAN e de token de rede separadasA negociação do pagamento pode modelar mais do que uma cobrança imediata num único instrumento
ConsentimentoAssociação de identidade e âmbitos determinados pelas capacidadesFinalidades extensíveis de consentimento do comprador em notação DNS inversa e fornecedores de identidade delegadosO consentimento pode ser expresso por finalidade em vez de indicadores fixos
PolíticasLigações para a política de devoluções e dados da encomendaInstantâneos das políticas de devolução, reembolso e garantia nos objetos comerciaisUm agente pode receber as condições aplicáveis ao estado da transação
VersionamentoOrientações de versionamento dinâmicoVersionamento independente por capacidade e um contrato de versão mais rigorosoOs clientes precisam de negociar por capacidade, sem pressupor uma única versão global

Três alterações que mudam o trabalho de integração

1. O protocolo deixou de se organizar apenas em torno do retalho

A versão de agosto retira os tipos comuns e as extensões de pagamento dos caminhos específicos do retalho. Introduz também uma associação polimórfica de tokens para que uma construção de pagamento funcione em mais de um setor. A versão descreve isto como uma base para a restauração e o alojamento, a par do retalho.

Limite: preparar a arquitetura não é implementar. O sítio oficial do UCP continua a dizer que as especificações detalhadas de restauração e alojamento estão para chegar. Um comerciante não deve anunciar suporte a esses setores só porque os tipos comuns passaram a existir.

2. O pagamento torna-se uma sequência negociada

A nova primitiva Actions permite a um comerciante pedir a uma plataforma que execute um passo fora do pedido imediato, incluindo a recolha de dados do dispositivo 3DS2 ou um desafio. As restrições transportadas na resposta permitem ao comerciante fixar regras específicas da transação para o pedido seguinte. Os planos de pagamento acrescentam depósitos, prestações e condições diferidas, enquanto os pagamentos divididos permitem usar mais de um instrumento.

Estas funções mudam a pergunta de integração de «o agente consegue enviar um token?» para «as duas partes conseguem negociar a próxima ação válida e conservar o estado resultante?».

3. Identidade, consentimento e políticas tornam-se dados da transação

Abril estabeleceu uma base OAuth 2.0. Agosto acrescenta fornecedores de identidade delegados, chaves de assinatura canónicas e valores de consentimento indexados por finalidade. Coloca também instantâneos de políticas nos objetos de carrinho, checkout, catálogo e encomenda. Assim, o consentimento e as condições aplicáveis tornam-se partes inspecionáveis da troca do protocolo.

Limite: um campo do protocolo não demonstra que um fluxo de consentimento é juridicamente suficiente numa determinada jurisdição. Regista dados e relações. O efeito jurídico depende da implementação e das regras aplicáveis.

Perguntas de migração para uma implementação UCP existente

  1. Que espaços de nomes, tipos gerados ou caminhos de esquema de abril importa a integração?
  2. Que alterações de agosto a versão oficial assinala como incompatíveis?
  3. A negociação de capacidades faz-se com a granularidade de versão adequada?
  4. O cliente consegue processar Actions e restrições específicas da transação?
  5. Como são apresentados ao utilizador o 3DS2, a delegação num fornecedor de identidade e o consentimento do comprador?
  6. As políticas de devolução, reembolso e garantia ficam fixadas com a transação?
  7. Os testes cobrem, quando relevante, instrumentos divididos, depósitos, levantamento, quantidades fracionárias e horários com fuso horário?

Comece pelas notas da versão e depois compare os esquemas exatos que a sua integração utiliza. Este artigo agrupa as alterações por preocupação operacional; não substitui os testes de tipos gerados e de conformidade.

O que esta versão não prova

Não fornece um número de comerciantes, de compradores ou de transações, nem dados de implementação geográfica. Não mostra que cada apoiante nomeado do UCP implementa a versão de agosto. Não prova que um checkout de retalho alimentar, restauração ou alojamento esteja disponível numa determinada interface de consumo. Essas afirmações exigem provas próprias sobre produtos ou adoção.

Para o contexto mais amplo, veja a análise do UCP aos seis meses, a comparação ACP contra UCP (em inglês) e o diagnóstico de preparação dos comerciantes.

Perguntas frequentes

O UCP v2026-08-25 é retrocompatível?
Não totalmente. A versão oficial assinala várias alterações como incompatíveis, incluindo a reestruturação do processamento de encomendas, alterações de espaços de nomes e partes do modelo de pagamento e identidade. Uma implementação deve comparar os seus tipos gerados e as suas cargas úteis com a versão publicada, sem confiar apenas no resumo.
A versão de agosto significa que o UCP funciona para retalho alimentar, restauração e alojamento?
Não. A versão afirma preparar a arquitetura para vários setores e acrescenta peças para o retalho alimentar e para locais. O UCP indica ainda que as especificações detalhadas de restauração e alojamento chegarão mais tarde. Nenhuma destas declarações prova que um comprador possa usar hoje esses setores numa determinada interface.
Sobre o que incidia sobretudo a versão de abril?
A versão de abril alargou a base comercial: carrinho, pesquisa e consulta do catálogo, operações de encomenda, associação de identidade, assinatura de pedidos, atribuição, erros e contratos de pagamento e de processamento mais ricos.
Qual é a alteração de agosto mais importante para um comerciante?
Depende da implementação. Os comerciantes do retalho alimentar obtêm primitivas de local, horário de funcionamento e quantidades fracionárias. As equipas de pagamentos obtêm ações 3DS2, restrições de pedido, instrumentos divididos e planos de pagamento. Qualquer integração existente deve avaliar primeiro as alterações de esquema incompatíveis.