Pular para o conteúdo
UCP
Menu

Guia Técnico · Implementação

Implementando UCP: guia completo para comerciantes e desenvolvedores

Quer tornar sua loja compatível com o Universal Commerce Protocol para ser acessível a agentes de IA? Este guia técnico aborda pré-requisitos, endpoints a expor, integração de pagamentos AP2, testes de validação e erros comuns a evitar.

Equipe editorial · Atualizado : Abril de 2026 · Consulta principal : implementar UCP

Integrar UCP com base na especificação atual

O esforço depende dos sistemas existentes de catálogo, checkout, identidade, pagamento e pedidos. A especificação UCP não publica um prazo universal nem garante a compatibilidade de um processador específico.

1. Publicar o perfil

Publique o perfil da empresa em /.well-known/ucp por HTTPS e sem redirecionamentos. Declare a versão, as capacidades, os transportes, os esquemas e os endpoints base suportados. Cliente e empresa negociam versão e capacidades em cada interação.

2. Montar as operações REST a partir do perfil

  • POST /catalog/search pesquisa produtos.
  • POST /catalog/lookup resolve IDs de produtos ou variantes.
  • POST /checkout-sessions cria uma sessão de checkout.
  • GET /orders/{id} retorna o estado atual do pedido.

As rotas são relativas ao endpoint base anunciado. Preço e disponibilidade devem ser validados novamente no checkout.

3. Limitar identidade e pagamentos

Identity Linking usa OAuth 2.0 e scopes. AP2 é uma extensão opcional do checkout com Checkout Mandates e Payment Mandates assinados. Confirme a disponibilidade na documentação atual do provedor de pagamento.

4. Testar antes do lançamento

Valide perfil, cabeçalhos de cache, versão, remoção de capacidades, esquemas JSON, autenticação, assinaturas HTTP e respostas de erro. Mantenha testes próprios de contrato e integração; a especificação não define uma suíte central de certificação.

Fontes oficiais